Referencia de la API

Devuelve el perfil del usuario autenticado.

Actualiza campos del perfil como el nombre visible y las preferencias de notificación.

Sincroniza el usuario de autenticación de Supabase con el registro de usuario de la plataforma.

Informa si el usuario autenticado ha completado el onboarding.

Sube una nueva imagen de avatar para el usuario autenticado.

Lista los robots registrados por el cliente autenticado, los más nuevos primero, hasta 50 entradas. Las marcas de tiempo son ISO 8601; last_online y last_heartbeat son null hasta que el robot se ha conectado alguna vez.

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 robot nuevo y devuelve su id. El id de hardware de una placa de motor solo puede pertenecer a un robot; una colisión se rechaza con el estado 409.

Devuelve el perfil de cliente del usuario autenticado.

Actualiza los campos del perfil de cliente.

Lista los conjuntos de datos en la nube del cliente con recuentos de episodios y tamaños.

Lista las facturas mensuales del cliente.

Devuelve estadísticas de uso para el panel del cliente.

Devuelve el perfil de operador del usuario autenticado.

Crea o actualiza el perfil de operador.

Lista los robots que están actualmente disponibles y coinciden con las certificaciones del operador.

Lista las solicitudes de certificación del operador y su estado.

Solicita la certificación para un tipo de robot.

Devuelve el horario de disponibilidad semanal del operador.

Actualiza el horario de disponibilidad semanal.

Devuelve la disponibilidad actual del operador.

Devuelve estadísticas de ganancias y sesiones para el panel del operador.

Lista las sesiones del usuario autenticado. Los operadores ven las sesiones que operaron; los clientes ven las sesiones en sus robots. El conjunto de campos difiere ligeramente entre ambas vistas: la vista del cliente incluye episodes_collected y data_collected_mb, la vista del operador incluye 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."
    }
  ]
}

Inicia una sesión de teleoperación en un robot disponible. Requiere el rol de operador: los clientes no pueden iniciar sesiones. Un operador puede mantener como máximo una sesión ACTIVE o PAUSED a la vez, y el robot debe tener actualmente el estado AVAILABLE. En un inicio inmediato, el robot cambia a IN_SESSION y se notifica al cliente.

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

Devuelve una única sesión con sus detalles.

Actualiza el ciclo de vida de la sesión: pausar, reanudar, terminar y acciones relacionadas.

Solicita una extensión de sesión. Solo el cliente propietario de la sesión puede llamar a este endpoint, y la sesión debe estar ACTIVE. La solicitud se registra como un evento de sesión y el operador recibe una notificación; la extensión en sí ocurre cuando el operador actúa sobre ella.

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

Lista los mensajes de chat de una sesión.

Envía un mensaje de chat en una sesión.

Valora una sesión completada en una escala de 1 a 5 estrellas, con un comentario opcional.

Exporta datos de sesión.

Crea o devuelve el cliente de Stripe usado para la facturación del cliente.

Devuelve el estado de la cuenta de Stripe Connect del operador.

Inicia el onboarding de Stripe Connect para los pagos al operador.

Crea un SetupIntent de Stripe para guardar un método de pago.

Crea una sesión del portal de facturación de Stripe para gestionar métodos de pago y facturas.

Devuelve información de pagos para el operador autenticado.

Solicita un pago de las ganancias acumuladas. El pago mínimo es 10,00 EUR.

Recibe eventos de webhook de Stripe. Es llamado por Stripe, no por clientes de la API.

Comprobación de salud para la API y su conexión a la base de datos. Devuelve 200 cuando ambas están bien; si la comprobación de base de datos falla, se devuelve la misma estructura con status y db en error y el estado HTTP 503.

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

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

Devuelve información pública sobre un modelo de robot compatible.

Devuelve los planes de precios públicos actuales.

Envía un mensaje del formulario de contacto. El mensaje se almacena primero y luego se entrega por correo electrónico, así que una interrupción temporal del correo no lo pierde: en ese caso la respuesta reporta stored true y delivered false, y la entrega se reintenta de forma operativa.

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
}

Solicita compatibilidad para un tipo de robot que todavía no está en la plataforma.

Devuelve estadísticas públicas de la plataforma.