logoDocumentation
Rechercher

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.
  • file_url : Adresse du fichier.
  • 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.
    icon
    Contactez-nous