POST/v1/reminders
Creează un memento pentru un utilizator. Acceptă limbaj natural ("mâine la 9 sun pe Andrei") sau ISO-8601 strict + text. Returnează programarea parsată ca s-o confirmi înainte de notificare.
API · tier Apex
API-ul Arvis pentru dezvoltatori
O suprafață REST mică și onestă pentru ce face Arvis cel mai bine: memento-uri, mesaje, fișiere, utilizare. Găzduit în UE, auth bearer, fără surprize.
Beta închis · deschidere Q3 2026Ce poți face azi
Versiunea onestăAcum, Arvis e conversație înainte de orice. Totul se întâmplă în Telegram. API-ul există și funcționează intern (îl folosim noi înșine) dar nu e încă deschis clienților externi. Dacă ești pe tier Apex și vrei chei early-access înainte de deschiderea publică Q3, scrie-ne din bot cu /api_request — primim echipe în loturi mici.
Endpoint-uri planificate
Suprafață v1 · subiect de modificareGET/v1/reminders
Listează memento-urile active ale unui utilizator. Cursor-paginat (50/pag), filtrabil după status & due_before. Include formularea originală — util pentru dashboard-uri.
DELETE/v1/reminders/:id
Anulează un memento. Idempotent — ștergerea unuia deja anulat returnează 204, niciodată 404. Utilizatorul e notificat în bot că memento-ul a fost anulat de o integrare externă.
POST/v1/messages
Trimite un mesaj prin Arvis către unul dintre utilizatorii tăi. Iese ca mesaj normal de bot — respectă limba, orele de liniște și mute-ul per utilizator. Util pentru integrări proactive (deploy, on-call, evenimente CRM).
GET/v1/usage
Consum de tokeni per utilizator și per cheie, defalcat pe familii de modele. Util pentru pass-through de facturare și pentru a depista buclele scăpate înainte să devină scumpe.
POST/v1/files
Încarcă un PDF, DOCX sau text și injectează-l în indexul RAG al utilizatorului. După aceea, utilizatorul poate pune întrebări pe document din chat. Returnează numărul de chunks și un receipt de ingest.
Autentificare
Token bearer din dashboard-ul ApexFiecare abonament Apex include o cheie API, generată din ecranul /api_keys din bot. Rotește cheile oricând — cele vechi funcționează încă 24h, deci deploy-urile nu se rup la mijloc.
# Orice cerere are nevoie de token bearer în header-ul Authorization
curl https://api.arvisagent.eu/v1/reminders \
-H "Authorization: Bearer arv_live_a1b2c3d4..." \
-H "Content-Type: application/json" \
-d '{
"user_id": "usr_84920",
"text": "mâine la 9 sun pe Andrei despre contract"
}'
Limite de cerere
Baseline tier Apex · mai mari la cerereCereri zilnice1.000/cheie/zi
Burst10/sec
Upload fișier20MB max
Concurență4/cheie
Atingerea unei limite returnează 429 cu header Retry-After. Dacă ai nevoie de mai mult headroom pentru un caz real de producție, spune-ne — ridicăm plafonul.
Ce nu primești din acest API
Scope onestE un API focalizat pe lucrurile specifice pe care Arvis le face bine în chat: memento-uri, mesaje, fișiere, utilizare. Nu e un API LLM general-purpose — pentru asta folosește Anthropic, OpenAI sau Mistral direct. API-ul Arvis există ca să poți integra produsul Arvis în stack-ul tău, nu ca să închiriezi inferență.
Cere chei early-access
Beta închis se deschide întâi clienților Apex. Calea cea mai rapidă e să faci upgrade și să trimiți /api_request în bot — revizuim manual fiecare cerere, ca să dimensionăm corect capacitatea.