Für Entwickler
DogWorldBase API v1
JSON über HTTPS. Autorisierung mit dem Header Authorization: Bearer dwb_… (Schlüssel aus dem Partnerbereich). Limit: 120 Anfragen pro Minute. Halterdaten werden nie zurückgegeben.
GET /api/v1/lookup?chip=…
Ob der Mikrochip registriert ist, ob der Hund vermisst wird, Name, Foto und ein Kontaktlink.
curl -H "Authorization: Bearer $KEY" "https://dogworldbase.com/api/v1/lookup?chip=616093900123456"
{"registered": true, "implanted_by": "VetCare Poznań",
"dog": {"name": "Bruno", "species": "dog", "breed": "Labrador Retriever", "colour": "yellow",
"photo": "https://dogworldbase.com/media/dwb/dogs/….jpg", "lost": false,
"contact_url": "https://dogworldbase.com/en/d/Ab3xY9k2Qp/"}}GET /api/v1/lost?city=…
Aktive Vermisstmeldungen in Ihrem Land (optional in einer Stadt).
POST /api/v1/registrations
Für Register, Mikrochip-Händler und Zuchtsoftware (Berechtigung wird von uns vergeben). Registriert einen Mikrochip; mit owner_email erhält der Halter eine Einladung zur Übernahme des Eintrags.
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"chip": "616093900123456", "name": "Bruno", "species": "dog", "breed": "Labrador Retriever",
"sex": "M", "birth_date": "2026-05-01", "colour": "yellow", "country": "PL", "city": "Poznań",
"owner_email": "owner@example.com", "language": "pl"}' \
https://dogworldbase.com/api/v1/registrations
201 {"id": 123, "status": "active", "created": true, "owner_invited": true, "contact_url": "…"}
status "disputed" = die Nummer ist bereits von jemand anderem registriert; unser Team prüft das
GET /api/v1/registrations/<chip> — Status Ihrer Registrierung (has_owner, transfer_pending).
/api/v1/registrations/<chip>/…
GET /api/v1/registrations?kennel_ref=… · DELETE /api/v1/registrations/<chip> · POST|DELETE …/<chip>/transfer · POST …/<chip>/photo — Liste, Zurückziehen, Übergabe an einen Käufer und Foto — die vollständige Beschreibung steht in der Integrationsanleitung, die wir mit dem Schlüssel senden.
Webhook
Vermisstmeldungen für Ihre Region: POST mit JSON an Ihre HTTPS-Adresse mit dem Header X-DWB-Signature: sha256=HMAC-SHA256(Secret, Body).
{"event": "dog.lost", "report_id": 42,
"dog": {"name": "Bruno", "species": "dog", "breed": "…", "colour": "…", "sex": "M", "photo": "…"},
"last_seen": {"place": "Poznań, Jeżyce", "at": "2026-09-24T18:40:00+02:00", "radius_km": 30},
"note": "…", "contact_url": "…"}