Dokumentacija

Adios API daje hrvatske vijesti svih velikih portala kao podatke: najnovije i najveće priče, pretragu po smislu, sve povezano s pitanjem, vijesti oko bilo kojeg mjesta, kartu, kronologije, preglede dana, teme u trendu i opozive proizvoda.

Brzi početak

1. Napravite ključ
   Prijavite se na Adios i otvorite konzolu. Prvi ključ dobivate odmah; prikazuje se samo jednom.
2. Pozovite API
   Kopiraj

   export ADIOS_KEY="adios_…"
   curl "https://adios.hr/api/v1/articles?sort=most_covered&limit=5" -H "Authorization: Bearer $ADIOS_KEY"

3. Čitajte data
   Svaki odgovor je {"data": …, "meta": …}; data je objekt ili popis, meta kaže koliko je stavki i što je paket ograničio.

Ključevi

Ključ šaljite u zaglavlju, na jedan od dva načina:

Authorization: Bearer adios_AbC123…
X-Api-Key: adios_AbC123…

• Ključ je „adios_” i 40 slova i znamenki. Čuvamo samo njegov otisak (SHA-256), pa ga ne možemo ponovno prikazati: izgubljeni ključ opozovite i napravite novi.
• Do 10 aktivnih ključeva po računu (npr. jedan za produkciju, jedan za testiranje). Opozvani ključ prestaje raditi odmah.
• Ključ ne stavljajte u javni kod stranice ili aplikacije: zovite API sa svog servera.
• Samo MCP prima ključ i u adresi (/api/mcp?key=adios_…), jer ChatGPT i Claude ne mogu postaviti zaglavlje.

Ograničenja

Svaki paket ima ograničenje u minuti i u danu, a skuplji pozivi (pretraga, sve povezano, mjesta) imaju i svoje dnevno ograničenje. Dan počinje u 00:00 UTC.

Svaki odgovor nosi stanje u zaglavljima:

X-RateLimit-Limit: 5000          # dnevno ograničenje
X-RateLimit-Remaining: 4987      # preostalo danas
X-RateLimit-Reset: 1760227200    # kad se broj vraća na nulu (Unix)
X-RateLimit-Minute: 60
X-RateLimit-Group: geo           # za skuplje pozive
X-RateLimit-Group-Limit: 1000
X-RateLimit-Group-Remaining: 992

Kad je ograničenje dosegnuto, odgovor je 429 sa zaglavljem Retry-After (sekunde). Ako tražite više od paketa (veći polumjer, više stavki, dalje u prošlost), dobit ćete koliko paket dopušta, a meta to kaže (npr. radius_limited_to).

Odgovori

{
  "data": [ … ],
  "meta": {
    "count": 20,
    "limit": 20,
    "plan": "free",
    "took_ms": 41
  }
}

• Popisi imaju limit i offset (priče: page). Prazna polja se ne šalju.
• url je stranica na Adiosu (sažetak, svi portali, karta); source.url je članak na portalu.
• Svi popisi (i pretraga, sve povezano, vijesti u blizini, grad, karta, priče) izostavljaju nebitne vijesti: horoskope, kvizove, reality, trač i promo. include_filler=true ih vraća u bilo kojem pozivu.

Greške

{ "error": { "code": "invalid_parameter", "message": "'lat' must be a number between -90 and 90.", "docs": "https://adios.hr/developers/docs#errors" } }

Vijesti

curl "https://adios.hr/api/v1/articles?category=crime&limit=5" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/articles/{id}" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/search?q=po%C5%BEar%20Split&limit=5" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/connected?q=cijene%20goriva" \
  -H "Authorization: Bearer $ADIOS_KEY"

Mjesta i karta

curl "https://adios.hr/api/v1/nearby?place=Zadar&radius_km=50&hours=48" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/places/resolve?name=Dugom%20Selu" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/cities" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/cities/zadar" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/map?hours=6&urgent_only=true" \
  -H "Authorization: Bearer $ADIOS_KEY"

Pregledi

curl "https://adios.hr/api/v1/digests/daily?date=yesterday" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/digests/weekly" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/digests/monthly" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/digests?kind=weekly&limit=4" \
  -H "Authorization: Bearer $ADIOS_KEY"

Priče (kronologije)

curl "https://adios.hr/api/v1/stories?period=week" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/stories/{slug}" \
  -H "Authorization: Bearer $ADIOS_KEY"

Još

curl "https://adios.hr/api/v1/trending" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/recalls?lang=en&limit=5" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/providers" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl "https://adios.hr/api/v1/categories" \
  -H "Authorization: Bearer $ADIOS_KEY"

Račun

curl "https://adios.hr/api/v1/me" \
  -H "Authorization: Bearer $ADIOS_KEY"

Webhookovi

