Străzile unei localități#
GET/api/v1/nomenclator/strazi
Necesită loc_jud_cod și loc_cod din localitate — pentru orașe folosește loc_cod_artere când există (orașele apar de două ori în nomenclator, iar străzile sunt legate de al doilea rând). 1 credit pe rezultat întors.
Parametri
loc_jud_codinteger· query- Cheia județului, din localitate. ex.: 12
loc_codinteger· query- Cheia localității: loc_cod_artere al localității dacă există, altfel loc_cod. ex.: 103
qstring· query- Începutul numelui străzii. ex.: memorandumului
cod_postalstring· query- Codul poștal.
paginainteger· query- Numărul paginii, de la 1. ex.: 1
per_paginainteger· query- Rezultate pe pagină, maxim 100. ex.: 20
ordinestring· query- Ordinea rezultatelor (vezi valorile permise pe endpoint).
denumireex.: denumire
Câmpurile răspunsului
successboolean- true când cererea a reușit.
sursastring- Sursa datelor.
pagina · per_paginainteger- Pagina curentă și rezultatele pe pagină.
total · total_paginiinteger- Totalul rezultatelor care se potrivesc filtrelor și numărul de pagini pe care le poți parcurge.
rezultatearray- Rezultatele paginii.
rezultate[].denumirestring- Numele străzii.
rezultate[].tipstring- Tipul arterei.
rezultate[].cod_postalstring|null- Codul poștal (null = vezi intervale).
rezultate[].intervalearray- Intervalele de numere, cu paritate și codul poștal.
rezultate[].loc_jud_codinteger- Cheia județului.
rezultate[].loc_codinteger- Cheia localității.
rezultate[].codinteger- Codul străzii.
cost.credite_consumate · mod · tipinteger · string- Creditele consumate de cerere, modul de taxare (fix sau per_rezultat) și tipul creditelor (general sau premium).
Reguli pentru integrare
- 1Trimite cel puțin unul dintre parametrii: loc_cod, cod_postal.
- 2Maximum 100 rezultate pe pagină. Paginile acoperă toate rezultatele care se potrivesc filtrelor; dacă o căutare e prea largă pentru a fi paginată până la capăt, răspunsul spune până unde poți merge.
- 3Costul se calculează pe numărul de rezultate întoarse; o căutare fără rezultate nu costă nimic.
curl -X GET "https://www.firmeapi.ro/api/v1/nomenclator/strazi?loc_jud_cod=12&loc_cod=103&q=memorandumului" \ -H "X-API-KEY: CHEIA_TA_API" \ -H "Accept: application/json"
200 OK · se taxează 1 credit / rezultat
{
"success": true,
"sursa": "Ministerul Finanțelor — nomenclatorul geografic",
"pagina": 1,
"per_pagina": 2,
"total": 1,
"total_pagini": 1,
"rezultate": [
{
"loc_jud_cod": 12,
"loc_cod": 103,
"cod": 486,
"denumire": "Memorandumului",
"tip": "Str",
"cod_postal": "400114",
"intervale": []
}
],
"cost": {
"credite_consumate": 1,
"mod": "per_rezultat",
"tip": "general"
}
}