Referencia de la API HappyOyster-Acting-Get Travel Credential - Alibaba Cloud Model Studio

Un servidor de terceros utiliza la API Key principal para intercambiarla por un ticket de corta duración y un solo uso, y luego lo entrega de forma segura al cliente. Este endpoint solo valida la propiedad, el estado y la cuota del mundo; no crea un viaje.

Ámbito

Un servidor de terceros utiliza la API Key principal para intercambiarla por un ticket de corta duración y un solo uso, y luego lo entrega de forma segura al cliente. Antes de realizar la llamada, confirme lo siguiente:

Autenticación: Solo se admite la API Key principal; no se pueden utilizar API Keys temporales (código de error 403003).
- Obtenga la API Key principal: Obtener y configurar una API Key.
Prerequisites: El mundo debe pertenecer a la cuenta principal actual y al modelo Acting, y su estado debe ser ready. Confírmelo mediante Query World Build Status.
Caller: Llamado por su servidor; el ticket resultante debe entregarse únicamente a un cliente que esté a punto de entrar en la sala inmediatamente.

Solicitud HTTP

Singapore

POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/get-travel-credential

Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

EE. UU. (Virginia)

POST https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/get-travel-credential

Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

Parámetros de solicitud	Obtener credencial de viaje `curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/get-travel-credential' \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "encryptedWorldId": "{encryptedWorldId}" }'`
Content-Type`string`(Requerido) Tipo de contenido de la solicitud. Este parámetro debe establecerse en `application/json`.
Authorization `string` (Requerido) Autenticación mediante API Key. Solo se admite la API Key principal; comienza con `sk-`, p. ej., `sk-xxx`. Normalmente se configura como la variable de entorno `$DASHSCOPE_API_KEY`. Una API Key temporal (que comienza con `st-`) devuelve `403003`.
Cuerpo de la solicitud
encryptedWorldId `string` (Requerido) Un ID de mundo Acting bajo la cuenta principal actual con estado `ready`. Devuelto por Create World.

Parámetros de respuesta

Intercambio exitoso

{
    "code": 0,
    "message": null,
    "data": {
        "ticket": "tk_a1b2****",
        "expiresIn": 1800,
        "encryptedWorldId": "enc_a1b2****"
    }
}

code integer

Código de retorno. 0 indica éxito; un valor distinto de cero es un código de error.

message string

Mensaje de error. null en caso de éxito.

data object

Datos de respuesta. null en caso de fallo.

Propiedades

ticket string

Una credencial de viaje de un solo uso con el prefijo tk_. Válida por 1800 segundos (30 minutos) y se puede utilizar correctamente solo una vez.

expiresIn integer

Validez en segundos, fija en 1800 (30 minutos).

encryptedWorldId string

El ID de mundo cifrado al que corresponde la credencial.

Estados previos y notas de llamada

El mundo debe pertenecer a la cuenta principal actual y al modelo Acting, y su estado debe ser ready.
El ticket es válido durante 1800 segundos y se puede utilizar correctamente solo una vez; obtenga uno nuevo después de que caduque o haya sido utilizado.
El ticket debe entregarse únicamente a un cliente que esté a punto de entrar en la sala inmediatamente, y no debe conservarse como una credencial de acceso a largo plazo.
Llamar a este endpoint no crea un viaje; el viaje se crea cuando entrar en la sala tiene éxito.
La puerta de enlace de la función Acting surte efecto principalmente en la creación y entrada a la sala; el intercambio de credenciales aún valida la cuota correspondiente del mundo, y se devuelve 403007 cuando la cuota no ha sido habilitada.

Códigos de error

Si la llamada al modelo falla y devuelve un error, consulte Códigos de error de HappyOyster para resolverlo.

Siguientes pasos

Después de obtener el ticket:

Enter Travel: el cliente utiliza el ticket para crear un viaje y obtener la configuración RTC.