Docs

API referencaWebhookovi

Nova webhook adresa

Adresa na koju Cifra šalje događaje, potpisane vašom tajnom. Tajna se vraća samo u ovom odgovoru. Najviše 5 aktivnih adresa po okruženju.

POSThttps://api.cifra.ba/v1/webhooks
Pristup
watchlist
Obračun
Besplatno
POST/v1/webhooks
curl -X POST "https://api.cifra.ba/v1/webhooks" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.firma.ba/cifra",
    "events": [
      "watchlist.alert",
      "watchlist.report_ready"
    ],
    "description": "Produkcija — kreditni sistem"
  }'
Odgovor
{
  "object": "webhook_endpoint",
  "id": "whe_K7pX2mQ9vN4tR8bL1cZe",
  "url": "https://hooks.firma.ba/cifra",
  "events": [
    "watchlist.alert",
    "watchlist.report_ready"
  ],
  "description": "Produkcija — kreditni sistem",
  "status": "active",
  "secret_hint": "…x9Qa",
  "created_at": "2026-10-18T22:10:03.441Z",
  "disabled_at": null,
  "secret": "whsec_4fJ8kL2mQ9xR7vT1bN6cZ3pW5yH0gD9x9Qa"
}

Tijelo zahtjeva

application/json
  • urlstringobavezno8–2048 znakova

    HTTPS adresa koja prima događaje. Mora biti javno dostupna (ne lokalna ni privatna mreža).

  • eventsenum[]opcionalnodo 9 stavki

    Događaji koje adresa prima. Bez polja ili []: svi.

    watchlist.alertwatchlist.report_readywidget.rating_changedreport.createdcheck.completedcheck.decidedbulk.completedusage.threshold_reachedwebhook.test
  • descriptionstringopcionalnodo 200 znakova

    Vaš opis, npr. Produkcija — core banking.

Odgovor

201
  • objectstringobavezno

    webhook_endpoint.

  • idstringobavezno

    Oznaka (whe_…).

  • urlstringobavezno

    Adresa.

  • eventsstring[]obavezno

    Događaji; ["*"] znači svi.

  • descriptionstringobavezno

    Opis.

  • statusenumobavezno

    disabled: isključena (ručno ili nakon 3 dana neuspješnih isporuka).

    activedisabled
  • secret_hintstringobavezno

    Zadnja 4 znaka tajne, npr. …x9Qa.

  • created_atstringobavezno

    Trenutak u ISO 8601 (UTC).

  • disabled_atstring | nullobavezno

    Trenutak u ISO 8601 (UTC).

  • secretstringobavezno

    Tajna za provjeru potpisa (whsec_…). Prikazuje se samo sada — sačuvajte je.

Greške

Uz ove, svaki poziv s ključem može vratiti opšte greške (ključ, pristup, limiti).