Referință API

Returnează profilul utilizatorului autentificat.

Actualizează câmpurile profilului, precum numele afișat și preferințele de notificare.

Sincronizează utilizatorul Supabase Auth cu înregistrarea de utilizator de pe platformă.

Raportează dacă utilizatorul autentificat a finalizat onboardingul.

Încarcă o nouă imagine de avatar pentru utilizatorul autentificat.

Listează roboții înregistrați de clientul autentificat, cei mai noi primii, până la 50 de intrări. Marcajele temporale sunt în format ISO 8601; last_online și last_heartbeat sunt null până când robotul s-a conectat cel puțin o dată.

curl https://www.ay-robots.com/api/client/robots \
  -H 'Authorization: Bearer ayr_live_your_key_here'

[
  {
    "id": "1f9f4c1e-7f2a-4b7e-9a45-0f4d2b6c8a11",
    "name": "Lab SO-100",
    "robot_type": "SO-100",
    "status": "AVAILABLE",
    "control_url": "wss://robots.example.com/so100/control",
    "stream_url": "https://robots.example.com/so100/stream",
    "hardware_id": "board:local:usb-1",
    "last_online": "2026-08-09T10:12:00.000Z",
    "last_heartbeat": "2026-08-09T10:12:00.000Z",
    "total_hours": 12.5,
    "tags": ["lab"],
    "notes": null,
    "created_at": "2026-07-01T09:00:00.000Z"
  }
]

Înregistrează un robot nou și returnează id-ul său. Un id de hardware al plăcii de motoare poate aparține unui singur robot; o coliziune este respinsă cu statusul 409.

Returnează profilul de client al utilizatorului autentificat.

Actualizează câmpurile profilului de client.

Listează seturile de date din cloud ale clientului, cu numărul de episoade și dimensiuni.

Listează facturile lunare ale clientului.

Returnează statisticile de utilizare pentru panoul de control al clientului.

Returnează profilul de operator al utilizatorului autentificat.

Creează sau actualizează profilul de operator.

Listează roboții disponibili în prezent și care corespund certificărilor operatorului.

Listează cererile de certificare ale operatorului și starea lor.

Solicită certificarea pentru un tip de robot.

Returnează programul săptămânal de disponibilitate al operatorului.

Actualizează programul săptămânal de disponibilitate.

Returnează disponibilitatea curentă a operatorului.

Returnează statisticile de câștiguri și sesiuni pentru panoul de control al operatorului.

Listează sesiunile utilizatorului autentificat. Operatorii văd sesiunile pe care le-au operat; clienții văd sesiunile de pe roboții lor. Setul de câmpuri diferă ușor între cele două vizualizări: vizualizarea clientului include episodes_collected și data_collected_mb, vizualizarea operatorului include operator_earnings_cents.

curl 'https://www.ay-robots.com/api/sessions?status=COMPLETED&limit=10' \
  -H 'Authorization: Bearer ayr_live_your_key_here'

{
  "sessions": [
    {
      "id": "6b0d2c9a-53f1-4f6e-8f1a-2c9d4e7b5a30",
      "status": "COMPLETED",
      "started_at": "2026-08-08T14:00:12.000Z",
      "ended_at": "2026-08-08T14:47:31.000Z",
      "duration_minutes": 47,
      "client_charge_cents": 1175,
      "episodes_collected": 23,
      "data_collected_mb": 210.4,
      "rating": 5,
      "created_at": "2026-08-08T13:59:58.000Z",
      "robot_id": "1f9f4c1e-7f2a-4b7e-9a45-0f4d2b6c8a11",
      "robot_name": "Lab SO-100",
      "robot_type": "SO-100",
      "operator_name": "Jane D."
    }
  ]
}

Pornește o sesiune de teleoperare pe un robot disponibil. Necesită rolul de operator: clienții nu pot porni sesiuni. Un operator poate deține cel mult o sesiune ACTIVE sau PAUSED la un moment dat, iar robotul trebuie să aibă în prezent starea AVAILABLE. La o pornire imediată, robotul trece la IN_SESSION, iar clientul este notificat.

curl -X POST https://www.ay-robots.com/api/sessions \
  -H 'Authorization: Bearer ayr_live_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{"robotId": "1f9f4c1e-7f2a-4b7e-9a45-0f4d2b6c8a11"}'

{
  "sessionId": "6b0d2c9a-53f1-4f6e-8f1a-2c9d4e7b5a30",
  "status": "ACTIVE"
}

Returnează o singură sesiune cu detaliile sale.

Actualizează ciclul de viață al sesiunii: pauză, reluare, încheiere și acțiuni conexe.

Solicită o prelungire a sesiunii. Poate fi apelat doar de clientul căruia îi aparține sesiunea, iar sesiunea trebuie să fie ACTIVE. Cererea este înregistrată ca eveniment de sesiune, iar operatorul primește o notificare; prelungirea în sine are loc atunci când operatorul reacționează la ea.

curl -X POST https://www.ay-robots.com/api/sessions/6b0d2c9a-53f1-4f6e-8f1a-2c9d4e7b5a30/extend \
  -H 'Authorization: Bearer ayr_live_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{"additionalMinutes": 30}'

{
  "message": "Extension request sent to operator"
}

Listează mesajele de chat ale unei sesiuni.

Trimite un mesaj de chat într-o sesiune.

Evaluează o sesiune finalizată pe o scală de la 1 la 5 stele, cu un comentariu opțional.

Exportă datele sesiunii.

Creează sau returnează clientul Stripe folosit pentru facturarea clientului.

Returnează starea contului Stripe Connect al operatorului.

Pornește onboardingul Stripe Connect pentru plățile către operator.

Creează un SetupIntent Stripe pentru salvarea unei metode de plată.

Creează o sesiune de portal de facturare Stripe pentru gestionarea metodelor de plată și a facturilor.

Returnează informațiile de plată pentru operatorul autentificat.

Solicită o plată din câștigurile acumulate. Plata minimă este 10,00 EUR.

Primește evenimentele webhook de la Stripe. Apelat de Stripe, nu de clienții API.

Verificare a stării API-ului și a conexiunii sale la baza de date. Returnează 200 când ambele sunt în regulă; dacă verificarea bazei de date eșuează, se returnează aceeași structură, cu status și db setate pe error și cod de stare HTTP 503.

curl https://www.ay-robots.com/api/health

{
  "status": "ok",
  "db": "ok",
  "timestamp": "2026-08-09T10:12:00.000Z"
}

Returnează informații publice despre un model de robot suportat.

Returnează planurile de preț publice curente.

Trimite un mesaj din formularul de contact. Mesajul este mai întâi stocat și apoi livrat prin e-mail, astfel încât o întrerupere temporară a poștei nu îl pierde: în acest caz, răspunsul raportează stored true și delivered false, iar livrarea este reîncercată operațional.

curl -X POST https://www.ay-robots.com/api/contact \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Jane Doe",
    "email": "jane@example.com",
    "category": "Technical Support",
    "subject": "SO-100 pairing question",
    "message": "My arm shows as offline after pairing."
  }'

{
  "success": true,
  "message": "Message sent successfully",
  "id": "b1f2c3d4-0000-0000-0000-000000000000",
  "stored": true,
  "delivered": true
}

Solicită suport pentru un tip de robot care nu se află încă pe platformă.

Returnează statisticile publice ale platformei.