Rejeleo la API

Hurudisha wasifu wa mtumiaji aliyethibitishwa.

Husasisha field za wasifu kama jina la kuonyesha na mapendeleo ya arifa.

Hulandanisha mtumiaji wa Supabase auth na rekodi ya mtumiaji wa jukwaa.

Huripoti kama mtumiaji aliyethibitishwa amekamilisha onboarding.

Hupakia picha mpya ya avatar kwa mtumiaji aliyethibitishwa.

Huorodhesha roboti zilizosajiliwa na client aliyethibitishwa, mpya kwanza, hadi maingizo 50. Muhuri wa muda ni ISO 8601; last_online na last_heartbeat ni null hadi roboti iunganishwe mara moja.

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

Husajili roboti mpya na kurudisha id yake. Hardware id ya motor board inaweza kumilikiwa na roboti moja tu; mgongano hukataliwa na status 409.

Hurudisha wasifu wa client wa mtumiaji aliyethibitishwa.

Husasisha field za wasifu wa client.

Huorodhesha dataset za wingu za client na hesabu za episode na ukubwa.

Huorodhesha ankara za mwezi za client.

Hurudisha takwimu za matumizi kwa dashibodi ya client.

Hurudisha wasifu wa operator wa mtumiaji aliyethibitishwa.

Huunda au husasisha wasifu wa operator.

Huorodhesha roboti zinazopatikana sasa na zinazolingana na vyeti vya operator.

Huorodhesha maombi ya cheti ya operator na hali yao.

Huomba cheti kwa aina ya roboti.

Hurudisha ratiba ya wiki ya upatikanaji wa operator.

Husasisha ratiba ya wiki ya upatikanaji.

Hurudisha upatikanaji wa sasa wa operator.

Hurudisha takwimu za mapato na session kwa dashibodi ya operator.

Huorodhesha session za mtumiaji aliyethibitishwa. Waendeshaji huona session walizoziendesha; wateja huona session kwenye roboti zao. Seti ya field hutofautiana kidogo kati ya mitazamo miwili: mtazamo wa client unajumuisha episodes_collected na data_collected_mb, mtazamo wa operator unajumuisha 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."
    }
  ]
}

Huanzisha session ya teleoperesheni kwenye roboti inayopatikana. Inahitaji jukumu la operator: wateja hawawezi kuanzisha session. Operator anaweza kushikilia session moja tu ya ACTIVE au PAUSED kwa wakati mmoja, na roboti lazima iwe na status AVAILABLE sasa. Kwenye kuanza mara moja roboti hubadilika kuwa IN_SESSION na client hufahamishwa.

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

Hurudisha session moja na maelezo yake.

Husasisha mzunguko wa maisha wa session: kusimamisha, kuendelea, kumaliza, na hatua zinazohusiana.

Huomba nyongeza ya session. Client tu anayemiliki session anaweza kuita hii, na session lazima iwe ACTIVE. Ombi hurekodiwa kama tukio la session na operator hupokea arifa; nyongeza yenyewe hutokea wakati operator anachukua hatua juu yake.

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

Huorodhesha ujumbe wa chat wa session.

Hutuma ujumbe wa chat kwenye session.

Hutathmini session iliyokamilika kwa kiwango cha nyota 1 hadi 5, ikiwa na maoni ya hiari.

Huhamisha data ya session.

Huunda au kurudisha mteja wa Stripe unaotumika kwa malipo ya client.

Hurudisha hali ya akaunti ya Stripe Connect ya operator.

Huanzisha onboarding ya Stripe Connect kwa malipo ya operator.

Huunda Stripe SetupIntent kwa kuhifadhi njia ya malipo.

Huunda session ya Stripe billing portal kwa kusimamia njia za malipo na ankara.

Hurudisha taarifa za malipo kwa operator aliyethibitishwa.

Huomba malipo ya mapato yaliyokusanywa. Malipo ya chini kabisa ni 10.00 EUR.

Hupokea matukio ya Stripe webhook. Huitwa na Stripe, si na API clients.

Ukaguzi wa afya kwa API na muunganisho wake wa database. Hurudisha 200 vyote viwili vikiwa sawa; ukaguzi wa database ukishindwa, muundo ule ule hurudishwa na status na db zikiwekwa error na HTTP status 503.

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

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

Hurudisha taarifa za umma kuhusu mfano wa roboti unaosaidiwa.

Hurudisha mipango ya bei ya umma ya sasa.

Huwasilisha ujumbe wa fomu ya mawasiliano. Ujumbe huhifadhiwa kwanza kisha kutolewa kwa barua pepe, hivyo kukatika kwa muda kwa mfumo wa barua hakuupotezi: katika hali hiyo response huripoti stored true na delivered false, na utoaji hurudiwa kiutendaji.

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
}

Huomba msaada kwa aina ya roboti ambayo bado haipo kwenye jukwaa.

Hurudisha takwimu za umma za jukwaa.