API Reference

API raggy pozwala wysyłać zapytania do bazy wiedzy i zarządzać źródłami z poziomu własnej aplikacji. Wszystkie żądania kierowane są na adres bazowy:

https://api.raggy.pl/v1

Uwierzytelnianie

Każde żądanie wymaga klucza API przekazanego w nagłówku Authorization. Klucze wygenerujesz w ustawieniach projektu.

curl https://api.raggy.pl/v1/query \
  -H "Authorization: Bearer rg_live_a1b2c3..." \
  -H "Content-Type: application/json" \
  -d '{ "project_id": "proj_abc", "query": "Jaka jest polityka urlopowa?", "top_k": 5 }'

Przykładowa odpowiedź

{
  "answer": "Pracownikom przysługuje 26 dni urlopu...",
  "sources": [
    { "id": "src_91", "title": "Regulamin HR.pdf", "score": 0.92 },
    { "id": "src_44", "title": "Onboarding.md", "score": 0.81 }
  ],
  "usage": { "tokens": 1840 }
}

Endpointy