Un serveur tiers utilise la clé API principale pour échanger contre un ticket à courte durée de vie et à usage unique, puis le délivre en toute sécurité au client. Ce point de terminaison valide uniquement la propriété du World, son statut et son quota ; il ne crée pas de Travel.
Scope
Un serveur tiers utilise la clé API principale pour échanger contre un ticket à courte durée de vie et à usage unique, puis le délivre en toute sécurité au client. Avant d'appeler, confirmez les points suivants :
-
Authentification : Seule la clé API principale est prise en charge ; les clés API temporaires ne peuvent pas être utilisées (code d'erreur
403003).- Obtenir la clé API principale : Obtenir et configurer une clé API.
-
Prérequis : Le World doit appartenir au compte principal actuel et au modèle Acting, et son statut doit être
ready. Confirmez via Interroger l'état de construction du World. -
Appelant : Appelé par votre serveur ; le
ticketrésultant ne doit être délivré qu'à un client sur le point d'entrer immédiatement dans la salle.
Requête HTTP
- Singapore
- États-Unis (Virginie)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/worlds/get-travel-credentialRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.Paramètres de la requête |
|
Content-Typestring(Requis)Type de contenu de la requête. Ce paramètre doit être défini sur application/json. | |
Authorization string (Requis)Authentification par clé API. Seule la clé API principale est prise en charge ; elle commence par sk-, par ex. sk-xxx. Elle est généralement configurée comme variable d'environnement $DASHSCOPE_API_KEY. Une clé API temporaire (commençant par st-) renvoie 403003. | |
Corps de la requête | |
encryptedWorldId string (Requis)Un ID de World Acting sous le compte principal actuel avec le statut ready. Retourné par Créer un World. |
Paramètres de réponse |
|
code integerCode de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur. | |
message stringMessage d'erreur. null en cas de succès. | |
data objectDonnées de réponse. null en cas d'échec.
Propriétés ticket stringUn identifiant de Travel à usage unique préfixé par tk_. Valable pendant 1800 secondes (30 minutes) et utilisable avec succès une seule fois.expiresIn integerValidité en secondes, fixée à 1800 (30 minutes).encryptedWorldId stringL'ID de World chiffré auquel correspond l'identifiant. |
États préalables et notes d'appel
- Le World doit appartenir au compte principal actuel et au modèle Acting, et son statut doit être
ready. - Le
ticketest valide pendant 1800 secondes et ne peut être utilisé avec succès qu'une seule fois ; obtenez-en un nouveau après son expiration ou son utilisation. - Le
ticketne doit être délivré qu'à un client sur le point d'entrer immédiatement dans la salle, et ne doit pas être conservé comme identifiant d'accès à long terme. - L'appel de ce point de terminaison ne crée pas de Travel ; le Travel est créé lorsque l'entrée dans la salle réussit.
- Le contrôle de la fonctionnalité Acting prend principalement effet lors de la création et de l'entrée en salle ; l'échange d'identifiants valide toujours le quota correspondant du World, et
403007est retourné lorsque le quota n'a pas été activé.
Codes d'erreur
Si l'appel du modèle échoue et renvoie une erreur, consultez Codes d'erreur HappyOyster pour la résoudre.
Étapes suivantes
Après avoir obtenu le ticket :
- Entrer dans le Travel : le client utilise le
ticketpour créer un Travel et obtenir la configuration RTC.