API Promet SadaThe Promet Sada API

Iskreno o pokrivenostiHonest about coverage

Stranica prikazuje HAK, Hrvatske ceste, Jadroliniju, MeteoAlarm i medije. API ne prodaje izvore čiji uvjeti to ne dopuštaju: HAK (nacionalna pristupna točka dopušta samo nekomercijalnu uporabu, a HAK traži pisani pristanak), Jadrolinija i MeteoAlarm (bez objavljenih uvjeta) te mediji. Zato API danas daje uglavnom obavijesti Hrvatskih cesta, pod Otvorenom dozvolom. Odgovor to navodi u meta.withheld, s brojem obavijesti koje ostaju samo na stranici.The site shows HAK, Hrvatske ceste, Jadrolinija, MeteoAlarm and the press. The API does not sell sources whose terms do not allow it: HAK (the national access point allows non-commercial use only, and HAK asks for written consent), Jadrolinija and MeteoAlarm (no published terms) and the press. So today the API carries mainly Hrvatske ceste reports, under the Croatian Open Licence. The answer says so in meta.withheld, with how many reports stay on the site only.

Kako početiGetting started

Zatraži probni ključ ispod. Stiže e-poštom za nekoliko sekundi i vrijedi 5 dana od prvog zahtjeva. Ključ šalješ u zaglavlju Authorization: Bearer … ili kao ?key=….Request a trial key below. It arrives by email within seconds and lasts 5 days from the first request. Send it as Authorization: Bearer … or as ?key=….

PlanoviPlans

Plaćaš pristup usluzi: upite, ograničenja i podršku. Sami podaci pripadaju tijelima koja ih objavljuju i ostaju pod njihovim licencama; njihovo navođenje mora ostati.What you pay for is access to the service: the queries, the limits and the support. The data itself belongs to the authorities that publish it and stays under their licences; their credits must be kept.

Za plan piši na [email protected] s nazivom projekta i načinom korištenja. Odgovaramo s pravim planom i računom, a ključ ostaje isti. Planovi Osobni i Profesionalni naplaćuju se mjesečno.For a plan, write to [email protected] with your project's name and how you will use it. We reply with the right plan and an invoice; your key stays the same. The Personal and Professional plans are billed monthly.

Krajnja točka i parametriEndpoint and parameters

GET https://prometsada.com/api/v1/incidents

PrimjerExample

curl -H "Authorization: Bearer $KEY" "https://prometsada.com/api/v1/incidents?road=D8&limit=1"

{
  "attribution": { "text": "Data: Promet Sada", "url": "https://prometsada.com" },
  "meta": {
    "count": 1,
    "total": 11,
    "generatedAt": "2026-11-13T19:12:04.511Z",
    "withheld": {
      "note": "Ovi izvori prikazuju se na stranici, ali se ne prodaju preko API-ja … / These sources are shown on the site but not sold through the API …",
      "sources": [{ "id": "hak", "name": "HAK", "count": 202 }]
    },
    "sources": [
      {
        "id": "hc",
        "credit": "Hrvatske ceste, putem NPT-a (hrvatska nacionalna pristupna točka), Otvorena dozvola",
        "licence": "Otvorena dozvola Republike Hrvatske",
        "licenceUrl": "https://data.gov.hr/otvorena-dozvola"
      }
    ]
  },
  "incidents": [
    {
      "id": "hc-…",
      "type": "incident",
      "severity": "high",
      "status": "active",
      "lat": 44.71,
      "lon": 14.89,
      "title": "Zatvoreno zbog bure · D8, Senj",
      "titleEn": "Weather · D8 between Karlobag and Sv · closed for all vehicle categories",
      "source": "hc",
      "road": "D8",
      "closure": "full",
      "wind": true,
      "land": "licko-senjska",
      "startedAt": "2026-11-13T15:00:00.000Z",
      "updatedAt": "2026-11-13T19:05:00.000Z"
    }
  ]
}

PogreškeErrors

• 400: neispravan parametar; odgovor kaže koje su vrijednosti dopuštene.400: a bad parameter; the answer lists the allowed values.
• 401: nedostaje ključ. 402: probno razdoblje je završilo.401: no key. 402: the trial has ended.
• 403: ključ je blokiran. 429: previše zahtjeva; pokušaj nakon vremena iz Retry-After.403: the key is blocked. 429: too many requests; retry after Retry-After.

Uvjeti i navođenje izvoraTerms of use and attribution

Izvorni izvori i njihove licence:The original sources and their licences:

• HAK: Hrvatski autoklub (HAK), putem NPT-a, hrvatske nacionalne pristupne točke (NPT (promet-info.hr), nekomercijalna uporaba) · samo na stranici, ne u API-ju · site only, not in the API
• Hrvatske ceste: Hrvatske ceste, putem NPT-a (hrvatska nacionalna pristupna točka), Otvorena dozvola (Otvorena dozvola Republike Hrvatske)
• Jadrolinija: Jadrolinija, Linije u prekidu (Jadrolinija, javne obavijesti) · samo na stranici, ne u API-ju · site only, not in the API
• MeteoAlarm: MeteoAlarm, upozorenja DHMZ-a (MeteoAlarm / DHMZ) · samo na stranici, ne u API-ju · site only, not in the API
• Hrvatski mediji: Hrvatski mediji (činjenice iz članaka, s poveznicom na izvor) (Činjenice iz članka, s poveznicom) · samo na stranici, ne u API-ju · site only, not in the API

KontaktContact

Pitanja, planovi i više zemalja preko Roadscorea: [email protected].Questions, plans and more countries through Roadscore: [email protected].