REST API - Attacher un document à un ticket


POST  /requests/{rfc_number}/documents

  • Les fichiers peuvent être au format .pdf, .docx, .jpg, .svg, .pptx, .txt, .png, etc.
  • Plusieurs fichiers peuvent être attachés simultanément.

Remarques

   Open url.png  voir Conventions de l'API REST Product name - ev itsm.png

  • En cas de succès, un code de statut HTTP 201 est retourné et un lien URL (HREF) vers la ressource créée est fourni.
  • Vous devez passer le contenu des fichiers dans un objet de type form-data (Key = documents) du corps de la requête HTTP. Pour cela, vous devez utiliser une fonctionnalité de votre application ou un outil/développement tiers permettant de :
    • télécharger et attacher les fichiers souhaités ;
    • encoder les fichiers en Base64.

Liste des paramètres / objets

Paramètres obligatoires

Dans l'URL, vous devez utiliser le paramètre ci-dessous.
 

Paramètre Type Description / Exemple
rfc_number string Identifiant du ticket

Paramètres optionnels

Dans le corps de la requête HTTP, vous pouvez utiliser les objets JSON détaillés ci-dessous.

Objet Type Description / Exemple
description string Description du document
documents file Contenu des documents joints encodés en Base64. Note : Ce paramètre comprend 2 variables : filedata et filename - Open url.png voir Exemple

Description des actions effectuées

1. Les documents sont téléchargés.

  • Titre du document = Nom du fichier

2. Ils sont attachés au ticket et deviennent accessibles via l'onglet Documents de la fiche du ticket.

Codes de statut HTTP de la méthode

StatusHeader
Code Erreur Description
Status201
201 Created (Créé) Requête traitée avec succès et création d’un élément.
Status401
401 Unauthorized (Non autorisé) Processus d'authentification pour accéder à la ressource incorrect : Login/Mot de passe incorrect, Session non valide, Compte $ProductName_ev_itsm incorrect.

$Example_documentation_icon

{
 "error": "Invalid Login / Password"
}
Status403
403 Forbidden (Interdit) Refus d'exécution de la requête par le serveur. À la différence de l'erreur 401, l'authentification est acceptée, mais les droits ne permettent pas au client d'accéder à la ressource : Utilisateur n’ayant pas le paramètre REST API activé dans son profil.

Exemples

Exemple de corps de requête HTTP

{
 "documents": [{
   "filedata": "SmUgc3VpcyB1biBkb2N1bWVudA==",
   "filename": "document.docx"
    }]
}

Résultat avec un code de statut retourné 201

{
 "HREF": "https://{your_server}/api/v1/{your_account}/requests/I161026_000005"
}


ConventionsAPI

Conventions de l'API REST

Convention Signification
Orange Paramètres utilisés dans la chaîne d’une requête HTTP et qui ne correspondent pas à des champs de la base $ProductName_ev_itsm.

$Example_documentation_icon   Méthode Voir une liste de biens


https://{your_server}/api/v1/{your_account}/assets?max_rows=3&fields=asset_tag

Noir et Gras Paramètres utilisés dans l’URL d’une requête HTTP et qui correspondent à des champs de la base $ProductName_ev_itsm.

$Example_documentation_icon   Méthode Voir un bien


https://{your_server}/api/v1/{your_account}/assets/{asset_id}

Vert Paramètres utilisés dans le corps d’une requête HTTP et qui représentent des noms d’objets JSON correspondant à des champs de la base $ProductName_ev_itsm ; ils permettent d’affecter ou de modifier une valeur de champ dans la base.

$Example_documentation_icon   Méthode Terminer un ticket

{  "closed": {  "end_date": "11/20/2016 12:12:12",  }  }
Paramètres utilisés dans le corps d’une requête HTTP et qui représentent des noms d’objets JSON ne correspondant pas à des champs de la base $ProductName_ev_itsm.

$Example_documentation_icon   Méthode Reprendre un ticket

{  "restarted": {  "comment": "string (required)"  }  }

Tags:
Modifié par Utilisateur inconnu le 2019/12/03 11:19
Créé par Administrator XWiki le 2017/04/21 12:18

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020