oneapi
Autentificare
Utile v1 / Coduri

Detaliu țară

O ţară întreagă: codurile ISO, denumirile, valuta oficială cu detaliile ei şi subdiviziunile, dacă le acoperim.

GET
https://oneapi.ro/api/utile/v1/coduri/tari/{cod}

Parametri de cale

NumeTipDescriereExemplu
codobligatoriu string Codul ţării — ISO 3166-1 alpha-2 sau alpha-3 (ex. RO, ROU).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Ruta acceptă toate cele trei forme fiindcă apelantul are adesea doar una dintre ele, iar a-l pune să caute singur echivalentul ar fi exact munca pe care ruta o face în locul lui.
  • valuta_detalii include numărul de zecimale al monedei — care NU e mereu 2. Yenul japonez are 0, dinarul tunisian are 3. Cine rotunjește la două peste tot scoate facturi greșite.

La ce folosește

  • Convertești un cod primit de la un partener în forma pe care o folosește sistemul tău.
  • Afli valuta și zecimalele ei, ca să formatezi corect o sumă pentru o țară.
  • Verifici dacă un cod de țară e valid, înainte de a-l stoca.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere
tara.alpha_2 string
tara.alpha_3 string
tara.numeric string
tara.nume string Numele, aşa cum îl publică sursa.
tara.nume_en string
tara.continent string Continentul pe care se află.
tara.valuta string Codul ISO 4217 al valutei.
tara.prima_zi_saptamana integer
tara.weekend array
tara.valuta_detalii object Valuta oficială, cu nume, simbol și zecimale.
tara.valuta_detalii.cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
tara.valuta_detalii.nume string Numele, aşa cum îl publică sursa.
tara.valuta_detalii.nume_en string
tara.valuta_detalii.simbol null Simbolul, unde există unul distinct de cod; altfel null.
tara.valuta_detalii.zecimale integer Câte zecimale are moneda. 0 la yen, 3 la dinarul tunisian.
tara.valuta_detalii.tari array Toate teritoriile care folosesc valuta asta.
sursa.nume string Denumirea sursei oficiale.
sursa.versiune string Versiunea setului de date sau a artefactului din care vin valorile.
sursa.licenta string Licenţa sub care sursa permite reutilizarea.
sursa.observatie string Ce trebuie ştiut despre sursă înainte de a folosi datele.

Exemple de răspuns

GEThttps://oneapi.ro/api/utile/v1/coduri/tari/ROU
{
    "data": {
        "tara": {
            "alpha_2": "RO",
            "alpha_3": "ROU",
            "numeric": "642",
            "nume": "România",
            "nume_en": "Romania",
            "continent": "Europa",
            "valuta": "RON",
            "prima_zi_saptamana": 1,
            "weekend": [
                6,
                7
            ],
            "valuta_detalii": {
                "cod": "RON",
                "nume": "leu românesc",
                "nume_en": "Romanian Leu",
                "simbol": null,
                "zecimale": 2,
                "tari": [
                    "RO"
                ]
            }
        },
        "sursa": {
            "nume": "ICU / CLDR (Unicode Common Locale Data Repository), prin runtime-ul PHP",
            "versiune": "76.1",
            "licenta": "Unicode License.",
            "observatie": "Se actualizează la un upgrade de imagine, nu printr-un import — de aceea versiunea CLDR e în răspuns."
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitNu există țară cu codul dat.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "negasit",
        "mesaj": "Nu există țară cu codul dat."
    }
}