Utile v1 / Coduri

Valute

Lista ISO 4217 a valutelor, cu codul, denumirea, numărul de zecimale şi ţările care le folosesc. Zecimalele contează la rotunjire: yenul n-are niciuna, dinarul are trei.

GET

https://oneapi.ro/api/utile/v1/coduri/valute

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Sunt valutele ÎN CIRCULAȚIE, deduse din teritoriile care le folosesc — nu tot registrul ISO 4217, care conține și coduri istorice și unități de cont (XAU aurul, XDR drepturile speciale de tragere).
zecimale nu e mereu 2. Cine formatează sume internaționale cu două zecimale peste tot greșește yenul, dinarul tunisian și încă vreo zece monede.
simbol e null acolo unde moneda n-are un simbol distinct de cod. Un „simbol" care e chiar codul n-ajută pe nimeni să formateze o sumă, deci nu-l dăm ca simbol.
Pentru cursul de schimb al leului, vezi zona curs din modulul Financiar — aici sunt doar codurile și metadatele lor.

La ce folosește

Populezi un selector de valute cu numele în română.
Afli câte zecimale are fiecare monedă, ca să formatezi și să rotunjești corect.
Vezi ce țări folosesc o anumită valută.

Structura răspunsului

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

CâmpTipDescriere

inregistrari integer Câte înregistrări are răspunsul.

valute[].cod string Codul ISO 4217 de trei litere.

valute[].nume string Numele în română.

valute[].nume_en string Numele în engleză.

valute[].simbol null Simbolul monedei, sau null.

valute[].zecimale integer Numărul de zecimale al monedei.

valute[].tari array Teritoriile care o folosesc.

observatie string Precizare despre cum se citeşte răspunsul: o convenţie de calcul sau o limită a datelor.

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

{
    "data": {
        "inregistrari": 154,
        "valute": [
            {
                "cod": "AED",
                "nume": "dirham din Emiratele Arabe Unite",
                "nume_en": "United Arab Emirates Dirham",
                "simbol": null,
                "zecimale": 2,
                "tari": [
                    "AE"
                ]
            }
        ],
        "observatie": "Sunt valutele în circulație, deduse din teritoriile care le folosesc — nu tot registrul ISO 4217, care conține și coduri istorice și unități de cont (XAU, XDR). `zecimale` NU e mereu 2: yenul are 0, dinarul tunisian are 3.",
        "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.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
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": "validare",
        "mesaj": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}