Mettre à jour le ticket
Fournit la fonction de modification des informations du ticket.
Méthode de requête
PUT
URL de la requête
https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id
Authentification
Consultez la description de l'authentification dans Présentation de l'API pour plus de détails.
Requête
Exemple de requête
curl -X PUT 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
"title": "Bourrage papier imprimante, impossible d'imprimer (Mis à jour)",
"description": "Le client a signalé un bourrage de papier A4 au niveau du bac de sortie, nécessite une intervention urgente.\nUn technicien a été dépêché.",
"attachments": [
{
"file_url": "https://example.com/files/error-photo.jpg"
}
],
"priority": "moyenne",
"ticket_type": "incident",
"custom_fields": {
"department": "Support informatique",
"device_sn": "PRN-2024-001",
"location": "Siège Pékin - Salle d'impression 3e étage",
"resolution_note": "Remplacement du mécanisme d'alimentation papier"
},
"tags": ["imprimante", "matériel", "résolu"]
}'
curl -X PUT 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
"title": "Bourrage papier imprimante, impossible d'imprimer (Mis à jour)",
"description": "Le client a signalé un bourrage de papier A4 au niveau du bac de sortie, nécessite une intervention urgente.\nUn technicien a été dépêché.",
"attachments": [
{
"file_url": "https://example.com/files/error-photo.jpg"
}
],
"priority": "moyenne",
"ticket_type": "incident",
"custom_fields": {
"department": "Support informatique",
"device_sn": "PRN-2024-001",
"location": "Siège Pékin - Salle d'impression 3e étage",
"resolution_note": "Remplacement du mécanisme d'alimentation papier"
},
"tags": ["imprimante", "matériel", "résolu"]
}'
Afficher ce bloc de code dans la fenêtre flottante
En-têtes de la requête
| Champ | Type | Description |
|---|---|---|
| Authorization | string | Utilisez Authorization: Basic base64(API Key:API Secret) pour l'authentification. Rendez-vous sur la page de clé API pour obtenir la clé API et le secret API, puis reliez-les par un deux-points avant l'encodage Base64. |
| Content-Type | application/json | Type de données, la valeur est application/json. |
Paramètres de chemin
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| ticket_id | String | Oui | ID du ticket. |
Paramètres du corps
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| title | String | Oui | Titre du ticket. |
| description | String | Oui | Description détaillée du ticket (prend en charge Markdown). |
| attachments | Array | Non | Liste des pièces jointes au niveau du ticket. |
| priority | String | Non | Priorité : faible/moyenne/élevée/urgente. Par défaut : moyenne si non précisé. |
| ticket_type | String | Non | Type de ticket : incident/question/problème/tâche. |
| custom_fields | Object | Non | Champs personnalisés (ex : numéro de série de l'appareil, numéro de commande, etc.). |
| tags | Array | Non | Tags du ticket. |
Exemple de réponse
Réponse réussie
{
"code": 0,
"message": "Succès",
"data": {
"ticket_id": "tk_20251104_789abc",
"updated_at": "2025-11-04T10:30:00+08:00"
}
}
{
"code": 0,
"message": "Succès",
"data": {
"ticket_id": "tk_20251104_789abc",
"updated_at": "2025-11-04T10:30:00+08:00"
}
}
Afficher ce bloc de code dans la fenêtre flottante
Paramètres de la réponse
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| ticket_id | String | Non | ID du ticket. |
| updated_at | String | Non | Date de mise à jour. |

