playback-svc

Abrir una sesión de ingesta (SCT ingest + endpoint del daemon)

Abre una sesión de ingesta para un fichero de sizeBytes y devuelve el endpoint de conduit en el daemon y la SCT de scope ingest. 429 si el actor ya tiene abiertas todas las permitidas; 413 si el fichero pasa del tope del nodo. Los bytes van directos al daemon, nunca por aquí. Acceso: Bearer de identity con policy `resource:ingest-session:create`.

POST
/ingest/sessions

Abre una sesión de ingesta para un fichero de sizeBytes y devuelve el endpoint de conduit en el daemon y la SCT de scope ingest. 429 si el actor ya tiene abiertas todas las permitidas; 413 si el fichero pasa del tope del nodo. Los bytes van directos al daemon, nunca por aquí.

Acceso: Bearer de identity con policy resource:ingest-session:create.

Authorization

bearerAuth
AuthorizationBearer <token>

Access token de identity-svc (JWT EdDSA, caducidad corta). Se verifica en local y después contra la sesión viva (revocation-aware).

In: header

Request Body

application/json

Tamaño del fichero a subir; la capability lo fija como tope.

TypeScript Definitions

Use the request body type in TypeScript.

Tamaño del fichero a subir; la capability lo fija como tope.

sizeBytes*integer
Range0 <= value <= 1099511627776

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/ingest/sessions" \  -H "Content-Type: application/json" \  -d '{    "sizeBytes": 0  }'
{  "capability": {    "expiresAt": 0,    "token": "string"  },  "endpoint": "string",  "maxBytes": 0,  "sessionId": "string"}

Liveness del proceso GET

Responde 200 mientras el proceso atiende peticiones; no comprueba dependencias. La usan el HEALTHCHECK de la imagen y el compose (con GET: HEAD es opt-in en Elysia 2).

Abortar una sesión de ingesta propia DELETE

Aborta la sesión y el daemon revoca su capability. Una sesión de otro actor es 404, salvo para admin/owner. Acceso: Bearer de identity con policy `resource:ingest-session:close`.