Първи стъпки

В това ръководство ще изпълните правно търсене, ще прегледате подредените резултати и ще извлечете пълния документ за първия от тях.

Преди да започнете

Необходим ви е API ключ от активен план или от тестов достъп с покана. Можете да създадете ключ от страницата API достъп. Съхранявайте го в защитена услуга за управление на тайни. За целите на това ръководство го задайте като променлива на средата в текущата терминална сесия:

export PI_API_KEY="pi_live_…"

Не поставяйте продукционен ключ в клиентски JavaScript код, мобилно приложение, публично хранилище или заявка към AI модел.

1. Търсене в правни източници

curl --request POST \
  --url https://api.pravenintelekt.com/v1/search \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $PI_API_KEY" \
  --max-time 60 \
  --data '{
    "query": "Давностен срок при непозволено увреждане",
    "source_types": [
      "bulgarian_laws_regulations",
      "high_courts_cases"
    ],
    "max_results": 10
  }'

Отговорът съдържа подреден масив results. Всеки резултат включва document_id и служебна стойност collection, чиято структура не е част от публичния API. Съхранявайте двете стойности заедно — комбинацията им идентифицира документа при последващо извличане.

{
  "query": "Давностен срок при непозволено увреждане",
  "result_count": 10,
  "results": [
    {
      "document_id": "…",
      "collection": "legal_documents",
      "type": "Закон",
      "title": "Закон за задълженията и договорите",
      "excerpts": []
    }
  ]
}

2. Извличане на пълния документ

Когато стойностите са получени от API, кодирайте и двата параметъра за безопасно включване в URL адреса:

curl --get \
  --url https://api.pravenintelekt.com/v1/documents \
  --header "X-API-Key: $PI_API_KEY" \
  --data-urlencode "document_id=…" \
  --data-urlencode "collection=legal_documents"

Извличането на документ изразходва отделна единица от квотата. Когато документът има структурирано съдържание, отговорът включва подреден масив elements, подходящ за визуализиране по членове или параграфи.

3. Проверка на потреблението

curl --url https://api.pravenintelekt.com/v1/usage \
  --header "X-API-Key: $PI_API_KEY"

Проверявайте потреблението преди пакетна обработка, за да избегнете прекъсване при достигане на monthly_quota_exceeded.

Следващи стъпки

• Позволете на API да избере подходящите видове източници, като пропуснете source_types.
• Вижте допустимите стойности на филтрите чрез каталожните крайни точки в Търсене.
• Генерирайте типизиран клиент за TypeScript или Python.
• Добавете логика за повторни опити според указанията в Грешки, квоти и ограничения.