PinsCorner in Ihren Stack einbinden: REST-API, GraphQL und Webhooks

Eine digitale Visitenkarte entfaltet ihr volles Potenzial erst dann, wenn sie mit dem Rest Ihrer Tools kommuniziert. Wenn jemand Ihre Karte scannt und seine Kontaktdaten hinterlässt, sollte dieser Lead sofort in Ihrem CRM landen — nicht erst dann, wenn Sie irgendwann daran denken, eine CSV-Datei zu exportieren. PinsCorner basiert auf Payload CMS, was bedeutet, dass die gesamte Datenschicht über eine native REST- und GraphQL-API zugänglich ist, ergänzt durch ein Webhook-System für die Echtzeit-Ereignisübermittlung.

Ob Sie als Einzelberater arbeiten, ein Vertriebsteam leiten oder Produkte für Kunden entwickeln — die API- und Webhook-Schicht macht PinsCorner zu einem aktiven Bestandteil Ihrer Geschäftsinfrastruktur, nicht nur zu einem Werkzeug zum Teilen von Karten.

REST und GraphQL: zwei Wege, auf Ihre Daten zuzugreifen

PinsCorner bietet sowohl REST- als auch GraphQL-Zugang, authentifiziert über API-Schlüssel, die Sie in Ihren Kontoeinstellungen generieren. REST eignet sich für Skripte, Backend-Integrationen und Dienste, die dem klassischen Request-Response-Muster folgen. GraphQL passt besser zu Frontend-Anwendungen oder Szenarien, in denen Sie genau die Felder abrufen möchten, die Sie benötigen — ohne Datenüberladung oder mehrere Roundtrips.

Über die API können Sie Karten, Kontakte, Leads, Teammitglieder und mehr lesen und schreiben. Das ermöglicht interne Dashboards, die Kartenanalysen neben Ihren anderen Geschäftskennzahlen anzeigen, die Synchronisierung von Kartendaten in ein Data-Warehouse für tiefere Auswertungen oder die programmatische Erstellung von Karten beim Onboarding neuer Teammitglieder im großen Maßstab.

• API-Schlüssel pro Benutzer oder Integration generieren, mit Berechtigungskontrolle
• Beliebige Collections abfragen — Karten, Leads, Kontakte, Teams — über REST oder GraphQL
• In PinsCorner zurückschreiben: Karten und Kontakte aus externen Systemen erstellen oder aktualisieren
• Mit GraphQL nur die benötigten Felder anfordern und die Antwortgröße reduzieren
• Automatisch generierte Schema-Dokumentation direkt im Dashboard aufrufen

Signierte Webhooks: sofort reagieren, wenn etwas passiert

Für Batch-Verarbeitungen reicht das regelmäßige Abfragen einer API aus. Bei zeitkritischen Vorgängen — einem neuen Lead, einer Kartenansicht, einem gespeicherten Kontakt — brauchen Sie Push-Benachrichtigungen. PinsCorner sendet HMAC-signierte Webhooks an den von Ihnen konfigurierten Endpunkt, sodass Ihr Backend im selben Moment benachrichtigt wird, in dem ein Ereignis eintritt.

Die HMAC-Signatur stellt sicher, dass jeder Payload eine Signatur trägt, die aus einem gemeinsamen Geheimnis berechnet wurde. Ihr Server überprüft diese Signatur, bevor er das Ereignis verarbeitet. Das garantiert, dass die Anfrage tatsächlich von PinsCorner stammt und auf dem Weg nicht verändert wurde. Dasselbe Verfahren nutzen Stripe und GitHub — einfach, robust und vertrauenswürdig, ohne Ihren Endpunkt öffentlich zu machen.

• Lead erfasst: ausgelöst, wenn ein Besucher das Lead-Formular auf einer Karte absendet
• Kartenereignisse: Aufrufe, gespeicherte Kontakte und QR-Scans
• Einen oder mehrere Endpunkte pro Ereignistyp konfigurieren
• HMAC-Signatur im Handler prüfen, bevor der Payload verarbeitet wird
• Automatische Wiederholungsversuche bei fehlgeschlagenen Übermittlungen

Wer profitiert am meisten

Die API- und Webhook-Schicht ist für viele verschiedene Teams wirklich nützlich. Vertriebsteams können jeden erfassten Lead direkt in ihr CRM — HubSpot, Salesforce, Pipedrive — weiterleiten, ohne dass ein Mensch eingreifen muss. Marketingteams können automatisierte E-Mail-Sequenzen auslösen, sobald jemand eine Karte speichert. Entwickler, die White-Label-Produkte für Kunden erstellen, können Hunderte von Karten programmatisch verwalten und ihr eigenes Datenhaltungssystem mit PinsCorner synchron halten.

Agenturen und SaaS-Entwickler profitieren besonders vom nativen Payload-Schema: Da PinsCorner auf Payload CMS aufbaut, ist die API keine nachträglich aufgesetzte Schicht. Sie ist dieselbe Schicht, die auch das Admin-Panel nutzt — vollständig, dokumentiert und stabil.

Die besten Integrationen sind die, über die man nicht mehr nachdenken muss: Daten fließen automatisch, Leads kommen dort an, wo sie hingehören, und Ihr Team konzentriert sich auf Gespräche — nicht auf das Kopieren von Kontaktdaten.

So starten Sie

Um ein externes System anzubinden, generieren Sie einen API-Schlüssel in Ihren PinsCorner-Kontoeinstellungen, sehen Sie sich die automatisch generierte REST- oder GraphQL-Schema-Dokumentation an und konfigurieren Sie einen Webhook-Endpunkt für die Ereignisse, die Sie interessieren. Die meisten Integrationen lassen sich in unter einer Stunde einrichten. No-Code-Tools wie Make oder Zapier können die Webhooks ebenfalls verarbeiten — Sie benötigen also keinen Entwickler, um von der Echtzeit-Lead-Weiterleitung zu profitieren.

Wenn Sie bereit sind, PinsCorner in Ihren Stack einzubinden, finden Sie die API-Dokumentation direkt in Ihrem Dashboard. Starten Sie mit einem kostenlosen Konto und wechseln Sie zu einem Pro- oder Team-Plan, wenn Sie höhere API-Ratenlimits und einen vollständigen Webhook-Verlauf benötigen.