Dla programistów
DogWorldBase API v1
JSON przez HTTPS. Autoryzacja nagłówkiem Authorization: Bearer dwb_… (klucz z panelu partnera). Limit: 120 zapytań na minutę. Dane właścicieli nigdy nie są zwracane.
GET /api/v1/lookup?chip=…
Czy mikroczip jest zarejestrowany, czy pies zaginął, imię, zdjęcie i link do kontaktu.
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=…
Aktywne zgłoszenia zaginięć w Twoim kraju (opcjonalnie w mieście).
POST /api/v1/registrations
Dla rejestrów, dystrybutorów mikroczipów i programów hodowlanych (uprawnienie nadajemy my). Rejestruje mikroczip; z owner_email właściciel dostaje zaproszenie do przejęcia wpisu.
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" = numer jest już zarejestrowany przez kogoś innego; nasz zespół to weryfikuje
GET /api/v1/registrations/<chip> — status Twojej rejestracji (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 — lista, wycofanie, przekazanie nabywcy i zdjęcie — pełny opis w instrukcji integracji, którą wysyłamy razem z kluczem.
Webhook
Alerty o zaginięciach w Twojej okolicy: POST JSON na Twój adres HTTPS z nagłówkiem X-DWB-Signature: sha256=HMAC-SHA256(sekret, treść).
{"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": "…"}