curl "https://adios.hr/api/v1/webhooks" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl -X POST "https://adios.hr/api/v1/webhooks" \
  -H "Authorization: Bearer $ADIOS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Hotel Zadar","url":"https://example.com/adios","event":"nearby.story","place":"Zadar","radius_km":20,"urgent_only":true}'

curl -X DELETE "https://adios.hr/api/v1/webhooks/{id}" \
  -H "Authorization: Bearer $ADIOS_KEY"

curl -X POST "https://adios.hr/api/v1/webhooks/{id}/test" \
  -H "Authorization: Bearer $ADIOS_KEY"

Webhookovi: događaji

Webhook je vaša HTTPS adresa na koju Adios šalje POST kad se nešto dogodi, bez da vi pitate. Napravite ga u konzoli ili preko API-ja (POST /v1/webhooks).

Tijelo isporuke:

POST https://example.com/adios
Content-Type: application/json
Adios-Event: nearby.story
Adios-Delivery: nearby_3f2c…
Adios-Signature: t=1760180000,v1=5b2e…

{
  "id": "nearby_3f2c…",
  "type": "nearby.story",
  "created_at": "2026-10-11T18:04:00Z",
  "webhook_id": "9a1d…",
  "test": false,
  "data": {
    "place": "Zadar",
    "story": { "title": "…", "kind": "fire", "place": "Bibinje", "distance_km": 6.2, "url": "https://adios.hr/…", … }
  }
}

Provjera potpisa

Svaka isporuka je potpisana tajnom vašeg webhooka (vidi konzolu): v1 je HMAC-SHA256 od "{t}.{tijelo}". Provjerite potpis i da t nije stariji od 5 minuta.

import crypto from "node:crypto";

function verify(secret, header, rawBody) {
  const parts = Object.fromEntries(header.split(",").map(p => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
  const expected = crypto.createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 ?? ""));
}

import hmac, hashlib, time

def verify(secret: str, header: str, raw_body: bytes) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    if abs(time.time() - int(parts["t"])) > 300:
        return False
    signed = parts["t"].encode() + b"." + raw_body
    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts.get("v1", ""))

static bool Verify(string secret, string header, string rawBody)
{
    var parts = header.Split(',').Select(p => p.Split('=', 2)).ToDictionary(p => p[0], p => p[1]);
    long t = long.Parse(parts["t"]);
    if (Math.Abs(DateTimeOffset.UtcNow.ToUnixTimeSeconds() - t) > 300) return false;
    byte[] hash = HMACSHA256.HashData(Encoding.UTF8.GetBytes(secret), Encoding.UTF8.GetBytes($"{t}.{rawBody}"));
    return CryptographicOperations.FixedTimeEquals(
        Encoding.ASCII.GetBytes(Convert.ToHexStringLower(hash)), Encoding.ASCII.GetBytes(parts["v1"]));
}

function verify(string $secret, string $header, string $rawBody): bool {
    parse_str(str_replace(',', '&', $header), $parts);
    if (abs(time() - (int)$parts['t']) > 300) return false;
    $expected = hash_hmac('sha256', $parts['t'] . '.' . $rawBody, $secret);
    return hash_equals($expected, $parts['v1'] ?? '');
}

Isporuka i ponavljanje

• Odgovorite s 2xx u 10 sekundi. Sve ostalo je neuspjeh.
• Neuspjela isporuka se ponavlja sve rjeđe (1, 2, 4… do 60 minuta); nakon 20 neuspjeha zaredom webhook se isključuje, a u konzoli ga uključite ponovno.
• Svaki događaj stiže jednom (id je stalan, pa duplikate lako prepoznate). Novi webhook kreće od trenutka kad je napravljen, bez starih događaja.
• Adios provjerava vijesti svake minute. Gumb „Proba” u konzoli šalje pravi primjer odmah.
• Adrese moraju biti https:// na javnom internetu.

MCP

Adios je i MCP server (Model Context Protocol, Streamable HTTP). Svaki endpoint iznad s oznakom MCP je i alat, a uz njih su i search i fetch (za ChatGPT konektore i deep research) te gotovi upiti (jutarnji pregled, lokalne vijesti, objasni priču, opozivi).

Bez ključa radi za svakoga (ograničenja po sesiji); s ključem (zaglavlje ili ?key=) vrijede ograničenja vašeg paketa i pozivi su u vašem zapisniku.

Promjene

1.0 · 11. listopada 2026. · Prva verzija: vijesti, pretraga, sve povezano, vijesti u blizini, karta, gradovi, pregledi, kronologije, teme u trendu, opozivi, webhookovi i MCP za svakoga.

Promjene koje bi mogle slomiti vaš kod najavljujemo unaprijed; nova polja u odgovorima mogu stići bilo kada.