API referansı

Kimliği doğrulanmış kullanıcının profilini döndürür.

Görünen ad ve bildirim tercihleri gibi profil alanlarını günceller.

Supabase kimlik doğrulama kullanıcısını platform kullanıcı kaydıyla senkronize eder.

Kimliği doğrulanmış kullanıcının katılımı tamamlayıp tamamlamadığını bildirir.

Kimliği doğrulanmış kullanıcı için yeni bir avatar görseli yükler.

Kimliği doğrulanmış istemci tarafından kayıtlı robotları, en yeniden en eskiye, 50 girdiye kadar listeler. Zaman damgaları ISO 8601 biçimindedir; robot bir kez bağlanana kadar last_online ve last_heartbeat null'dur.

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

Yeni bir robot kaydeder ve id'sini döndürür. Bir motor kartı donanım kimliği yalnızca bir robota ait olabilir; bir çakışma 409 durumuyla reddedilir.

Kimliği doğrulanmış kullanıcının istemci profilini döndürür.

İstemci profili alanlarını günceller.

İstemcinin bulut veri kümelerini bölüm sayıları ve boyutlarıyla listeler.

İstemcinin aylık faturalarını listeler.

İstemci panosu için kullanım istatistiklerini döndürür.

Kimliği doğrulanmış kullanıcının operatör profilini döndürür.

Operatör profilini oluşturur veya günceller.

Şu anda uygun olan ve operatörün sertifikasyonlarıyla eşleşen robotları listeler.

Operatörün sertifikasyon isteklerini ve durumlarını listeler.

Bir robot tipi için sertifikasyon talep eder.

Operatörün haftalık müsaitlik programını döndürür.

Haftalık müsaitlik programını günceller.

Operatörün geçerli müsaitliğini döndürür.

Operatör panosu için kazanç ve oturum istatistiklerini döndürür.

Kimliği doğrulanmış kullanıcının oturumlarını listeler. Operatörler çalıştırdıkları oturumları görür; istemciler kendi robotlarındaki oturumları görür. Alan kümesi iki görünüm arasında biraz farklıdır: istemci görünümü episodes_collected ve data_collected_mb içerir, operatör görünümü operator_earnings_cents içerir.

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

Uygun bir robotta bir teleoperasyon oturumu başlatır. Operatör rolü gerektirir: istemciler oturum başlatamaz. Bir operatör aynı anda en fazla bir ACTIVE veya PAUSED oturuma sahip olabilir ve robotun o sırada AVAILABLE durumunda olması gerekir. Anında başlatmada robot IN_SESSION durumuna geçer ve istemciye bildirim gider.

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

Tek bir oturumu ayrıntılarıyla döndürür.

Oturum yaşam döngüsünü günceller: duraklatma, devam ettirme, sonlandırma ve ilgili eylemler.

Bir oturum uzatması talep eder. Bunu yalnızca oturumun sahibi olan istemci çağırabilir ve oturumun ACTIVE olması gerekir. İstek bir oturum olayı olarak günlüğe kaydedilir ve operatör bir bildirim alır; uzatmanın kendisi operatör buna karşılık verdiğinde gerçekleşir.

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

Bir oturumun sohbet mesajlarını listeler.

Bir oturumda sohbet mesajı gönderir.

Tamamlanmış bir oturumu isteğe bağlı bir yorumla 1 ile 5 yıldız arasında değerlendirir.

Oturum verisini dışa aktarır.

İstemci faturalandırması için kullanılan Stripe müşterisini oluşturur veya döndürür.

Operatörün Stripe Connect hesabının durumunu döndürür.

Operatör ödemeleri için Stripe Connect katılımını başlatır.

Bir ödeme yöntemini kaydetmek için bir Stripe SetupIntent oluşturur.

Ödeme yöntemlerini ve faturaları yönetmek için bir Stripe faturalandırma portalı oturumu oluşturur.

Kimliği doğrulanmış operatör için ödeme bilgisini döndürür.

Birikmiş kazancın ödemesini talep eder. Asgari ödeme 10,00 EUR'dur.

Stripe webhook olaylarını alır. API istemcileri tarafından değil, Stripe tarafından çağrılır.

API ve veritabanı bağlantısı için sağlık kontrolü. İkisi de sorunsuzsa 200 döndürür; veritabanı kontrolü başarısız olursa, status ve db değerleri error olarak ayarlanmış aynı şekil 503 HTTP durumuyla döndürülür.

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

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

Desteklenen bir robot modeli hakkında genel bilgi döndürür.

Geçerli genel fiyatlandırma planlarını döndürür.

Bir iletişim formu mesajı gönderir. Mesaj önce saklanır, sonra e-postayla teslim edilir, bu yüzden geçici bir posta kesintisi onu kaybetmez: bu durumda yanıt stored true ve delivered false bildirir, teslimat operasyonel olarak tekrar denenir.

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
}

Platformda henüz bulunmayan bir robot tipi için destek talep eder.

Genel platform istatistiklerini döndürür.