Supprimer l’appel
Espace de noms: microsoft.graph
Supprimer ou raccrocher un appel actif. Pour les appels de groupe, cela supprimera uniquement votre étape d’appel et l’appel de groupe sous-jacent continuera.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | Non prise en charge. | Non prise en charge. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | Calls.Initiate.All | Calls.AccessMedia.All |
Note: Les autorisations sont vérifiées lors de la création de l’appel ; aucune autorisation supplémentaire case activée n’est effectuée lors de l’appel de cette API. Calls.AccessMedia.All est nécessaire uniquement pour les appels qui utilisent un média hébergé par l’application.
DELETE /communications/calls/{id}
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
N’indiquez pas le corps de la demande pour cette méthode.
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content
. Il ne retourne rien dans le corps de la réponse.
L’exemple suivant illustre la demande.
DELETE https://graph.microsoft.com/v1.0/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 204 No Content
POST https://bot.contoso.com/api/calls
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.commsNotifications",
"value": [
{
"@odata.type": "#microsoft.graph.commsNotification",
"changeType": "updated",
"resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
"resourceData": {
"@odata.type": "#microsoft.graph.call",
"state": "terminating"
}
}
]
}
POST https://bot.contoso.com/api/calls
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.commsNotifications",
"value": [
{
"@odata.type": "#microsoft.graph.commsNotification",
"changeType": "deleted",
"resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
"resourceData": {
"@odata.type": "#microsoft.graph.call",
"state": "terminated",
"resultInfo": {
"@odata.type": "#microsoft.graph.resultInfo",
"code": "200",
"subcode": "5001",
"message": "The conversation has ended."
}
}
}
]
}
Il s’agit de quelques-uns des codes d’erreur courants reçus via une notification lorsque l’appel est terminé.
Code | Sous-code | Motif de l’arrêt |
---|---|---|
200 | 4097 | Appel terminé par l’autre participant à l’appel. |
200 | 4521 | Appel terminé par l’autre participant dans l’appel d’égal à égal. |
200 | 5000 | Supprimé de la conversation par un autre participant. |
200 | 5001 | La conversation est terminée. |
200 | 5002 | La conversation s’est terminée, car tous les autres participants ont quitté l’appel. |
200 | 5003 | La conversation est terminée. |
200 | 5007 | La conversation s’est terminée lorsque l’initiateur de l’appel de groupe a quitté la conversation. |
200 | 5010 | La conversation s’est terminée car un seul participant restait dans la conversation. |
200 | 5012 | La conversation s’est terminée car il n’y a aucun participant dans la liste entrante. |
200 | 5013 | La conversation s’est terminée car personne d’autre n’a rejoint l’appel de groupe. |
200 | 5014 | La conversation s’est terminée, car nous n’avons pas pu déterminer un hôte potentiel pour l’appel de groupe. |
200 | 5020 | La conversation s’est terminée, car il n’y a pas de participants non masqués dans la liste entrante. |
200 | 5030 | La conversation s’est terminée à mesure que la durée de la salle pour petit groupe s’est écoulée. |
200 | 5300 | Le participant a été supprimé de la conversation par un autre participant. |
200 | 5855 | Le participant qui attendait dans la salle d’attente a été retiré de la conversation après l’expiration du délai d’inactivité de la salle d’attente. |
200 | 7000 | La conversation s’est terminée par bot. |
200 | 7015 | L’appel s’est terminé car le transfert s’est terminé avec succès. |
200 | 10550 | La conversation s’est terminée par bot. |
200 | 18503 | L’autre participant à l’appel d’égal à égal a quitté la conversation. |
200 | 540000/560000 | Appel terminé par l’utilisateur RTC. |
408 | 8537 | Délai d’expiration Keep Alive, appel inactif nettoyé. |
408 | 1106 | Aucun accusé de réception n’a été reçu pour l’acceptation de l’appel dans le délai imparti. |
408 | 10057 | L’appel a expiré en raison de l’absence de signalisation à partir des points de terminaison appelés. |
410 | 301005 | Échec de connectivité du média. |
480 | 10037 | Aucun point de terminaison appelé n’a été trouvé. |
480 | 10076 | Impossible d’atteindre l’appelé. |
480 | 10134 | Appel rejeté en raison de l’impossibilité d’acheminer l’appel. |
480 | 10199 | L’appel rejeté en tant qu’appel privé est désactivé pour l’utilisateur. |
500 | 1005 | Le serveur a rencontré une erreur de connectivité avec le média du bot. Vérifiez la connectivité multimédia entre Bot et Microsoft. |