API REST pour l'extraction de la version BigFix Inventory

Utilisez l'opération GET sur l'élément api/sam/about pour demander des informations sur la version de BigFix Inventory.

Pour extraire des informations sur la version actuelle de BigFix Inventory, utilisez l'URL suivante :

https://hostname:port/api/sam/about?token=token

Important :

Pour utiliser cette API, vous devez être affecté au groupe Tous les ordinateurs et disposer du droit Afficher l'inventaire matériel.
Chaque demande d'API doit être authentifiée avec le paramètre token. Vous pouvez l'extraire en utilisant l'API REST pour l'extraction du jeton d'authentification. Vous pouvez également vous connecter à BigFix Inventory, survoler l'icône Utilisateur et cliquer sur Profil. Cliquez ensuite sur Afficher le jeton.
Par défaut, les données extraites sont triées par id.

Tableau 1. Descriptions des opérations
Détails de l'opération	Description
Fonctionnement	`GET /api/sam/about`
Finalité	Renvoie la version de BigFix Inventory
Méthode HTTP	`GET`
URI de resources	https://`server_host_name`:`port_number`/api/sam/about
Relation du lien de l'URL	n/a
Paramètres de requête URI	n/a
En-têtes de demande	Fonction métier `Accept-Language` (Facultatif) Valeurs en-US (seul l'anglais est pris en charge) Sert à négocier la langue de la réponse. Si cet en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la demande	Non disponible
Demande `Content-Type`	`application/json`
En-têtes de réponse	En-tête `Content-Type` Valeurs `application/json` Définit le type de contenu de la réponse.
En-têtes de réponse	En-tête `Content-Language` Valeurs en-US, … Définit la langue du contenu de la réponse. Si cet en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la réponse	`About` élément
Réponse`Content-Type`	`application/json`
Codes de réponse normaux HTTP	`200 – OK`
Codes de réponse HTTP d'erreur	`500 – “Bad Request”` si un paramètre de requête contient des erreurs ou est manquant Le corps du message comprend un message d'erreur détaillé.

Exemple de conversation HTTP

Demande

GET api/sam/about
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US

En-tête de réponse

HTTP/1.1 200 OK
Content-Type: application/json
Content-Language: en-US

Corps de réponse (JSON)

{
"product": "BigFix Inventory",
"version": "9.2.20140331-2015"
}