API v1.1.0100% Free TierMCP Ready

Developer Portal & Agent Gateway

Pristupite provjerenoj bazi znanja o životu i radu u Njemačkoj kroz mašinski čitljive REST API rute, Model Context Protocol (MCP) server i otvorene AI standarde.

OpenAPI 3.1 SpecMCP Server Manifestllms.txtARD Katalog
⚡

Besplatan i otvoren pristup (Free Tier)

Svi javni GET endpointi su u potpunosti besplatni (0.00 EUR) za korisnike, programere i AI agente. Nije potrebna kreditna kartica niti odobrenje administratora.

🧪

Samoposlužni Sandbox (Self-Serve)

AI agenti i automatizovane skripte mogu odmah testirati API uz sandbox token:Authorization: Bearer sandbox_free_token ili bez zaglavlja autorizacije.

🛡️

Rate Limiti i Idempotencija

Dozvoljeno je 100 zahtjeva/minuti po IP adresi uz standardna zaglavlja X-RateLimit-* i podršku za Idempotency-Key (UUID v4).

Dostupni REST API v1 Endpointi

Svi odgovori vraćaju application/json sa UTF-8 kodiranjem.

GET/api/v1/postsPaginirana lista svih vodiča

Vraća najnovije članke, teme, sažetke i metapodatke.

Query parametri:
  • page (integer, default: 1) — Broj stranice
  • limit (integer, default: 8, max: 50) — Broj stavki
  • category (string, opcionalno) — Slug rubrike
Primjer poziva (cURL):
curl -s https://kakounjemackoj.de/api/v1/posts?page=1&limit=5
GET/api/v1/searchPretraga baze znanja i tema

Omogućava trenutno filtriranje po ključnim riječima, pojmovima i njemačkim terminima.

Query parametri:
  • q (string) — Pojam za pretragu (npr. anmeldung, viza, schufa)
Primjer poziva (cURL):
curl -s "https://kakounjemackoj.de/api/v1/search?q=anmeldung"
GET/api/v1/categoriesPopis svih 26 kategorija i tema

Vraća nazive, slugove i opise svih rubrika (Dolazak, Vize, Stanovanje, Finansije, Zdravstvo...).

curl -s https://kakounjemackoj.de/api/v1/categories
GET/api/v1/pricingCjenovnik i Free Tier specifikacija

Mašinski čitljiv opis cijena (0 EUR za sve javne čitaoce i agente).

curl -s https://kakounjemackoj.de/api/v1/pricing

Model Context Protocol (MCP) za AI Agente

Podržavamo zvanični MCP standard (Anthropic Claude Desktop, Cursor, Ora.ai, Windsurf).

Primjer konfiguracije za Claude Desktop / Cursor:
{
  "mcpServers": {
    "kako-u-njemackoj": {
      "url": "https://kakounjemackoj.de/.well-known/mcp"
    }
  }
}

Mašinski indeksi i protokoli za pretraživače

Protokol / StandardPutanjaOpis
OpenAPI 3.1.0/openapi.jsonKompletna tipizirana REST šema sa odgovorima i greškama.
MCP Manifest/.well-known/mcpAlati, resursi i UI metapodaci za agente.
ARD Katalog/.well-known/ard.jsonAgentic Resource Discovery katalog.
OpenID / OAuth/.well-known/openid-configurationOIDC konfiguracija i rasponi prava (scopes).
LLM Context/llms.txtSažetak za jezičke modele (LLM).
Sitemap/sitemap-index.xmlXML indeks svih članaka i vodiča.