Telecom v1 / Telecom

Operatori de numerotație

Nomenclator: titularii de licență, cu câte blocuri și câte numere dețin.

GET

https://oneapi.ro/api/telecom/v1/operatori

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Volumele sunt resursă alocată, nu abonați. Un operator poate deține milioane de numere fără să le folosească — nu citi lista ca pe o cotă de piață.
Numele sunt exact cum le scrie ANCOM, cu diacritice și forma juridică („VODAFONE ROMANIA S.A."). Pentru potrivire proprie folosește forma fără diacritice.

La ce folosește

Popularea unui dropdown de operator cu numele exacte din registrul ANCOM, nu cu variante scrise de mână.
Normalizarea unei coloane „operator" dintr-o bază proprie la denumirea oficială a titularului de licență.
Analiză de piață pe resursa alocată: cine deține cele mai multe numere, și cât din ele sunt mobile față de fixe.

Structura răspunsului

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

CâmpTipDescriere

operator string Titularul de licență, cu numele exact din registru.

slug string Adresa operatorului în /operatori/{slug}/blocuri.

blocuri integer Câte blocuri de numerotație deține.

numere integer Câte numere însumează blocurile lui.

blocuri_mobil integer Din care blocuri de numere mobile.

blocuri_fix integer Din care blocuri de numere fixe.

Exemple de răspuns

GEThttps://oneapi.ro/api/telecom/v1/operatori

{
    "data": [
        {
            "operator": "VODAFONE ROMANIA S.A.",
            "slug": "vodafone-romania-sa",
            "blocuri": 277,
            "numere": 45359464,
            "blocuri_mobil": 42,
            "blocuri_fix": 219
        }
    ]
}

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."
    }
}