oneapi
Autentificare
Business v1 / Nomenclatoare

Clasificare CAEN în masă

Trimiți o listă de descrieri de activitate (body JSON {"texte": ["...", "..."]}, max 50) și primești,
pentru fiecare, codurile CAEN potrivite ca SENS, cu scor. Pentru clasificarea în masă a unui set de
texte dintr-un singur apel. ?limita= (câte sugestii per text, implicit 3, max 10).

POST
https://oneapi.ro/api/business/v1/caen/clasifica-lot

Corpul cererii

Se trimite ca JSON, în corpul cererii (Content-Type: application/json) — nu în şirul de interogare.

NumeTipDescriereValori acceptate
texteopțional array | null Listă de descrieri (obligatoriu, în body). Max 50.
limitaopțional string | null Câte sugestii per text (implicit 3, max 10).
Două descrieri Corpul cererii
{
    "texte": [
        "reparatii biciclete",
        "cabinet stomatologic"
    ],
    "limita": 2
}
O descriere, trei potriviri Corpul cererii
{
    "texte": [
        "transport rutier de marfa"
    ],
    "limita": 3
}
Trei descrieri, cea mai bună potrivire Corpul cererii
{
    "texte": [
        "florarie",
        "service auto",
        "agentie de turism"
    ],
    "limita": 1
}

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Versiunea „în masă" a lui /caen/potriveste: trimiţi o listă de descrieri de activitate (body JSON {"texte": [...]}, max 50) şi primeşti, pentru fiecare, codurile CAEN potrivite ca sens, cu scor. Toate textele se embeddează într-un singur lot (rapid), apoi se compară cu indexul.
  • Gândit pentru clasificarea unui set întreg dintr-un singur apel (ex. o coloană de descrieri dintr-un fişier). Ordinea rezultatelor respectă ordinea textelor; un text gol întoarce potriviri: [].
  • Metoda e POST (lista poate fi lungă). ?limita= alege câte sugestii per text (implicit 3, max 10).

La ce folosește

  • Clasificarea în masă a activităţilor descrise liber în coduri CAEN.
  • Îmbogăţirea unui fişier de firme/produse cu coduri CAEN.

Structura răspunsului

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

CâmpTipDescriere
text string Textul trimis, în ordinea din cerere.
potriviri[].cod string Codul CAEN potrivit.
potriviri[].denumire string | null Denumirea activităţii.
potriviri[].scor number Scorul de potrivire semantică (0–1).

Exemple de răspuns

body: {"texte": ["reparatii biciclete", "cabinet stomatologic"], "limita": 2}

POSThttps://oneapi.ro/api/business/v1/caen/clasifica-lot
{
    "data": [
        {
            "text": "reparatii biciclete",
            "potriviri": [
                {
                    "cod": "9529",
                    "denumire": "Repararea și întreținerea articolelor de uz personal și gospodăresc n.c.a.",
                    "scor": 0.6088588833808899
                }
            ]
        }
    ]
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareLipseşte texte, e gol, sau peste 50 de elemente.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).
503mentenantaIndexul semantic CAEN nu e construit, sau embeddings indisponibil.

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": "Lipseşte texte, e gol, sau peste 50 de elemente."
    }
}