Business v1 / Statistici

Statistici firme

Distribuția firmelor pe o dimensiune: ?dimensiune=forma|stare|judet|caen (implicit forma). Pt caen
întoarce top 20.

GET

https://oneapi.ro/api/business/v1/statistici/firme

Parametri de interogare

NumeTipDescriereValori acceptate

dimensiuneopțional string | null forma, stare, judet sau caen. ex. judetex. formaex. stare

Cum se comportă

Distribuţia firmelor pe o dimensiune: ?dimensiune=forma|stare|judet|caen (implicit forma). Pentru caen întoarce top 20. Agregările sunt calculate pe ~3,9M firme şi cache-uite.

La ce folosește

Un panou de sinteză despre structura mediului de afaceri.
Compararea judeţelor după numărul de firme sau după profilul de activitate.
Contextul agregat în care aşezi cifrele unei singure firme.

Structura răspunsului

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

CâmpTipDescriere

dimensiune string Câte firme are registrul în total.

distributie[].judet string Judeţul.

distributie[].cod_auto string Indicativul auto al judeţului.

distributie[].nr_firme integer Numărul de firme.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/statistici/firme?dimensiune=judet

{
    "data": {
        "dimensiune": "judet",
        "distributie": [
            {
                "judet": "București",
                "cod_auto": "B",
                "nr_firme": 725317
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/statistici/firme?dimensiune=forma

{
    "data": {
        "dimensiune": "forma",
        "distributie": [
            {
                "forma": "SRL",
                "este_persoana_fizica": false,
                "nr_firme": 2666704
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/statistici/firme?dimensiune=stare

{
    "data": {
        "dimensiune": "stare",
        "distributie": [
            {
                "stare": "radiată",
                "categorie": "radiata",
                "nr_firme": 1908588
            }
        ]
    }
}

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 (`dimensiune`). Câmpul vinovat e în `detalii`.
422	dimensiune_invalida	Dimensiuni valide: forma, stare, judet, caen.
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 (dimensiune). Câmpul vinovat e în detalii.",
        "detalii": {
            "dimensiune": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}