Business v1 / Graf

Cale în graf

Cel mai scurt lanț de legături (prin persoane comune) între două firme: ?de={cui}&la={cui}.
404 dacă nu există legătură până la adâncimea maximă (5).

GET

https://oneapi.ro/api/business/v1/graf/cale

Parametri de interogare

NumeTipDescriereValori acceptate

deopțional string | null CUI-ul firmei de plecare. ex. 14399840ex. 19ex. 739926

laopțional string | null CUI-ul firmei de destinaţie. ex. 43602301ex. 17285166ex. 43258691

Cum se comportă

Caută drumul între două firme în graful de conexiuni (persoane comune), printr-o parcurgere în lăţime până la o adâncime dată. Întoarce lanţul de firme şi persoanele care le leagă.
Varianta ancorată pe o firmă anume e la /firme/{cui}/conexe/{cui2}.

La ce folosește

Demonstrarea legăturii dintre două firme, cu lanţul de persoane care le uneşte.
Verificarea independenţei ofertanţilor într-o procedură de achiziţie.
Vizualizarea unui drum în graf, pentru un raport de investigaţie.

Structura răspunsului

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

CâmpTipDescriere

lungime integer Câţi paşi are lanţul de legături dintre cele două firme.

cale[].cui integer Codul fiscal.

cale[].denumire string Denumirea.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/graf/cale?de=14399840&la=43602301

{
    "data": {
        "lungime": 1,
        "cale": [
            {
                "cui": 14399840,
                "denumire": "DANTE INTERNATIONAL SA"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/graf/cale?de=19&la=17285166

{
    "data": {
        "lungime": 1,
        "cale": [
            {
                "cui": 19,
                "denumire": "BUCUR OBOR SA"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/graf/cale?de=19&la=43258691

{
    "data": {
        "lungime": 1,
        "cale": [
            {
                "cui": 19,
                "denumire": "BUCUR OBOR SA"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/graf/cale?de=739926&la=476331

{
    "data": {
        "lungime": 1,
        "cale": [
            {
                "cui": 739926,
                "denumire": "MOBILA RADAUTI SA"
            }
        ]
    }
}

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	fara_legatura	Nu există legătură între firme (până la adâncimea 5).
422	validare	Un parametru nedeclarat ori o valoare care nu trece validarea (`de`, `la`). Câmpul vinovat e în `detalii`.
422	parametri	Specifică `de` și `la` (CUI-uri).
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 (de, la). Câmpul vinovat e în detalii.",
        "detalii": {
            "de": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}