Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Description de l’API
Crée un ticket de support.
L’ajout de pièces jointes n’est actuellement pas pris en charge via l’API. Pour ajouter un fichier à un ticket de support existant, visitez la page Demandes de service dans le Centre d’administration Microsoft Intune.
L’affichage et l’ajout de contenu aux discussions ne sont actuellement pas pris en charge via l’API.
Configuration requise
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
| Type d’autorisation | Autorisations |
|---|---|
| Delegated | Non applicable |
| Application | MmdSupport.ReadWrite |
Requête HTTP
POST https://mmdls.microsoft.com/support/odata/v1/tickets
En-têtes de demande
| En-tête | Valeur |
|---|---|
| Autorisation | Porteur {token} (obligatoire) |
| Accepter | application/json |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
| Propriété | Obligatoire | Type | Description |
|---|---|---|---|
| title | Vrai | String | Brève description de la question ou du problème. |
| description | Vrai | String | Description détaillée. |
| type | Vrai | TicketType | Type de ticket. |
| category | Vrai | TicketCategory | Catégorie de ticket. |
| sous-catégorie | Vrai | String | Sous-catégorie de ticket. |
| usersOrDevicesImpacted | Int32 | Nombre d’utilisateurs/appareils concernés. | |
| businessImpact | String | Décrire l’impact sur l’entreprise | |
| issueFirstNoticed | String | Heure à laquelle le problème a été remarqué pour la première fois. | |
| issueReproduced | Boolean | Le problème est reproductible sur un appareil non géré par Microsoft. | |
| endUserSupportEngaged | Boolean | Le support utilisateur final a été engagé. | |
| dépannageÉtapes | String | Description des étapes de correction effectuées. | |
| reproSteps | String | Étapes de reproduction du problème. | |
| Sévérité | Vrai | Niveau de gravité | Gravité du ticket. |
| contact | Vrai | CaseContact | Objet contact case. |
| givenName | Vrai | String | Prénom. |
| surname | Vrai | String | Nom.m |
| Vrai | String | adresse Email. | |
| phoneNumber | Vrai | String | Numéro de téléphone. |
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une liste d’appareils dans le corps de la réponse.
Exemple 1 : Créer un ticket de support pour demander des informations
Créer une demande de ticket de support
Voici un exemple de requête HTTP.
POST https://mmdls.microsoft.com/support/odata/v1/tickets
Voici un exemple de requête JSON.
{
"title": "Title",
"description": "Description of ticket",
"type": "RequestForInformation",
"category": "Devices",
"subcategory": "Hardware",
"severity": 4,
"contact": {
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number"
}
}
Créer une réponse de ticket de support
Voici un exemple de réponse JSON.
{
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity",
"title": "Title",
"description": "Description",
"isPartner": false,
"type": "RequestForInformation",
"category": "Devices",
"subcategory": "Hardware",
"compromiseIndicator": null,
"usersOrDevicesImpacted": null,
"relatedAlerts": null,
"businessImpact": null,
"issueFirstNoticed": null,
"issueReproduced": null,
"endUserSupportEngaged": null,
"troubleshootingSteps": null,
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 4,
"state": "active",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
}
Exemple 2 : Créer un ticket de support pour demander une modification
Demander une modification
Voici un exemple de requête HTTP.
POST https://mmdls.microsoft.com/support/odata/v1/tickets
Voici un exemple de requête JSON.
{
"title": "Title",
"description": "Description of ticket",
"type": "ChangeRequest",
"category": "Devices",
"subcategory": " Deployment groups assignment",
"severity": 4,
"contact": {
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number"
}
}
Demander une réponse de modification
Voici un exemple de réponse JSON.
{
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity",
"title": "Title",
"description": "Description",
"isPartner": false,
"type": "ChangeRequest",
"category": "Devices",
"subcategory": " Deployment groups assignment",
"compromiseIndicator": null,
"usersOrDevicesImpacted": null,
"relatedAlerts": null,
"businessImpact": null,
"issueFirstNoticed": null,
"issueReproduced": null,
"endUserSupportEngaged": null,
"troubleshootingSteps": null,
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 4,
"state": "active",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
}
Exemple 3 : Créer un ticket de support pour un incident
Demande de ticket de support d’incident
Voici un exemple de requête HTTP :
POST https://mmdls.microsoft.com/support/odata/v1/tickets
Voici un exemple de requête JSON :
{
"title": "Title",
"description": "Description of ticket",
"type": "Incident",
"category": "Devices",
"subcategory": "Configuration/Policy",
"usersOrDevicesImpacted": 100,
"businessImpact": "Business Impact",
"issueFirstNoticed": "2021-10-06T07:00:00Z",
"issueReproduced": true,
"endUserSupportEngaged": true,
"troubleshootingSteps": "Describe any troubleshooting steps performed.",
"severity": 4,
"contact": {
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "+1 888"
}
}
Réponse au ticket de support aux incidents
Voici un exemple de réponse JSON.
{
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity",
"title": "Title",
"description": "Description",
"isPartner": true,
"type": "Incident",
"category": "Devices",
"subcategory": "Configuration/Policy",
"compromiseIndicator": null,
"usersOrDevicesImpacted": 100,
"relatedAlerts": null,
"businessImpact": "Business Impact",
"issueFirstNoticed": "2021-10-06T07:00:00Z",
"issueReproduced": true,
"endUserSupportEngaged": true,
"troubleshootingSteps": "Describe any troubleshooting steps performed.",
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 4,
"state": "active",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
}