Référence API

Renvoie le profil de l'utilisateur authentifié.

Met à jour des champs du profil tels que le nom affiché et les préférences de notification.

Synchronise l'utilisateur Supabase Auth avec l'enregistrement utilisateur de la plateforme.

Indique si l'utilisateur authentifié a terminé l'onboarding.

Envoie une nouvelle image d'avatar pour l'utilisateur authentifié.

Liste les robots enregistrés par le client authentifié, du plus récent au plus ancien, jusqu'à 50 entrées. Les horodatages sont au format ISO 8601 ; last_online et last_heartbeat valent null tant que le robot ne s'est pas connecté au moins une fois.

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

Enregistre un nouveau robot et renvoie son id. Un identifiant matériel de carte moteur ne peut appartenir qu'à un seul robot ; une collision est rejetée avec le statut 409.

Renvoie le profil client de l'utilisateur authentifié.

Met à jour les champs du profil client.

Liste les jeux de données cloud du client avec le nombre d'épisodes et les tailles.

Liste les factures mensuelles du client.

Renvoie les statistiques d'utilisation pour le dashboard client.

Renvoie le profil opérateur de l'utilisateur authentifié.

Crée ou met à jour le profil opérateur.

Liste les robots actuellement disponibles correspondant aux certifications de l'opérateur.

Liste les demandes de certification de l'opérateur et leur statut.

Demande une certification pour un type de robot.

Renvoie le planning hebdomadaire de disponibilité de l'opérateur.

Met à jour le planning hebdomadaire de disponibilité.

Renvoie la disponibilité actuelle de l'opérateur.

Renvoie les statistiques de gains et de sessions pour le dashboard opérateur.

Liste les sessions de l'utilisateur authentifié. Les opérateurs voient les sessions qu'ils ont pilotées ; les clients voient les sessions sur leurs robots. L'ensemble des champs diffère légèrement entre les deux vues : la vue client inclut episodes_collected et data_collected_mb, la vue opérateur inclut 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."
    }
  ]
}

Démarre une session de téléopération sur un robot disponible. Nécessite le rôle opérateur : les clients ne peuvent pas démarrer de sessions. Un opérateur ne peut détenir qu'une seule session ACTIVE ou PAUSED à la fois, et le robot doit actuellement avoir le statut AVAILABLE. Lors d'un démarrage immédiat, le robot passe à IN_SESSION et le client est notifié.

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

Renvoie une session unique avec ses détails.

Met à jour le cycle de vie de la session : pause, reprise, fin et actions associées.

Demande une prolongation de session. Seul le client propriétaire de la session peut appeler cet endpoint, et la session doit être ACTIVE. La demande est journalisée comme un événement de session et l'opérateur reçoit une notification ; la prolongation elle-même a lieu quand l'opérateur y donne suite.

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

Liste les messages du chat d'une session.

Envoie un message de chat dans une session.

Évalue une session terminée sur une échelle de 1 à 5 étoiles, avec un commentaire facultatif.

Exporte les données de session.

Crée ou renvoie le client Stripe utilisé pour la facturation client.

Renvoie le statut du compte Stripe Connect de l'opérateur.

Démarre l'onboarding Stripe Connect pour les versements aux opérateurs.

Crée un SetupIntent Stripe pour enregistrer un moyen de paiement.

Crée une session du portail de facturation Stripe pour gérer les moyens de paiement et les factures.

Renvoie les informations de versement pour l'opérateur authentifié.

Demande un versement des gains accumulés. Le versement minimum est de 10,00 EUR.

Reçoit les événements webhook de Stripe. Appelé par Stripe, pas par les clients de l'API.

Contrôle de santé de l'API et de sa connexion à la base de données. Renvoie 200 quand les deux sont normaux ; si le contrôle de la base de données échoue, la même structure est renvoyée avec status et db à error et le statut HTTP 503.

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

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

Renvoie des informations publiques sur un modèle de robot pris en charge.

Renvoie les forfaits tarifaires publics actuels.

Soumet un message du formulaire de contact. Le message est d'abord stocké puis livré par e-mail, si bien qu'une panne temporaire de messagerie ne le fait pas perdre : dans ce cas, la réponse indique stored à true et delivered à false, et la livraison est retentée en interne.

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
}

Demande la prise en charge d'un type de robot qui n'est pas encore sur la plateforme.

Renvoie des statistiques publiques de la plateforme.