Dokumentashon di API

Tur loke bo tin mester pa konektá. Spec leibel pa mashin: OpenAPI 3.0 (JSON)

Outentikashon

Kada request ta manda bo API-key komo Bearer-token. Key ta wòrdu emití pa organisashon i por wòrdu revoká mesora. Base-URL: https://registrobonaire.com

Authorization: Bearer rb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1. Pidi status di vehíkulo

GET /api/partner/v1/vehicle?q=… · scope vehicle.read — buska riba plachi (formato BES) òf VIN. Ningun dato personal den e kontesta.

curl -H "Authorization: Bearer rb_live_…" \
  "https://registrobonaire.com/api/partner/v1/vehicle?q=B-1234"

{
  "found": true,
  "vehicle": {
    "vin": "JTDBT923771012345",
    "plate": "B-1234",
    "vehicle_type": "auto",
    "brand": "Toyota",
    "model": "Corolla",
    "color": "wit",
    "year": 2019,
    "status": "active",
    "registration_verified": true,
    "registered_since": "2026-05-14T12:00:00Z"
  },
  "theft": { "active": false },
  "open_transfer": false,
  "transfers_completed": 1
}

2. Verifiká propiedat

POST /api/partner/v1/verify-ownership · scope ownership.verify — entregá un nòmber i/òf number CRIB; e kontesta ta solamente match/no_match pa kada veld. E datonan registrá mes nunka ta wòrdu debolbé.

curl -X POST -H "Authorization: Bearer rb_live_…" \
  -H "Content-Type: application/json" \
  -d '{"plate": "B-1234", "owner_name": "R. Martis"}' \
  https://registrobonaire.com/api/partner/v1/verify-ownership

{
  "vehicle_found": true,
  "registration_verified": true,
  "vehicle_status": "active",
  "match": true,
  "fields": { "owner_name": "match", "crib_number": "not_provided" }
}

3. Lista aktual di hòrtamentu

GET /api/partner/v1/theft/active · scope theft.read — tur vehíkulo ku ta pará komo hòrtá awor (max 500, esun mas nobo promé). Number di deklarashon KPCN solamente pa servisio di investigashon i gobièrnu.

curl -H "Authorization: Bearer rb_live_…" \
  https://registrobonaire.com/api/partner/v1/theft/active

{
  "count": 1,
  "results": [
    {
      "report_id": "9c1f…",
      "theft_datetime": "2026-07-01T22:15:00Z",
      "reported_at": "2026-07-02T08:03:00Z",
      "vehicle": {
        "vin": "JTDBT923771012345",
        "plate": "B-1234",
        "vehicle_type": "auto",
        "brand": "Toyota",
        "model": "Corolla",
        "color": "wit",
        "year": 2019
      }
    }
  ]
}

4. Bo mes uso

GET /api/partner/v1/usage — kantidat di request di e luna kalendario aktual pa endpoint, plus e rate-limit i scopes di bo key. Ningun scope èkstra nesesario.

Kódigonan di eror

HTTP	Code	Nifikashon
401	`MISSING_KEY / INVALID_KEY`	Key ta falta òf deskonosé
403	`KEY_REVOKED / KEY_EXPIRED`	Key ta revoká òf vensé
403	`PARTNER_SUSPENDED`	Akseso di partner ta suspendé
403	`SCOPE_MISSING`	Key ta falta e scope nesesario
400	`EMPTY_QUERY / INVALID_VIN / INVALID_PLATE`	Entrada ta falta òf tin formato inválido
429	`RATE_LIMITED`	Rate-limit alkansá — mira Retry-After header
500	`LOOKUP_FAILED / AUTH_UNAVAILABLE`	Interupshon temporal na nos banda

Rate-limit ta konta pa key pa minüt (60 standard; otro akuerdo ta posibel). Serka 429 e Retry-After header ta bisa ki ora bo por atrobe.

Mester di akseso òf pregunta?

Manda un e-mail na info@registrobonaire.com — konta ken bo ta i pa kiko bo ke konektá, i nos ta tuma kontakto denter di dos dia laboral.