Connectez PinsCorner à vos outils : API REST, GraphQL et webhooks

Une carte de visite numérique n'a de valeur que si elle dialogue avec le reste de vos outils. Quand un prospect scanne votre carte et laisse ses coordonnées, ce contact devrait atterrir dans votre CRM en quelques secondes — pas attendre que vous pensiez à exporter un fichier CSV. PinsCorner est construit sur Payload CMS, ce qui signifie que l'intégralité de la couche de données est exposée via une API REST et GraphQL native, complétée par un système de webhooks pour la livraison d'événements en temps réel.

Que vous soyez consultant indépendant, responsable d'une équipe commerciale ou développeur de produits pour des clients, la couche API et webhooks transforme PinsCorner en un composant actif de votre infrastructure — bien au-delà du simple partage de carte.

REST et GraphQL : deux façons d'accéder à vos données

PinsCorner offre un accès REST et GraphQL, authentifié par des clés d'API générées depuis les paramètres de votre compte. REST convient aux scripts, aux intégrations backend et aux services qui suivent déjà le modèle requête-réponse classique. GraphQL est mieux adapté aux applications front-end ou aux cas où vous souhaitez récupérer exactement les champs dont vous avez besoin, sans surcharge de données ni allers-retours multiples.

Via l'API, vous pouvez lire et écrire des cartes, des contacts, des leads, des membres d'équipe et bien plus encore. Construisez des tableaux de bord internes affichant les analytics de vos cartes aux côtés de vos autres indicateurs, synchronisez les données dans un entrepôt pour des rapports avancés, ou créez des cartes par programme lors de l'intégration massive de nouveaux collaborateurs.

• Générez des clés d'API par utilisateur ou par intégration, avec contrôle des permissions
• Interrogez n'importe quelle collection — cartes, leads, contacts, équipes — via REST ou GraphQL
• Écrivez dans PinsCorner : créez ou mettez à jour des cartes et des contacts depuis des systèmes externes
• Utilisez GraphQL pour ne demander que les champs nécessaires et alléger les réponses
• Accédez à la documentation de schéma générée automatiquement depuis votre tableau de bord

Webhooks signés : réagissez à l'instant où tout se passe

L'interrogation régulière d'une API suffit pour des traitements par lots. Mais pour tout ce qui est sensible au temps — un nouveau lead, une consultation de carte, un contact enregistré — vous avez besoin d'un push. PinsCorner envoie des webhooks signés HMAC vers l'endpoint que vous configurez, de sorte que votre backend soit notifié dès qu'un événement survient, sans attendre.

La signature HMAC garantit que chaque payload embarque une signature calculée à partir d'un secret partagé. Votre serveur vérifie cette signature avant de traiter l'événement, ce qui assure que la requête provient bien de PinsCorner et n'a pas été altérée en transit. C'est le même mécanisme qu'utilisent Stripe ou GitHub : simple, robuste et fiable sans exposer votre endpoint au monde entier.

• Lead capturé : déclenché quand un visiteur soumet le formulaire de collecte sur n'importe quelle carte
• Événements de carte : consultations, contacts enregistrés et scans QR
• Configurez un ou plusieurs endpoints par type d'événement
• Vérifiez la signature HMAC dans votre handler avant de traiter le payload
• Mécanisme de relance automatique en cas d'échec de livraison

Qui en tire le plus grand bénéfice

L'API et les webhooks sont utiles pour une large variété de profils. Les équipes commerciales peuvent router chaque lead capturé directement dans leur CRM — HubSpot, Salesforce, Pipedrive — sans aucune intervention humaine. Les équipes marketing peuvent déclencher des séquences d'email automatisées dès qu'un contact enregistre une carte. Les développeurs qui construisent des produits en marque blanche pour des clients peuvent gérer des centaines de cartes par programme, en maintenant leur propre système de référence synchronisé avec PinsCorner.

Les agences et les éditeurs SaaS bénéficient du schéma natif Payload : parce que PinsCorner est bâti sur Payload CMS, l'API n'est pas une couche ajoutée après coup. C'est la même couche qu'utilise le panneau d'administration — complète, documentée et stable.

Les meilleures intégrations sont celles auxquelles on ne pense plus : les données circulent d'elles-mêmes, les leads arrivent au bon endroit, et votre équipe consacre son temps aux échanges, pas aux copier-coller.

Par où commencer

Pour connecter un système externe, générez une clé d'API depuis les paramètres de votre compte PinsCorner, parcourez la documentation de schéma REST ou GraphQL générée automatiquement, et configurez un endpoint webhook pour les événements qui vous intéressent. La plupart des intégrations se mettent en place en moins d'une heure. Des outils no-code comme Make ou Zapier peuvent aussi consommer les webhooks, ce qui signifie que vous n'avez pas besoin d'un développeur pour bénéficier du routage de leads en temps réel.

Si vous êtes prêt à intégrer PinsCorner à votre stack, la documentation de l'API est disponible directement dans votre tableau de bord. Commencez avec un compte gratuit et passez à un plan Pro ou Team lorsque vous avez besoin de limites de taux plus élevées et d'un historique complet des webhooks.