ONIOKODeveloper
Perception

Read the latest perception for an active, consented session.

In preparationNot released yet

This operation exists in the platform layer and is verified in CI, but it is not live for partners. The contract can still change before release. Do not build against it yet.

GET
/v1/sessions/{session_id}/perception

Contains pseudonymous personal data. A consent and session check occurs before and after reading.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

session_id*Session Id
Formatuuid

Query Parameters

speaker_name?string|null

Response Body

Successful response

application/json
  1. response
session_id*Session Id
Formatuuid
speaker_name*Speaker Name
perception*Perception
timestamp*Timestamp
Example Request
curl -X GET 'https://example.com/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/perception'
Example Response
{  "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",  "speaker_name": "string",  "perception": "string",  "timestamp": 0}

Start a session for a subject with active perception consent. POST

Contains pseudonymous personal data. A repeated start with the same key returns the original result; an uncertain start is never repeated automatically.