Utile v1 / Timp

Fusuri orare

Zonele orare IANA, cu decalajul curent, dacă au oră de vară şi ce ţară le foloseşte. Cu tara se restrânge la fusurile unei ţări.

GET

https://oneapi.ro/api/utile/v1/timp/fusuri

Parametri de interogare

NumeTipDescriereValori acceptate

taraopțional string | null Filtrează la fusurile unei țări (cod ISO alpha-2, ex. US). max 2 car.

Cum se comportă

Offsetul din răspuns e cel de ACUM, nu unul fix: aceeași zonă are alt offset vara și iarna. De aceea lista se recalculează la fiecare cerere, nu se servește din cache.
O țară poate avea mai multe fusuri (SUA are nouă), iar unele fusuri n-au țară (UTC, Etc/GMT+3) — pentru acelea, filtrul pe țară nu le va găsi.
Sursa e baza IANA din runtime-ul PHP, cu versiunea în răspuns. Fusurile chiar se schimbă prin decizii politice, uneori anunțate cu câteva săptămâni înainte.

La ce folosește

Populezi un selector de fus orar în setările unui cont.
Vezi ce fus folosește o țară, înainte de a programa o notificare.
Verifici ce zone sunt acum pe ora de vară.

Structura răspunsului

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

CâmpTipDescriere

inregistrari integer Câte zone sunt în răspuns.

filtru_tara null Țara după care s-a filtrat, sau null.

zone[].zona string Identificatorul IANA (Europe/Bucharest).

zone[].offset string Decalajul de acum față de UTC, ca +03:00.

zone[].offset_secunde integer Același decalaj, în secunde — util la calcule.

zone[].ora_de_vara boolean Dacă zona e acum pe ora de vară.

zone[].abreviere string Abrevierea curentă (EEST, JST).

sursa.nume string Denumirea sursei oficiale.

sursa.versiune string Versiunea tzdata pe care se sprijină răspunsul.

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/timp/fusuri

{
    "data": {
        "inregistrari": 419,
        "filtru_tara": null,
        "zone": [
            {
                "zona": "Africa/Abidjan",
                "offset": "+00: 00",
                "offset_secunde": 0,
                "ora_de_vara": false,
                "abreviere": "GMT"
            }
        ],
        "sursa": {
            "nume": "IANA Time Zone Database (tzdata), prin runtime-ul PHP",
            "versiune": "2026.3",
            "licenta": "Domeniu public.",
            "observatie": "Se actualizează la un upgrade de imagine, nu printr-un import. Fusurile chiar se schimbă prin decizii politice, uneori cu săptămâni înainte — de aceea versiunea e în răspuns."
        }
    }
}

GEThttps://oneapi.ro/api/utile/v1/timp/fusuri?tara=US

{
    "data": {
        "inregistrari": 29,
        "filtru_tara": "US",
        "zone": [
            {
                "zona": "America/Adak",
                "offset": "-09: 00",
                "offset_secunde": -32400,
                "ora_de_vara": true,
                "abreviere": "HDT"
            }
        ],
        "sursa": {
            "nume": "IANA Time Zone Database (tzdata), prin runtime-ul PHP",
            "versiune": "2026.3",
            "licenta": "Domeniu public.",
            "observatie": "Se actualizează la un upgrade de imagine, nu printr-un import. Fusurile chiar se schimbă prin decizii politice, uneori cu săptămâni înainte — de aceea versiunea e în răspuns."
        }
    }
}

GEThttps://oneapi.ro/api/utile/v1/timp/fusuri?tara=RO

{
    "data": {
        "inregistrari": 1,
        "filtru_tara": "RO",
        "zone": [
            {
                "zona": "Europe/Bucharest",
                "offset": "+03: 00",
                "offset_secunde": 10800,
                "ora_de_vara": true,
                "abreviere": "EEST"
            }
        ],
        "sursa": {
            "nume": "IANA Time Zone Database (tzdata), prin runtime-ul PHP",
            "versiune": "2026.3",
            "licenta": "Domeniu public.",
            "observatie": "Se actualizează la un upgrade de imagine, nu printr-un import. Fusurile chiar se schimbă prin decizii politice, uneori cu săptămâni înainte — de aceea versiunea 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	Un parametru nedeclarat ori o valoare care nu trece validarea (`tara`). Câmpul vinovat e în `detalii`.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (tara). Câmpul vinovat e în detalii.",
        "detalii": {
            "tara": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}