REST API - Voir une marque


GET  /manufacturers/{manufacturer_id}

  • Cette méthode permet d’obtenir des informations concernant une marque déterminée.
           exemple    /manufacturers/109

Remarques

     Open url.png  voir Conventions de l'API REST Service Manager

  • En cas de succès, un code de statut HTTP 200 est retourné.
    • Un lien URL (HREF) vers la ressource est fourni.
    • Tous les champs sont fournis, y compris ceux de type e_field_name et available_field_x, à l’exception de certains champs sensibles réservés à EasyVista.
       

Liste des paramètres / champs

Paramètres obligatoires

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

Paramètre Type Description / Exemple
manufacturer_id integer Identifiant de la marque

Paramètres optionnels

Dans la chaîne de requête HTTP, vous pouvez utiliser les paramètres détaillés ci-dessous.

Version minimum Paramètre Type Description / Exemple
fields string Sélection de champs à afficher
  • exemple /manufacturers/109?fields=discovery_name,manufacturer

Champs pouvant être utilisés pour les paramètres optionnels

Vous pouvez utiliser tous les champs de la table AM_MANUFACTURER.

Codes de statut HTTP de la méthode

StatusHeader
Code Erreur Description
Status200
200 OK (Succès) Requête traitée avec succès.
Status401
401 Unauthorized (Non autorisé) Processus d'authentification pour accéder à la ressource incorrect : Login/Mot de passe incorrect, Session non valide, Compte Service Manager incorrect.

exemple

{
 "error": "Invalid Login / Password"
}
Status404
404 Not found (Non trouvée) Ressource non trouvée : URI incorrecte, Ressource inexistante, Communication avec le serveur incorrecte, rfc_number non trouvé.

exemple

{
 "error": "Resource not found"
}

Exemple

Résultat avec un code de statut retourné 200

{
 "HREF": "http://{your_server}/api/v1/{your_account}/manufacturers/109",
 "DISCOVERY_NAME": "",
 "IS_MANUFACTURER": "1",
 "IS_PUBLISHER": "1",
 "MANUFACTURER": "Dell Computer",
 "MANUFACTURER_ID": "109",
 "WEB_SITE": ""
}


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 Service Manager.

exemple   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 Service Manager.

exemple   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 Service Manager ; ils permettent d’affecter ou de modifier une valeur de champ dans la base.

exemple   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 Service Manager.

exemple   Méthode Reprendre un ticket

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

Tags:
Modifié par Utilisateur inconnu le 2020/07/17 19:53
Créé par Administrator XWiki le 2017/12/21 08:49

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Powered by XWiki ©, EasyVista 2021