Търсене
Настройте източниците, филтрите и броя резултати и извличайте пълни документи.
POST /v1/search използва многоетапния процес на Правен Интелект за откриване и оценка на релевантни правни източници. Резултатът включва както самите източници, така и най-подходящите разпоредби от всеки от тях.
Тяло на заявката
| Поле | Тип | По подразбиране | Бележки |
|---|---|---|---|
query | string | задължително | Между 3 и 2000 знака; заявките на български език дават най-добри резултати. |
source_types | string[] | автоматичен избор | Видове източници от каталога. |
court_ids | integer[] | няма | Идентификатори на съдилища от каталога. |
judge_name | string | няма | Търсене по име на съдия, без значение от малки и главни букви и с приблизително съвпадение. |
date_from | YYYY-MM-DD | няма | Начална дата на публикуване, включително. |
date_to | YYYY-MM-DD | няма | Крайна дата на публикуване, включително. |
max_results | integer | 20 | Между 1 и 50. |
include_content | boolean | false | Остаряло и се пренебрегва. Извличайте пълния текст чрез GET /v1/documents. |
Пропуснете source_types, ако искате API да избере подходящите видове източници според въпроса. Задайте стойностите изрично, когато процесът трябва да бъде възпроизводим или предварително знаете в кои източници да се извърши търсенето.
Откриване на стойности за филтрите
Списък на поддържаните видове източници:
curl https://api.pravenintelekt.com/v1/catalog/source-types \
-H "X-API-Key: $PI_API_KEY"Списък на идентификаторите на съдилища:
curl https://api.pravenintelekt.com/v1/catalog/courts \
-H "X-API-Key: $PI_API_KEY"Търсене на съдии, срещани в решенията на даден съд:
curl --get https://api.pravenintelekt.com/v1/catalog/judges \
-H "X-API-Key: $PI_API_KEY" \
--data-urlencode "court=Софийски градски съд" \
--data-urlencode "search=Иванова" \
--data-urlencode "limit=25"court_ids се прилага само към източници със съдебна практика. Подаването на съдилища само с несъдебни източници връща invalid_request.
Резултати
Всеки резултат съдържа:
document_idиcollection: служебна двойка стойности заGET /v1/documents.- Метаданни за документа, като
type,title,date,authorиurl. - Оценка на релевантността и обяснение на български език, когато са налични.
- Данни за съдебното решение като номер, дело и съдия докладчик, когато са приложими.
excerpts: релевантни членове или параграфи със собствени идентификатори и оценки.
Третирайте collection като служебна стойност, чиято структура не е част от публичния API. Не извличайте смисъл от нея и не обвързвайте бизнес логиката си с имена от вътрешната ни структура за съхранение.
Време за отговор и празни резултати
Търсенето обикновено отнема между 10 и 40 секунди. Задайте достатъчно дълго време за изчакване в клиента и избягвайте автоматично повторение след прекъсване, тъй като сървърът може вече да е изпълнил заявката и да е отчел потреблението. Валидна заявка без съвпадения връща HTTP 200, result_count: 0 и празен масив.
Резултатите от търсене никога не включват пълния текст на документа. Извличайте само документите, които потребителят отваря, чрез GET /v1/documents; така отговорите остават по-малки, а квотата за извличане се отчита целенасочено.