Utile v1 / Coduri

Detaliu valută

O valută întreagă: codul numeric, denumirea, câte zecimale are şi în ce ţări e monedă oficială.

GET

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

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul ISO 4217 al valutei (ex. RON).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Un cod de trei litere pe care CLDR nu-l cunoaște întoarce 404, nu un răspuns gol cu numele egal cu codul.

La ce folosește

Afli câte zecimale are o monedă înainte de a emite o factură în ea.
Verifici dacă un cod de valută primit e valid.
Vezi câte țări folosesc moneda, ca să știi dacă e regională sau națională.

Structura răspunsului

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

CâmpTipDescriere

valuta.cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.

valuta.nume string Numele, aşa cum îl publică sursa.

valuta.nume_en string

valuta.simbol null

valuta.zecimale integer Câte zecimale are moneda.

valuta.tari array Teritoriile care o folosesc.

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/valute/RON

{
    "data": {
        "valuta": {
            "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."
        }
    }
}

GEThttps://oneapi.ro/api/utile/v1/coduri/valute/TND

{
    "data": {
        "valuta": {
            "cod": "TND",
            "nume": "dinar tunisian",
            "nume_en": "Tunisian Dinar",
            "simbol": null,
            "zecimale": 3,
            "tari": [
                "TN"
            ]
        },
        "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."
        }
    }
}

GEThttps://oneapi.ro/api/utile/v1/coduri/valute/AED

{
    "data": {
        "valuta": {
            "cod": "AED",
            "nume": "dirham din Emiratele Arabe Unite",
            "nume_en": "United Arab Emirates Dirham",
            "simbol": null,
            "zecimale": 2,
            "tari": [
                "AE"
            ]
        },
        "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

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	Nu există valuta cu codul dat.
429	cota_depasita	Cota 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ă valuta cu codul dat."
    }
}