Dispozitive
Dispozitivele legate de contul tău, tokenurile lor de push și inbox-ul de dispatch agregat.
Nu există un apel explicit de înregistrare: un dispozitiv e creat prima dată când UUID-ul său x-codai-device apare pe o cerere de sesiuni. Aceste endpoint-uri administrează ce există și lasă un dispozitiv să tragă tot ce e pus în coadă pentru el într-un singur apel.
Autorizare
bearerAuth O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de /v1/realtime.
În: header
Parametri header
Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.
length <= 128Corpul răspunsului
application/json
application/json
application/json
curl -X GET "https://example.com/v1/devices"{ "devices": [ { "id": "2b6d8c1e-4f3a-4e9b-9c0d-7a1e5f6b8c2d", "name": "Pixel 9 Pro", "platform": "android", "capabilities": [ "terminal", "fs", "voice" ], "has_push_token": true, "lastSeenAt": "2026-09-23T08:41:12.000Z", "createdAt": "2026-09-01T10:00:00.000Z" } ]}Autorizare
bearerAuth O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de /v1/realtime.
În: header
Parametri de cale
UUID-ul dispozitivului (valoarea pe care o trimiți ca x-codai-device).
uuidParametri header
Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.
length <= 128Corpul cererii
application/json
Definiții TypeScript
Folosește tipul request body în TypeScript.
Cel puțin unul dintre cele două câmpuri este obligatoriu.
Corpul răspunsului
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/devices/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "platform": "android", "capabilities": [ "string" ], "has_push_token": true, "lastSeenAt": "2019-08-24T14:15:22Z"}Autorizare
bearerAuth O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de /v1/realtime.
În: header
Parametri de cale
UUID-ul dispozitivului.
uuidParametri header
Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.
length <= 128Corpul răspunsului
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/devices/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "deleted": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"}Autorizare
bearerAuth O cheie API codai (prefix codai_). Tokenurile efemere de la POST /v1/tokens sunt acceptate doar de /v1/realtime.
În: header
Parametri query
Număr maxim total de controale întoarse. Implicit 200, maxim 500.
0 <= value <= 500200Parametri header
UUID stabil al dispozitivului. Înregistrează dispozitivul la prima folosire (nume/platformă din x-codai-device-name / x-codai-device-platform) și selectează protocolul de sesiuni partajate.
uuidNume lizibil al dispozitivului, folosit la prima înregistrare (trunchiat la 120 de caractere).
length <= 120Platforma înregistrată la prima folosire; valorile necunoscute devin agent.
Valoare în
- "android"
- "ios"
- "web"
- "desktop"
- "cli"
- "agent"
Id de corelare ales de client; e returnat ca x-codai-trace-id și persistat pe rândul de usage.
length <= 128Corpul răspunsului
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/devices/me/dispatch" \ -H "x-codai-device: 497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "device_id": "3bafab7b-4400-4bcf-8e6e-09f954699940", "sessions": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "session_key": "string", "title": "string", "controls": [ { "id": "string", "kind": "send", "text": "string", "turn_id": "string", "ask_id": "string", "from_device_id": "10624cda-85b4-412c-80da-8ce165bfd5b0", "target_device_id": "12785743-1d27-41cd-88a7-0ac66360e3d6", "seq": 0, "applied": true, "created_at": "2019-08-24T14:15:22Z" } ] } ]}