REST API - Voir un bien

Modifié le 08/11/2022 13:22

GET  /assets/{asset_id}

  • Cette méthode permet d’obtenir des informations concernant un bien déterminé (un bien englobe un matériel, licence et contrat).
           exemple    /assets/9479

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
asset_id integer Identifiant du bien

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 /assets/9479?fields=asset_guid,asset_id
Oxygène 1.7 - Build 2018.1.131.0 formatDate string Formater l’affichage des champs de type Date dans le résultat de la requête HTTP   -   Open url.png voir Description des options de formatage
  • exemple
    • /assets/9479?fields=last_update&formatDate=l/M/Y ==> "last_update_format": "Friday/Nov/2018"
    • /assets/9479?fields=last_update&formatDate=l jS \of F Y h:i:s A ==> "last_update_format": "Friday 16th of November 2018 12:00:00 AM"

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

Vous pouvez utiliser tous les champs de la table AM_ASSET.

Codes de statut HTTP de la méthode

StatusHeader

   Un code erreur Timeout est renvoyé et la méthode échoue si le serveur ne répond pas à la requête du web service REST au bout d'un certain temps (par défaut, 60 secondes).

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}/assets/9479",
   "ACQUISITION_TYPE_ID": "",
   "ASSET_GUID": "{2D744435-3FC5-4E16-B2FF-B432EB87A829}",
   "ASSET_ID": "50312",
   "ASSET_LABEL": "New asset via REST API - Updated",
   "ASSET_TAG": "a99f7fc1-4080-402b-b85d-2c484c6108c7",
   "AUTOMATIC_RENEWAL": "",
   "AVAILABILITY_SLA_ID": "",
   "AVAILABLE_FIELD_1": "Available for custom use - Updated",
   "AVAILABLE_FIELD_2": "",
   "AVAILABLE_FIELD_3": "",
   "AVAILABLE_FIELD_4": "",
   "AVAILABLE_FIELD_5": "",
   "AVAILABLE_FIELD_6": "",
   "BEFORE_LOAN_DEPARTMENT_PATH": "",
   "BEFORE_LOAN_DEPARTMENT_ID": "",
   "BEFORE_LOAN_EMPLOYEE_ID": "",
   "BEFORE_LOAN_LOCATION_PATH": "",
   "BEFORE_LOAN_LOCATION_ID": "",
   "BILLING_PERIODICITY_IN_MONTH": "",
   "BUDGET_ID": "",
   "BUY_BACK_VALUE": "",
   "BUY_BACK_VALUE_CUR_ID": "",
   "CATALOG_ID": "3544",
   "CHARGE_BACK": "",
   "CHARGE_BACK_CUR_ID": "",
   "CI_BACKUP_BY_DEFAULT": "",
   "CI_STATUS_ID": "",
   "CI_VERSION": "",
   "CM_DEFAULT_CHANGE_PATH": "",
   "CM_DEFAULT_CHANGE_ID": "",

   "COMMENT_ASSET": {
       http://{your_server}/api/v1/{your_account}/
    },
   "CONFIGURATION_ID": "",
   "CONTRACT_TYPE_ID": "",
   "CRITICAL_LEVEL_ID": "",
   "D_HARDWARE_GUID": "",
   "DELIVERY_DATE": "",
   "DELIVERY_NUMBER": "",
   "DEPARTMENT_PATH": "",
   "DEPARTMENT_ID": "5",
   "DEPRECIATION_RULE_ID": "",
   "EMPLOYEE_ID": "",
   "END_OF_WARANTY": "",
   "ENTRY_DATE": "",
   "ESTIMATED_PERCENTAGE_USE": "",
   "EXPECTED_END_LEND_DATE": "",
   "EXPECTED_RETURN_DATE": "",
   "FALLEN_TERM": "",
   "FIXED_ASSET_NUMBER": " -",
   "INITIAL_START": "",
   "INSTALLATION_DATE": "",
   "INTERNAL_DELIVERY_DATE": "",
   "INTERNAL_DISPO": "",
   "INVENTORY_ID": "",
   "INVOICE_NUMBER": "",
   "IS_CI": "0",
   "IS_DML": "0",
   "IS_LOCKED": "0",
   "IS_SERVICE": "0",
   "LAST_AUTOMATIC_DISCOVERY": "",
   "LAST_INTEGRATION": "",
   "LAST_PAYMENT": "",
   "LAST_PAYMENT_CUR_ID": "",
   "LAST_PHYSICAL_INVENTORY": "",
   "LAST_UPDATE": "2018-07-03",
   "LICENSE_VERSION": "",
   "LOCATION_PATH": "Europe/France",
   "LOCATION_ID": "63",
   "LOCATION_TO_CHECK_REQUEST_ID": "",
   "MAIN_USAGE_ID": "",
   "MAINTENANCE_COST": "",
   "MAINTENANCE_COST_CUR_ID": "",
   "MAX_INSTALLS": "",
   "MONTH_DURATION": "",
   "MONTHLY_FIXED_COST": "",
   "MONTHLY_FIXED_COST_CUR_ID": "",
   "MONTHLY_NET_RENTAL": "",
   "MONTHLY_NET_RENTAL_CUR_ID": "",
   "NETWORK_IDENTIFIER": " -",
   "NEXT_CI_VERSION": "",
   "NEXT_DEPARTMENT_PATH": "",
   "NEXT_DEPARTMENT_ID": "",
   "NEXT_MAINTENANCE_DATE": "",
   "NEXT_STATUS_ID": "",
   "NEXT_USER_APPLICATION_DATE": "",
   "NEXT_USER_ID": "",
   "NOTICE": "",
   "ORDER_DETAILS_ID": "",
   "ORDER_NUMBER": "",
   "OWNERSHIP_TO_CHECK_REQUEST_ID": "",
   "PACKAGE_PATH": "",
   "PIPELINE_STATUS_ID": "",
   "POWER_CONSUMPTION_WH": "",
   "PROCESSOR_COUNT": "",
   "PROCESSOR_SOCKET_COUNT": "",
   "PROJECT_ID": "",
   "PROVIDER_PATH": "",
   "PROVIDER_ID": "",
   "PURCHASE_DATE": "",
   "PURCHASE_PRICE": "",
   "PURCHASE_PRICE_CUR_ID": "",
   "PURCHASE_RATE_ID": "",
   "RECYCLED_DATE": "",
   "RECYCLING_PROVIDER_PATH": "",
   "RECYCLING_PROVIDER_ID": "",
   "REFORM_NUMBER": "",
   "REMOVED_DATE": "",
   "RENEWAL_DECISION_ID": "",
   "RENEWAL_VALUE": "",
   "RENEWAL_VALUE_CUR_ID": "",
   "REPAIRED_BY_PATH": "",
   "REPAIRED_BY_ID": "",
   "REQUEST_ID": "",
   "RESALES_VALUE": "",
   "SCHEDULED_END": "",
   "SD_CATALOG_PATH": "",
   "SD_CATALOG_ID": "1",
   "SD_DEFAULT_INCIDENT_PATH": "",
   "SD_DEFAULT_INCIDENT_ID": "",
   "SD_DEFAULT_REQUEST_PATH": "",
   "SD_DEFAULT_REQUEST_ID": "",
   "SERIAL_NUMBER": "2 AS- 155- 6 V",
   "SERVER_TYPE_ID": "",
   "SLA_ID": "",
   "STATUS_ID": "4",
   "SUPPLIER_PATH": "",
   "SUPPLIER_ID": "",
   "TERM": "",
   "UPDATE_COVERAGE_TERM": "",
   "UPDATED_BY_DISCOVERY": "0",
   "WARANTY_TYPE_ID": "",
   "XPOS": "",
   "YPOS": "",
   "ZPOS": "",
   "LOCATION": {
       "HREF": "http://{your_server}/api/v1/{your_account}/locations/63",
       "CITY": "",
       "LOCATION_CODE": "",
       "LOCATION_FR": "France",
       "LOCATION_PATH": "Europe/France",
       "LOCATION_ID": "63"
    },
   "DEPARTMENT": {
       "DEPARTMENT_CODE": "",
       "DEPARTMENT_FR": "-",
       "DEPARTMENT_PATH": "",
       "DEPARTMENT_ID": "5",
       "DEPARTMENT_LABEL": ""
    },
   "EMPLOYEE": {
       "BEGIN_OF_CONTRACT": "",
       "CELLULAR_NUMBER": "",
       "DEPARTMENT_PATH": "",
       "E_MAIL": "",
       "EMPLOYEE_ID": "",
       "LAST_NAME": "",
       "LOCATION_PATH": "",
       "PHONE_NUMBER": ""
    },
   "CATALOG_ASSET": {
       "HREF": "http://{your_server}/api/v1/{your_account}/catalog-assets/3544",
       "ARTICLE_MODEL": "PowerEdge 860",
       "CATALOG_ID": "3544",
       "NET_PRICE": "1 660,00",
       "SMBIOS_NAME": "PowerEdge 860",
       "TITLE_FR": ""
    }
}
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 :
Powered by XWiki © EasyVista 2024