REST API

API dokumentacija

Integriši transliteraciju ćirilice u latinicu u svoju aplikaciju. Podržava srpski, bosanski, crnogorski i makedonski jezik, plain text i HTML, te YU font konverziju.

Autentifikacija

Svi API pozivi zahtijevaju Bearer token u Authorization headeru. Token možete kreirati u tabu "Kreiraj API ključ".

Authorization: Bearer VAŠ_API_KLJUČ

Rate limiting

Svaki token ima limit od 100 zahtjeva po minuti. Status limita se vraća u response headerima:

Header	Opis
`X-RateLimit-Limit`	Ukupan broj dozvoljenih zahtjeva po minuti
`X-RateLimit-Remaining`	Preostali broj zahtjeva u trenutnom prozoru
`X-RateLimit-Reset`	Sekunde do resetovanja limita

Domeni

Svaki token je vezan za listu dozvoljenih domena. API proverava Origin ili Referer header. Koristite *.example.com za wildcard poddomena.

Greške

Sve greške vraćaju JSON objekat sa error poljem:

Status	Opis
400	Nevažeći zahtjev (nedostaje polje, prevelik tekst)
401	Nevažeći ili nedostajući token
403	Domen nije dozvoljen za ovaj token
429	Prekoračen rate limit

Endpointi

POST/api/v1/transliterate

Transliteracija teksta

Konvertuje tekst između ćirilice i latinice. Jezik i smjer se automatski detektuju ako se ne navedu.

Parametri

Parametar	Tip	Obavezan	Opis
`text`	string	da	Tekst za transliteraciju (max 50.000 karaktera)
`language`	string	ne	"sr", "bs", "me" ili "mk" (auto-detect ako se izostavi)
`direction`	string	ne	"cir2lat" ili "lat2cir" (auto-detect ako se izostavi)

curl -X POST https://cirilicaulatinicu.com/api/v1/transliterate \
  -H "Authorization: Bearer VAŠ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Добар дан"}'

Response

{
  "result": "Dobar dan",
  "detected": {
    "script": "cyrillic",
    "language": "sr",
    "direction": "cir2lat"
  }
}

POST/api/v1/transliterate-html

Transliteracija HTML-a

Konvertuje tekst unutar HTML tagova, čuvajući strukturu i atribute. Idealno za CMS sadržaj.

Parametri

Parametar	Tip	Obavezan	Opis
`html`	string	da	HTML string za transliteraciju (max 200.000 karaktera)
`language`	string	ne	"sr", "bs", "me" ili "mk"
`direction`	string	ne	"cir2lat" ili "lat2cir"

curl -X POST https://cirilicaulatinicu.com/api/v1/transliterate-html \
  -H "Authorization: Bearer VAŠ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"html": "<p>Добар <strong>дан</strong></p>"}'

Response

{
  "result": "<p>Dobar <strong>dan</strong></p>",
  "detected": {
    "script": "cyrillic",
    "language": "sr",
    "direction": "cir2lat"
  }
}

POST/api/v1/yufont

YU font konverzija

Konvertuje tekst iz starog jugoslovenskog kompjuterskog enkodinga (YUSCII) u latinicu ili obrnuto. Npr. "Pri~a" → "Priča".

Parametri

Parametar	Tip	Obavezan	Opis
`text`	string	da	Tekst za konverziju (max 50.000 karaktera)
`direction`	string	da	"yu2lat" ili "lat2yu"

curl -X POST https://cirilicaulatinicu.com/api/v1/yufont \
  -H "Authorization: Bearer VAŠ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Pri~a", "direction": "yu2lat"}'

Response

{
  "result": "Priča",
  "detected_yu_font": true
}

POST/api/v1/detect

Detekcija pisma i jezika

Detektuje pismo (ćirilica/latinica), jezik (srpski, bosanski, crnogorski, makedonski) i preporučeni smjer konverzije.

Parametri

Parametar	Tip	Obavezan	Opis
`text`	string	da	Tekst za analizu

curl -X POST https://cirilicaulatinicu.com/api/v1/detect \
  -H "Authorization: Bearer VAŠ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Добар дан"}'

Response

{
  "script": "cyrillic",
  "language": "sr",
  "direction": "cir2lat",
  "yu_font": false
}