Telecom v1 / Telecom

Blocurile unui operator

Căutarea inversă: ce intervale de numere a primit un titular de licenţă, paginat, opţional pe tip şi domeniu.

GET

https://oneapi.ro/api/telecom/v1/operatori/{slug}/blocuri

Parametri de cale

NumeTipDescriereExemplu

slugobligatoriu string Slug-ul operatorului, din /telecom/v1/operatori.

Parametri de interogare

NumeTipDescriereValori acceptate

tipopțional string | null Opțional: mobil, fix, nongeografic ori scurt. mobilfixnongeograficscurt

domeniuopțional string | null Opțional: domeniul de numerotație, fără 0. ex. 264

Cum se comportă

Blocurile sunt ordonate după primul număr și paginate câte 100 (cel mult 500 pe pagină).
Blocurile sunt alocarea inițială, nu numerele deținute azi: un număr portat la alt operator rămâne în blocul celui care l-a primit.
Numerele sunt fără 0 inițial, ca la fara_prefix din analiză; un bloc de o singură poziție e un număr scurt (1922).

La ce folosește

Căutarea inversă: ce intervale de numere a primit un operator, ca să verifici în masă o listă de numere fără câte o cerere pe număr.
Construirea unei tabele locale de rutare pe prefixe, pentru un operator anume.
Analiza resursei alocate unui operator pe tipuri (mobil față de fix) ori pe domenii.

Structura răspunsului

CâmpTipDescriere

data[].domeniu string Domeniul de numerotație.

data[].primul string Primul număr din bloc.

data[].ultimul string Ultimul număr din bloc.

data[].dimensiune integer Câte numere conține blocul.

data[].tip string mobil | fix | nongeografic | scurt.

meta.operator.operator string Numele exact al operatorului.

meta.operator.slug string Slug-ul cerut.

meta.paginare.pagina integer Pagina curentă, numărată de la 1.

meta.paginare.per_pagina integer Câte înregistrări are o pagină.

meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.

meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/telecom/v1/operatori/vodafone-romania-sa/blocuri?tip=mobil

{
    "data": [
        {
            "domeniu": "72",
            "primul": "720000000",
            "ultimul": "720999999",
            "dimensiune": 1000000,
            "tip": "mobil"
        }
    ],
    "meta": {
        "operator": {
            "operator": "VODAFONE ROMANIA S.A.",
            "slug": "vodafone-romania-sa"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 100,
            "total": 42,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/telecom/v1/operatori/orange-romania-sa/blocuri?domeniu=264

{
    "data": [
        {
            "domeniu": "264",
            "primul": "264920",
            "ultimul": "264929",
            "dimensiune": 10,
            "tip": "fix"
        }
    ],
    "meta": {
        "operator": {
            "operator": "ORANGE ROMANIA S.A.",
            "slug": "orange-romania-sa"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 100,
            "total": 46,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/telecom/v1/operatori/vodafone-romania-sa/blocuri

{
    "data": [
        {
            "domeniu": "19",
            "primul": "1922",
            "ultimul": "1922",
            "dimensiune": 1,
            "tip": "scurt"
        }
    ],
    "meta": {
        "operator": {
            "operator": "VODAFONE ROMANIA S.A.",
            "slug": "vodafone-romania-sa"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 100,
            "total": 277,
            "pagini": 3
        }
    }
}

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ă operator cu slug-ul cerut. Slug-urile sunt în `/telecom/v1/operatori`.
422	validare	`tip` ori `domeniu` au o valoare nepermisă.
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": "tip ori domeniu au o valoare nepermisă.",
        "detalii": {
            "slug": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}