Entwickler

bloo.Cards-API und Webhooks für Entwickler

Erhalten Sie jeden neuen bloo.Cards-Eintrag in Ihren Systemen. Die /v1-API erlaubt es, Ihre Kontaktdaten einzusehen, ohne sie zu ändern. Außerdem können Sie Ihre signierten Webhook-Abonnements anlegen, einsehen und löschen, um Kontakte, Scans und Formulare an Ihre Tools anzubinden. Ihr bloo.Cards-Schlüssel identifiziert Ihr Unternehmen. Für Firmenkonten Premium und Corporate. In der EU gehostet.

Nur ausgehend · Premium und Corporate · in der EU gehostet

Drei Geheimnisse, drei Rollen

GeheimnisRolleHinweise
bc_live_…bloo.Cards-API-Schlüssel: identifiziert Ihr Unternehmen; Einsicht in Ihre Kontaktdaten ohne Änderung, plus Verwaltung Ihrer Webhook-AbonnementsIm Bereich Entwickler erstellt. Einmal angezeigt, SHA-256-Fingerabdruck gespeichert, widerrufbar.
whsec_…Signaturgeheimnis für WebhooksUm zu prüfen, dass der Webhook wirklich von bloo.Cards stammt (HMAC-SHA256).
CRM-ZugangsdatenVerschlüsselt gespeichert, nie erneut angezeigtVerschlüsselung je Organisation (BlooCrypto). Nur für den ausgehenden Versand an Ihr CRM verwendet.

Die /v1-API Verfügbar (Premium, Corporate)

Basis: https://bloo.cards/v1 · Authentifizierung: Header Authorization: Bearer bc_live_… (nie in der URL).

MethodeRolle
GET /v1/meUnternehmen und Geltungsbereich des Schlüssels (Verbindungstest)
GET /v1/contacts?since=…Neue Kontakte seit einem Zeitpunkt (ISO 8601), mit dem in blooCRM, dem integrierten Mini-CRM, erfassten Umsatz (deals_total, deals_count, last_deal_at)
GET /v1/hooksListe Ihrer Webhook-Abonnements
POST /v1/hooksEin Abonnement erstellen { url, events[] } (gibt das Geheimnis einmal zurück)
DELETE /v1/hooks/{id}Ein Abonnement deaktivieren

Beispiel: die Verbindung testen

curl -H "Authorization: Bearer bc_live_xxx" \
     https://bloo.cards/v1/me
$ch = curl_init('https://bloo.cards/v1/me');
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER    => ['Authorization: Bearer bc_live_xxx'],
  CURLOPT_RETURNTRANSFER => true,
]);
$me = json_decode(curl_exec($ch), true);
const r = await fetch('https://bloo.cards/v1/me', {
  headers: { Authorization: 'Bearer bc_live_xxx' }
});
const me = await r.json();
import requests
r = requests.get(
    'https://bloo.cards/v1/me',
    headers={'Authorization': 'Bearer bc_live_xxx'})
me = r.json()

Webhooks Verfügbar (Premium, Corporate)

Abonnieren Sie eine URL auf Ereignisse; bloo.Cards sendet dorthin bei jedem Vorkommen ein signiertes POST, mit Wiederholungen bei Fehlern.

Ereignisse

contact.exchanged · lead.ocr_scanned · form.submitted · booking.requested · contact.deleted

Empfangene Hülle

POST https://votre-serveur.example/bloo-webhook
X-Bloo-Signature: t=1790456846,v1=9f2b…c3

{
  "id": "evt_ab12cd34",
  "type": "contact.exchanged",
  "created_at": "2026-09-26T21:00:00Z",
  "data": {
    "contact": {
      "first_name": "Marie", "last_name": "Dupont",
      "email": "marie@exemple.be", "company": "Exemple SA",
      "job_title": "Directrice", "source": "exchange",
      "context": "Salon de Bruxelles"
    }
  }
}

Die Signatur prüfen (PHP)

$body   = file_get_contents('php://input');
$header = $_SERVER['HTTP_X_BLOO_SIGNATURE'] ?? '';   // t=…,v1=…
parse_str(strtr($header, ',', '&'), $p);
$expected = hash_hmac('sha256', $p['t'] . '.' . $body, $whsec);
if (!hash_equals($expected, $p['v1'] ?? '')) {
    http_response_code(401); exit;                    // signature invalide
}
// OK : traitez $body (JSON)

Öffentliche Kartendaten

Öffentliche Karten stellen ihre Daten bereits als JSON-LD und über ?format=json bereit, ohne Authentifizierung. Ideal für Agenten und Indexierung. Über einen MCP-Server (Model Context Protocol) können KI-Assistenten auch die öffentlichen Karten durchsuchen: https://bloo.cards/mcp. Siehe bloo.Cards für KI.

Bereit, bloo.Cards anzubinden?

Mit einem Firmenkonto Premium oder Corporate erstellen Sie Ihren Schlüssel im Bereich Entwickler Ihres Kontos. Ein nativer Konnektor zu Ihrem CRM ist auf Anfrage möglich. Verbindungsassistent Schritt für Schritt · Zu den Automatisierungen.

Meinen API-Schlüssel erstellen

Weiterlesen

Kontakt aufnehmen

Dauerhaft kostenlose Karte, solange das Konto aktiv bleibt: Ein kostenloses Konto, das länger als 12 Monate inaktiv ist, kann nach vorheriger E-Mail-Benachrichtigung mit einer Frist von mindestens 30 Tagen geschlossen werden. Nutzungsbedingungen ansehen.

Sprache