Riferimento API

Restituisce il profilo dell'utente autenticato.

Aggiorna i campi del profilo, come il nome visualizzato e le preferenze di notifica.

Sincronizza l'utente auth di Supabase con il record utente della piattaforma.

Indica se l'utente autenticato ha completato l'onboarding.

Carica una nuova immagine avatar per l'utente autenticato.

Elenca i robot registrati dal cliente autenticato, dal più recente, fino a 50 voci. I timestamp sono in formato ISO 8601; last_online e last_heartbeat sono null finché il robot non si è connesso almeno una volta.

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

Registra un nuovo robot e ne restituisce l'id. Un id hardware di scheda motore può appartenere a un solo robot; una collisione viene rifiutata con status 409.

Restituisce il profilo cliente dell'utente autenticato.

Aggiorna i campi del profilo cliente.

Elenca i dataset cloud del cliente con conteggio degli episodi e dimensioni.

Elenca le fatture mensili del cliente.

Restituisce le statistiche di utilizzo per la dashboard cliente.

Restituisce il profilo operatore dell'utente autenticato.

Crea o aggiorna il profilo operatore.

Elenca i robot attualmente disponibili che corrispondono alle certificazioni dell'operatore.

Elenca le richieste di certificazione dell'operatore e il loro stato.

Richiede la certificazione per un tipo di robot.

Restituisce il calendario di disponibilità settimanale dell'operatore.

Aggiorna il calendario di disponibilità settimanale.

Restituisce la disponibilità attuale dell'operatore.

Restituisce statistiche su guadagni e sessioni per la dashboard operatore.

Elenca le sessioni per l'utente autenticato. Gli operatori vedono le sessioni che hanno operato; i clienti vedono le sessioni sui propri robot. L'insieme di campi differisce leggermente tra le due viste: la vista cliente include episodes_collected e data_collected_mb, la vista operatore 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."
    }
  ]
}

Avvia una sessione di teleoperazione su un robot disponibile. Richiede il ruolo operatore: i clienti non possono avviare sessioni. Un operatore può mantenere al massimo una sessione ACTIVE o PAUSED alla volta, e il robot deve avere attualmente lo stato AVAILABLE. All'avvio immediato il robot passa a IN_SESSION e il cliente viene notificato.

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

Restituisce una singola sessione con i relativi dettagli.

Aggiorna il ciclo di vita della sessione: pausa, ripresa, terminazione e azioni correlate.

Richiede un'estensione della sessione. Solo il cliente proprietario della sessione può chiamare questo endpoint, e la sessione deve essere ACTIVE. La richiesta viene registrata come evento di sessione e l'operatore riceve una notifica; l'estensione vera e propria avviene quando l'operatore vi risponde.

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

Elenca i messaggi di chat di una sessione.

Invia un messaggio di chat in una sessione.

Valuta una sessione completata su una scala da 1 a 5 stelle, con un commento facoltativo.

Esporta i dati di sessione.

Crea o restituisce il cliente Stripe usato per la fatturazione cliente.

Restituisce lo stato dell'account Stripe Connect dell'operatore.

Avvia l'onboarding di Stripe Connect per i pagamenti agli operatori.

Crea un SetupIntent Stripe per salvare un metodo di pagamento.

Crea una sessione del portale di fatturazione Stripe per gestire metodi di pagamento e fatture.

Restituisce informazioni sui pagamenti per l'operatore autenticato.

Richiede un pagamento del saldo accumulato. Il pagamento minimo è 10,00 EUR.

Riceve eventi webhook da Stripe. Chiamato da Stripe, non dai client API.

Controllo di salute per l'API e la sua connessione al database. Restituisce 200 quando entrambi sono a posto; se il controllo del database fallisce, viene restituita la stessa struttura con status e db impostati su error e stato HTTP 503.

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

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

Restituisce informazioni pubbliche su un modello di robot supportato.

Restituisce i piani tariffari pubblici attuali.

Invia un messaggio dal modulo di contatto. Il messaggio viene prima memorizzato e poi consegnato via email, così un'interruzione temporanea della posta non lo fa perdere: in quel caso la risposta riporta stored true e delivered false, e la consegna viene ritentata operativamente.

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
}

Richiede il supporto per un tipo di robot non ancora presente sulla piattaforma.

Restituisce statistiche pubbliche della piattaforma.