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
| Geheimnis | Rolle | Hinweise |
|---|---|---|
bc_live_… | bloo.Cards-API-Schlüssel: identifiziert Ihr Unternehmen; Einsicht in Ihre Kontaktdaten ohne Änderung, plus Verwaltung Ihrer Webhook-Abonnements | Im Bereich Entwickler erstellt. Einmal angezeigt, SHA-256-Fingerabdruck gespeichert, widerrufbar. |
whsec_… | Signaturgeheimnis für Webhooks | Um zu prüfen, dass der Webhook wirklich von bloo.Cards stammt (HMAC-SHA256). |
| CRM-Zugangsdaten | Verschlüsselt gespeichert, nie erneut angezeigt | Verschlü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).
| Methode | Rolle |
|---|---|
GET /v1/me | Unternehmen 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/hooks | Liste Ihrer Webhook-Abonnements |
POST /v1/hooks | Ein 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 erstellenWeiterlesen
Kontakt aufnehmen- Automatisierungen und WebhooksSenden Sie jeden neuen Kontakt an n8n, Make, Zapier oder Power Automate.
- Sicherheit und Hosting der DatenHosting in der EU, Verschlüsselung und Schutz Ihrer Daten.
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.