Răspunsul API-ului de legislație, rând cu rând: results, passage, cite, in_force
Pe scurt
Un apel la API-ul de legislație Ortexo întoarce JSON: o listă results, în care fiecare pasaj are textul (passage), citarea de folosit ca atare (cite) și indicatorul de vigoare (in_force), plus count, code și message. Mai jos: cererea în curl, Python și JavaScript, rulată pe 16.11.2026, răspunsul real câmp cu câmp și forma erorii când articolul nu există.
Cererea: o cheie, un antet, un corp JSON
Adresa de bază este https://api.ortexo.com. Cheia merge în antetul X-API-Key (sau în Authorization: Bearer), iar corpul e JSON. Cititorul de articole este POST /api/tools/v1/lookup, cu law (numele actului), article și, dacă vrei doar o parte, paragraph sau point. Cheia se face în consolă, pe dev.ortexo.com.
curl
curl -X POST https://api.ortexo.com/api/tools/v1/lookup \
-H "X-API-Key: $ORTEXO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"law": "codul fiscal", "article": "291", "paragraph": "1"}'
Aceeași cerere în Python și în JavaScript (Node, cu fetch). Cele trei fragmente au fost rulate pe 16.11.2026, cu cheia în variabila ORTEXO_API_KEY, și au dat același rezultat.
Python, cu requests
import os
import requests
r = requests.post(
"https://api.ortexo.com/api/tools/v1/lookup",
headers={"X-API-Key": os.environ["ORTEXO_API_KEY"]},
json={"law": "codul fiscal", "article": "291", "paragraph": "1"},
timeout=60,
)
if r.status_code == 402:
raise SystemExit("out of credit: add some in the console")
r.raise_for_status()
body = r.json()
if body["code"]:
raise SystemExit(f'{body["code"]}: {body["message"]}')
for hit in body["results"]:
print(hit["cite"])
print(hit["passage"])
JavaScript, în Node
const response = await fetch('https://api.ortexo.com/api/tools/v1/lookup', {
method: 'POST',
headers: { 'X-API-Key': process.env.ORTEXO_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ law: 'codul fiscal', article: '291', paragraph: '1' }),
});
if (response.status === 402) throw new Error('out of credit: add some in the console');
const body = await response.json();
if (body.code) throw new Error(`${body.code}: ${body.message}`);
for (const hit of body.results) {
console.log(hit.cite);
console.log(hit.passage);
}
Ce afișează fragmentul Python (la fel și cel JavaScript)
CODUL FISCAL din 8 septembrie 2015, Art. 291 alin. (1)
(1) Cota standard se aplică asupra bazei de impozitare pentru operațiunile impozabile care nu sunt scutite de taxă sau care nu sunt supuse cotei reduse, iar nivelul acesteia este 21%.
— Modificări —
• (la 01-08-2025, Alineatul (1) , Articolul 291 , Capitolul VIII , Titlul VII a fost modificat de Punctul 42. , Articolul II din LEGEA nr. 141 din 25 iulie 2025, publicată în MONITORUL OFICIAL nr. 699 din 25 iulie 2025 )
Răspunsul, câmp cu câmp
Răspunsul la cererea de mai sus, așa cum l-a trimis serverul pe 16.11.2026, afișat indentat:
Răspunsul (JSON)
{
"results": [
{
"passage": "(1) Cota standard se aplică asupra bazei de impozitare pentru operațiunile impozabile care nu sunt scutite de taxă sau care nu sunt supuse cotei reduse, iar nivelul acesteia este 21%.\n\n— Modificări —\n• (la 01-08-2025, Alineatul (1) , Articolul 291 , Capitolul VIII , Titlul VII a fost modificat de Punctul 42. , Articolul II din LEGEA nr. 141 din 25 iulie 2025, publicată în MONITORUL OFICIAL nr. 699 din 25 iulie 2025 )",
"cite": "CODUL FISCAL din 8 septembrie 2015, Art. 291 alin. (1)",
"in_force": true,
"code": null
}
],
"count": 1,
"code": null,
"message": null
}
| Câmp | Ce conține | În exemplul de mai sus |
|---|---|---|
results | lista de pasaje; fiecare are passage, cite, in_force și code | un pasaj |
passage | textul, cu nota «Modificări» dedesubt | alineatul (1) din art. 291, cu nota modificării din 01-08-2025 |
cite | citarea de folosit ca atare, la citirea unui articol | CODUL FISCAL din 8 septembrie 2015, Art. 291 alin. (1) |
in_force | true când textul e în vigoare; null când întrebarea nu are un răspuns de vigoare, cum e textul de la o dată din trecut sau o eroare | true |
count | câte pasaje s-au întors | 1 |
code și message | goale la un răspuns bun; la o problemă, motivul și explicația lui | null |
Când nu e nimic de întors
Dacă articolul nu există, răspunsul tot vine cu HTTP 200, dar code spune de ce. Cererea pentru art. 9999 din Codul fiscal, citită pe 16.11.2026:
Răspunsul pentru un articol care nu există
{
"results": [
{
"passage": "Am găsit actul — CODUL FISCAL din 8 septembrie 2015 — dar nu și articolul 9999. Actul are articolele 1–503 (645 în total, cu cele inserate): ultimul este art. 503. Cuprinsul, cu articolele pe diviziuni: get_act_structure(law=\"CODUL FISCAL din 8 septembrie 2015\").",
"cite": "Ortexo",
"in_force": null,
"code": "ARTICLE_NOT_FOUND"
}
],
"count": 1,
"code": "ARTICLE_NOT_FOUND",
"message": "Am găsit actul — CODUL FISCAL din 8 septembrie 2015 — dar nu și articolul 9999. Actul are articolele 1–503 (645 în total, cu cele inserate): ultimul este art. 503. Cuprinsul, cu articolele pe diviziuni: get_act_structure(law=\"CODUL FISCAL din 8 septembrie 2015\")."
}
code este ARTICLE_NOT_FOUND, iar message spune ce există: actul are articolele 1–503 (645 în total, cu cele inserate). Verifică code, nu doar statusul HTTP. Dacă soldul contului s-a terminat, API-ul răspunde cu 402, iar fragmentele de mai sus îl tratează; ce înseamnă celelalte erori e în documentația API.
Căutarea și ruta generală
Căutarea după sens este POST /api/tools/v1/search, cu query și limit. Răspunsul are aceeași formă (results, count, code, message), iar fiecare pasaj are aceleași câmpuri. Pentru jurisprudență există POST /api/tools/v1/search/jurisprudence.
Pentru oricare dintre cele 40 de instrumente din manifest folosești POST /api/tools/v1/call, cu numele instrumentului și argumentele lui. Răspunsul păstrează forma și adaugă numele instrumentului. Cererea și răspunsul pentru art. 291 alin. (1) la 15 iulie 2025:
Cererea
{
"tool": "lookup_article_at_date",
"arguments": {
"law": "Codul fiscal",
"article": "291",
"paragraph": "1",
"date": "2025-07-15"
}
}
Răspunsul
{
"results": [
{
"passage": "(1) Cota standard se aplică asupra bazei de impozitare pentru operațiunile impozabile care nu sunt scutite de taxă sau care nu sunt supuse cotelor reduse, iar nivelul acesteia este:\na) 20% începând cu data de 1 ianuarie 2016 și până la data de 31 decembrie 2016;\nb) 19% începând cu data de 1 ianuarie 2017.",
"cite": "CODUL FISCAL din 8 septembrie 2015, Art. 291 alin. (1) [versiune 2025-04-04]",
"in_force": null,
"code": null
}
],
"count": 1,
"code": null,
"message": null,
"tool": "lookup_article_at_date"
}
Observă că in_force e null aici, iar versiunea folosită stă în cite, ca «[versiune 2025-04-04]»: la o dată din trecut, vigoarea de azi nu mai e întrebarea. Cota TVA la o dată din trecut arată cum se citește un astfel de răspuns.
Ce mai vine cu răspunsul
Fiecare răspuns poartă în antete id-ul apelului (X-Ortexo-Request-Id), unitățile taxate (X-Ortexo-Units) și ce a costat apelul. Păstrează id-ul când ceri ajutor: apelul se găsește în jurnal după el. Fragmentele de mai sus nu folosesc antetele; ele servesc la contabilitate și la depanare.
Întrebări frecvente
- Ce întoarce API-ul de legislație?
- JSON cu o listă
resultsde pasaje; fiecare arepassage(textul),cite(citarea) șiin_force(vigoarea). Răspunsul mai arecount,codeșimessage. - Ce înseamnă in_force în răspunsul API-ului?
trueînseamnă că textul e în vigoare.nullînseamnă că întrebarea nu are un răspuns de vigoare, de pildă textul de la o dată din trecut, unde versiunea stă încite, sau o eroare.- Cum citez rezultatul unui apel?
- La citirea unui articol folosești
citeca atare, de pildă «CODUL FISCAL din 8 septembrie 2015, Art. 291 alin. (1)». Cum se scrie o citare. - Ce fac când articolul cerut nu există?
- Răspunsul vine cu HTTP 200, dar cu
codeARTICLE_NOT_FOUNDși unmessagecare spune ce există: la art. 9999 din Codul fiscal, actul are articolele 1–503. - Pot cere textul de la o dată din trecut prin API?
- Da, prin
POST /api/tools/v1/call, cu instrumentullookup_article_at_dateși argumentelelaw,articleșidate(AAAA-LL-ZZ).
Încearcă pe textele tale
Aceleași instrumente sunt în aplicația Ortexo și în API.
Articolul explică cum citești legea printr-un instrument; nu e consultanță juridică. Ortexo caută, citește și compară textele, iar încadrarea unui caz rămâne a unui specialist.