Communication Identity - Create

Référence

Service:: Communication

Version d'API:: 2023-10-01

Créez une identité et éventuellement un jeton d’accès.

POST {endpoint}/identities?api-version=2023-10-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string	La ressource de communication, par exemple https://my-resource.communication.azure.com
api-version	query	True	string	Version de l’API à appeler.

Corps de la demande

Nom	Type	Description
createTokenWithScopes	CommunicationIdentityTokenScope[]	Créez également un jeton d’accès pour l’identité créée.
expiresInMinutes	integer	Période de validité personnalisée facultative du jeton dans la plage [60 1440] minutes. Si elle n’est pas fournie, la valeur par défaut de 1 440 minutes (24 heures) est utilisée.

Réponses

Nom	Type	Description
201 Created	CommunicationIdentityAccessTokenResult	Créé : retourne l’identité créée.
Other Status Codes	CommunicationErrorResponse	Erreur

Exemples

Create an Identity and optionally an access token with custom expiration time within the [60-1440] minutes range. If expiration time is not specified, the default value of 1440 minutes (24 hours) will be used.

Exemple de requête

HTTP

POST https://my-resource.communication.azure.com/identities?api-version=2023-10-01

{
  "createTokenWithScopes": [
    "chat",
    "voip",
    "chat.join",
    "chat.join.limited",
    "voip.join"
  ],
  "expiresInMinutes": 60
}

Exemple de réponse

Code d’état:: 201

{
  "identity": {
    "id": "8:acs:2dee53b4-368b-45b4-ab52-8493fb117652_00000005-14a2-493b-8a72-5a3a0d000081"
  },
  "accessToken": {
    "token": "token",
    "expiresOn": "2023-10-10T21:39:39.3244584+00:00"
  }
}

Définitions

Nom	Description
CommunicationError	Erreur Communication Services.
CommunicationErrorResponse	Erreur Communication Services.
CommunicationIdentity	Une identité de communication.
CommunicationIdentityAccessToken	Un jeton d’accès.
CommunicationIdentityAccessTokenResult	Identité de communication avec jeton d’accès.
CommunicationIdentityCreateRequest
CommunicationIdentityTokenScope	Liste des étendues d’un jeton d’accès.

CommunicationError

Erreur Communication Services.

Nom	Type	Description
code	string	Code d'erreur.
details	CommunicationError[]	Plus d’informations sur les erreurs spécifiques qui ont conduit à cette erreur.
innererror	CommunicationError	Erreur interne le cas échéant.
message	string	Message d’erreur.
target	string	Cible d’erreur.

CommunicationErrorResponse

Erreur Communication Services.

Nom	Type	Description
error	CommunicationError	Erreur Communication Services.

CommunicationIdentity

Une identité de communication.

Nom	Type	Description
id	string	Identificateur de l’identité.

CommunicationIdentityAccessToken

Un jeton d’accès.

Nom	Type	Description
expiresOn	string	Délai d’expiration du jeton.
token	string	Jeton d’accès émis pour l’identité.

CommunicationIdentityAccessTokenResult

Identité de communication avec jeton d’accès.

Nom	Type	Description
accessToken	CommunicationIdentityAccessToken	Un jeton d’accès.
identity	CommunicationIdentity	Une identité de communication.

CommunicationIdentityCreateRequest

Nom	Type	Valeur par défaut	Description
createTokenWithScopes	CommunicationIdentityTokenScope[]		Créez également un jeton d’accès pour l’identité créée.
expiresInMinutes	integer	1440	Période de validité personnalisée facultative du jeton dans la plage [60 1440] minutes. Si elle n’est pas fournie, la valeur par défaut de 1 440 minutes (24 heures) est utilisée.

CommunicationIdentityTokenScope

Liste des étendues d’un jeton d’accès.

Nom	Type	Description
chat	string	Utilisez cette option pour un accès complet aux API de conversation.
chat.join	string	Accès aux API de conversation, mais sans l’autorisation de créer, de supprimer ou de mettre à jour des threads de conversation.
chat.join.limited	string	Version plus limitée de chat.join qui ne permet pas d’ajouter ou de supprimer des participants. Utilisez cette étendue lorsque le porteur de jeton n’est pas entièrement approuvé, par exemple dans les scénarios invités.
voip	string	Utilisez-le pour un accès complet aux API d’appel.
voip.join	string	Accès aux API d’appel, mais sans l’autorisation de démarrer de nouveaux appels.

Partager via