Referencja API

Zwraca profil uwierzytelnionego użytkownika.

Aktualizuje pola profilu, takie jak nazwa wyświetlana i preferencje powiadomień.

Synchronizuje użytkownika auth Supabase z rekordem użytkownika platformy.

Zgłasza, czy uwierzytelniony użytkownik ukończył onboarding.

Przesyła nowy obraz awatara dla uwierzytelnionego użytkownika.

Wyświetla roboty zarejestrowane przez uwierzytelnionego klienta, najnowsze najpierw, do 50 wpisów. Znaczniki czasu są w formacie ISO 8601; last_online i last_heartbeat są null, dopóki robot nie połączył się choć raz.

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"
  }
]

Rejestruje nowego robota i zwraca jego id. Identyfikator sprzętowy płytki silnikowej może należeć tylko do jednego robota; kolizja jest odrzucana ze statusem 409.

Zwraca profil klienta uwierzytelnionego użytkownika.

Aktualizuje pola profilu klienta.

Wyświetla datasety klienta w chmurze wraz z liczbą epizodów i rozmiarami.

Wyświetla miesięczne faktury klienta.

Zwraca statystyki użycia dla panelu klienta.

Zwraca profil operatora uwierzytelnionego użytkownika.

Tworzy albo aktualizuje profil operatora.

Wyświetla roboty, które są aktualnie dostępne i pasują do certyfikatów operatora.

Wyświetla wnioski certyfikacyjne operatora i ich status.

Składa wniosek o certyfikat dla typu robota.

Zwraca tygodniowy harmonogram dostępności operatora.

Aktualizuje tygodniowy harmonogram dostępności.

Zwraca bieżącą dostępność operatora.

Zwraca statystyki zarobków i sesji dla panelu operatora.

Wyświetla sesje uwierzytelnionego użytkownika. Operatorzy widzą sesje, które prowadzili; klienci widzą sesje na swoich robotach. Zestaw pól nieznacznie różni się między dwoma widokami: widok klienta zawiera episodes_collected i data_collected_mb, widok operatora zawiera 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."
    }
  ]
}

Rozpoczyna sesję teleoperacji na dostępnym robocie. Wymaga roli operatora: klienci nie mogą rozpoczynać sesji. Operator może jednocześnie dzierżyć co najwyżej jedną sesję ACTIVE lub PAUSED, a robot musi mieć aktualnie status AVAILABLE. Przy natychmiastowym starcie robot przełącza się na IN_SESSION, a klient zostaje powiadomiony.

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"
}

Zwraca pojedynczą sesję wraz z jej szczegółami.

Aktualizuje cykl życia sesji: wstrzymanie, wznowienie, zakończenie i powiązane akcje.

Zgłasza wniosek o przedłużenie sesji. Tylko klient będący właścicielem sesji może wywołać ten endpoint, a sesja musi być ACTIVE. Wniosek jest rejestrowany jako zdarzenie sesji, a operator otrzymuje powiadomienie; samo przedłużenie następuje, gdy operator na nie zareaguje.

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"
}

Wyświetla wiadomości czatu sesji.

Wysyła wiadomość czatu w sesji.

Ocenia ukończoną sesję w skali od 1 do 5 gwiazdek, z opcjonalnym komentarzem.

Eksportuje dane sesji.

Tworzy albo zwraca klienta Stripe używanego do rozliczeń klienta.

Zwraca status konta Stripe Connect operatora.

Rozpoczyna onboarding Stripe Connect dla wypłat operatora.

Tworzy Stripe SetupIntent do zapisania metody płatności.

Tworzy sesję portalu rozliczeniowego Stripe do zarządzania metodami płatności i fakturami.

Zwraca informacje o wypłacie dla uwierzytelnionego operatora.

Zgłasza wniosek o wypłatę zgromadzonych zarobków. Minimalna wypłata wynosi 10,00 EUR.

Odbiera zdarzenia webhook Stripe. Wywoływane przez Stripe, nie przez klientów API.

Health check dla API i jego połączenia z bazą danych. Zwraca 200, gdy oba są w porządku; jeśli sprawdzenie bazy danych się nie powiedzie, zwracana jest ta sama struktura z status i db ustawionymi na error oraz statusem HTTP 503.

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

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

Zwraca publiczne informacje o obsługiwanym modelu robota.

Zwraca aktualne publiczne plany cenowe.

Wysyła wiadomość z formularza kontaktowego. Wiadomość jest najpierw zapisywana, a potem dostarczana e-mailem, więc tymczasowa awaria poczty jej nie gubi: w takim przypadku odpowiedź zgłasza stored true i delivered false, a dostarczenie jest ponawiane operacyjnie.

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
}

Zgłasza prośbę o obsługę typu robota, którego jeszcze nie ma na platformie.

Zwraca publiczne statystyki platformy.