Αναφορά API

Επιστρέφει το προφίλ του αυθεντικοποιημένου χρήστη.

Ενημερώνει πεδία προφίλ όπως το εμφανιζόμενο όνομα και τις προτιμήσεις ειδοποιήσεων.

Συγχρονίζει τον χρήστη auth του Supabase με την εγγραφή χρήστη της πλατφόρμας.

Αναφέρει αν ο αυθεντικοποιημένος χρήστης έχει ολοκληρώσει το onboarding.

Ανεβάζει μια νέα εικόνα avatar για τον αυθεντικοποιημένο χρήστη.

Αναγράφει τα ρομπότ που έχει καταχωρίσει ο αυθεντικοποιημένος πελάτης, νεότερα πρώτα, έως 50 εγγραφές. Οι χρονοσφραγίδες είναι ISO 8601· τα last_online και last_heartbeat είναι null μέχρι το ρομπότ να έχει συνδεθεί μία φορά.

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

Καταχωρίζει ένα νέο ρομπότ και επιστρέφει το id του. Ένα hardware id πλακέτας κινητήρα μπορεί να ανήκει σε ένα μόνο ρομπότ· μια σύγκρουση απορρίπτεται με κατάσταση 409.

Επιστρέφει το προφίλ πελάτη του αυθεντικοποιημένου χρήστη.

Ενημερώνει πεδία προφίλ πελάτη.

Αναγράφει τα cloud datasets του πελάτη με πλήθος επεισοδίων και μεγέθη.

Αναγράφει τα μηνιαία τιμολόγια του πελάτη.

Επιστρέφει στατιστικά χρήσης για τον πίνακα ελέγχου πελάτη.

Επιστρέφει το προφίλ χειριστή του αυθεντικοποιημένου χρήστη.

Δημιουργεί ή ενημερώνει το προφίλ χειριστή.

Αναγράφει ρομπότ που είναι επί του παρόντος διαθέσιμα και ταιριάζουν με τις πιστοποιήσεις του χειριστή.

Αναγράφει τα αιτήματα πιστοποίησης του χειριστή και την κατάστασή τους.

Αιτείται πιστοποίηση για έναν τύπο ρομπότ.

Επιστρέφει το εβδομαδιαίο πρόγραμμα διαθεσιμότητας του χειριστή.

Ενημερώνει το εβδομαδιαίο πρόγραμμα διαθεσιμότητας.

Επιστρέφει την τρέχουσα διαθεσιμότητα του χειριστή.

Επιστρέφει στατιστικά εσόδων και συνεδριών για τον πίνακα ελέγχου χειριστή.

Αναγράφει συνεδρίες για τον αυθεντικοποιημένο χρήστη. Οι χειριστές βλέπουν συνεδρίες που χειρίστηκαν· οι πελάτες βλέπουν συνεδρίες στα ρομπότ τους. Το σύνολο πεδίων διαφέρει ελαφρώς μεταξύ των δύο προβολών: η προβολή πελάτη περιλαμβάνει episodes_collected και data_collected_mb, η προβολή χειριστή περιλαμβάνει 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."
    }
  ]
}

Ξεκινά μια συνεδρία τηλεχειρισμού σε ένα διαθέσιμο ρομπότ. Απαιτεί τον ρόλο χειριστή: οι πελάτες δεν μπορούν να ξεκινήσουν συνεδρίες. Ένας χειριστής μπορεί να κρατά το πολύ μία ACTIVE ή PAUSED συνεδρία τη φορά, και το ρομπότ πρέπει επί του παρόντος να έχει κατάσταση AVAILABLE. Σε άμεση εκκίνηση το ρομπότ μεταβαίνει σε IN_SESSION και ο πελάτης ειδοποιείται.

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

Επιστρέφει μια μεμονωμένη συνεδρία με τις λεπτομέρειές της.

Ενημερώνει τον κύκλο ζωής της συνεδρίας: παύση, συνέχιση, τερματισμό, και σχετικές ενέργειες.

Αιτείται παράταση συνεδρίας. Μόνο ο πελάτης που κατέχει τη συνεδρία μπορεί να το καλέσει, και η συνεδρία πρέπει να είναι ACTIVE. Το αίτημα καταγράφεται ως γεγονός συνεδρίας και ο χειριστής λαμβάνει ειδοποίηση· η ίδια η παράταση συμβαίνει όταν ο χειριστής ενεργήσει πάνω σε αυτήν.

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

Αναγράφει τα μηνύματα chat μιας συνεδρίας.

Στέλνει ένα μήνυμα chat σε μια συνεδρία.

Αξιολογεί μια ολοκληρωμένη συνεδρία σε κλίμακα 1 έως 5 αστέρων, με προαιρετικό σχόλιο.

Εξάγει δεδομένα συνεδρίας.

Δημιουργεί ή επιστρέφει τον πελάτη Stripe που χρησιμοποιείται για τη χρέωση πελάτη.

Επιστρέφει την κατάσταση του λογαριασμού Stripe Connect του χειριστή.

Ξεκινά το onboarding Stripe Connect για πληρωμές χειριστή.

Δημιουργεί ένα Stripe SetupIntent για την αποθήκευση ενός τρόπου πληρωμής.

Δημιουργεί μια συνεδρία πύλης χρέωσης Stripe για τη διαχείριση τρόπων πληρωμής και τιμολογίων.

Επιστρέφει πληροφορίες πληρωμής για τον αυθεντικοποιημένο χειριστή.

Αιτείται μια πληρωμή συσσωρευμένων εσόδων. Η ελάχιστη πληρωμή είναι 10,00 EUR.

Λαμβάνει γεγονότα webhook του Stripe. Καλείται από το Stripe, όχι από API clients.

Έλεγχος υγείας για το API και τη σύνδεσή του με τη βάση δεδομένων. Επιστρέφει 200 όταν και τα δύο είναι εντάξει· αν ο έλεγχος βάσης δεδομένων αποτύχει, επιστρέφεται η ίδια μορφή με τα status και db ρυθμισμένα σε error και κατάσταση HTTP 503.

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

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

Επιστρέφει δημόσιες πληροφορίες για ένα υποστηριζόμενο μοντέλο ρομπότ.

Επιστρέφει τα τρέχοντα δημόσια πλάνα τιμολόγησης.

Υποβάλλει ένα μήνυμα φόρμας επικοινωνίας. Το μήνυμα αποθηκεύεται πρώτα και έπειτα παραδίδεται μέσω email, οπότε μια προσωρινή διακοπή mail δεν το χάνει: σε αυτή την περίπτωση η απόκριση αναφέρει stored true και delivered false, και η παράδοση επαναλαμβάνεται λειτουργικά.

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
}

Αιτείται υποστήριξη για έναν τύπο ρομπότ που δεν βρίσκεται ακόμα στην πλατφόρμα.

Επιστρέφει δημόσια στατιστικά πλατφόρμας.