---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference
Release :
- xanadu
ft:locale :
- fr-FR
ft:publication_title :
- Référence de l’API Xanadu
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# SAM - API d'intégration de données d'utilisation de logiciel
# SAM - API d'intégration de données d'utilisation de logiciel {#ariaid-title1}
* Rversion finale: Xanadu
*
* Mis à jour 1 août 2024
*
*  3 minutes de lecture
L'API d'intégration de données d'utilisation de logiciel SAM fournit des points de terminaison pour créer et mettre à jour des enregistrements dans la table Utilisation de logiciel \[samp_sw_usage\].
Cette API nécessite l'activation du module d'extension Gestion des actifs logiciels Professional (com.snc.samp). Vous devez également disposer du rôle sam_admin ou sam_developer pour accéder au point de terminaison.
## Intégration des données d'utilisation du logiciel SAM : POST /sam_software_usage_integration/createOrUpdate {#ariaid-title2}
Crée ou met à jour un enregistrement spécifié dans la table Utilisation de logiciel \[samp_sw_usage\].
Vous pouvez créer/mettre à jour un ou plusieurs enregistrements d'utilisation de logiciels en un seul appel.
### Format d'URL
URL versionnée : /api/now/{api_version}/sam_software_usage_integration/createOrUpdate
URL par défaut : /api/now/sam_software_usage_integration/createOrUpdate
### Paramètres de demande pris en charge
{#sam_soft_us_int-POST-createOrUpdate__entry__2}{#sam_soft_us_int-POST-createOrUpdate__version-RESTAPI}
| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 1. Paramètres de chemin d'accès]
{#sam_soft_us_int-POST-createOrUpdate__entry__6}
| Nom | Description |
|-|-|
| Aucun | |
[Tableau 2. Paramètres de requête]
{#sam_soft_us_int-POST-createOrUpdate__entry__10}
| Nom | Description |
|-|-|
| Éléments | Liste des noms de colonnes et des valeurs pour chaque champ à stocker dans l'enregistrement d'utilisation du logiciel. Les informations de colonne que vous devez transmettre dépendent de la valeur que vous spécifiez pour reclamation_type (qui est un champ obligatoire) : Valeurs possibles reclamation_type et informations de colonne qui doivent être transmises : * total_usage : * configuration_item * last_used_time * month_used * norm_product * année {#sam_soft_us_int-POST-createOrUpdate__ul_cvy_2qh_zlb} * last_used_date : * configuration_item * norm_product {#sam_soft_us_int-POST-createOrUpdate__ul_pxb_jqh_zlb} {#sam_soft_us_int-POST-createOrUpdate__ul_rk3_zrc_zlb} La combinaison de ces champs permet d'identifier de manière unique un enregistrement. Si l'enregistrement est introuvable dans la table, un nouvel enregistrement avec les champs spécifiés est créé. sinon, l'enregistrement existant est mis à jour. Type de données : tableau |
[Tableau 3. Paramètres de corps de demande (XML ou JSON)]
### En-têtes
Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#sam_soft_us_int-POST-createOrUpdate__entry__14}{#sam_soft_us_int-POST-createOrUpdate__accept-RESTAPI}{#sam_soft_us_int-POST-createOrUpdate__content_type-RESTAPI}
| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 4. En-têtes de demandes]
{#sam_soft_us_int-POST-createOrUpdate__entry__20}
| En-tête | Description |
|-|-|
| Aucun | |
[Tableau 5. En-têtes de réponses]
### Codes d'état
Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#sam_soft_us_int-POST-createOrUpdate__entry__24}{#sam_soft_us_int-POST-createOrUpdate__entry-200-status-code}{#sam_soft_us_int-POST-createOrUpdate__entry-401-status-code}{#sam_soft_us_int-POST-createOrUpdate__entry-404-status-code}{#sam_soft_us_int-POST-createOrUpdate__entry-405-status-code}{#sam_soft_us_int-POST-createOrUpdate__entry-500-status-code}
| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Introuvable. L'élément demandé est introuvable. |
| 405 | Méthode non valide. La fonctionnalité est désactivée. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 6. Codes d'état]
### Paramètres du corps de réponse (JSON ou XML)
{#sam_soft_us_int-POST-createOrUpdate__entry__36}
| Nom | Description |
|-|-|
| Éléments | Liste de paires nom-valeur de tous les champs de l'enregistrement d'utilisation du logiciel. Type de données : tableau (le contenu varie) |
[ ]
### Demande cURL
L'exemple suivant illustre comment créer un nouvel enregistrement d'utilisation de logiciel.
curl -X POST "https://instance.servicenow/api/now/sam_software_usage_integration/createOrUpdate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d "{'items': [\
{
'configuration_item':'eaa9604d3790200044e0bfc8bcbe5dc1',\
'month_used':2,\
'norm_product':'40209c060b3022002d6c650d37673a89',\
'norm_publisher':'24dcccc20b3022002d6c650d37673ab3',\
'reclamation_type':'total_usage',\
'usage_count': 13,\
'total_usage_time':13,\
'year':2020
}\
]}"
{
"result": {
"reply": {
"items": [
{
"configuration_item": "eaa9604d3790200044e0bfc8bcbe5dc1",
"month_used": 2,
"norm_product": "40209c060b3022002d6c650d37673a89",
"norm_publisher": "24dcccc20b3022002d6c650d37673ab3",
"reclamation_type": "total_usage",
"usage_count": 13,
"total_usage_time": 13,
"year": 2020,
"sysId": "13d15fe59d511010f8772c637e39afe5",
"status": "INSERT"
}
]
},
"message": "Ok"
}
}
L'exemple suivant illustre comment mettre à jour plusieurs enregistrements d'utilisation de logiciels en un seul appel.
curl -X POST "https://instance.servicenow/api/now/sam_software_usage_integration/createOrUpdate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d "{'items': [\
{\
'configuration_item': 'eaa9604d3790200044e0bfc8bcbe5dc1',\
'month_used': 2,\
'norm_product': '40209c060b3022002d6c650d37673a89',\
'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\
'reclamation_type': 'total_usage',\
'usage_count': 13,\
'total_usage_time': 13,\
'year': 2020
},
{\
'configuration_item': '0aa9e80d3790200044e0bfc8bcbe5da0',\
'month_used': 2,\
'norm_product': '40209c060b3022002d6c650d37673a89',\
'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\
'reclamation_type': 'total_usage',\
'usage_count': 19,\
'total_usage_time': 19,\
'year': 2020
},
{\
'configuration_item': 'a0a9a80d3790200044e0bfc8bcbe5d3c',\
'month_used': 2,\
'norm_product': '40209c060b3022002d6c650d37673a89',\
'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\
'reclamation_type': 'total_usage',\
'usage_count': 7,\
'total_usage_time': 7,\
'year': 2020},
{\
'configuration_item': '48a9280d3790200044e0bfc8bcbe5d55',\
'month_used': 2,\
'norm_product': '40209c060b3022002d6c650d37673a89',\
'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\
'reclamation_type': 'total_usage',\
'usage_count': 1,\
'total_usage_time': 1,\
'year': 2020},
{\
'configuration_item': '61a9680d3790200044e0bfc8bcbe5d11',\
'month_used': 2,\
'norm_product': '40209c060b3022002d6c650d37673a89',\
'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\
'reclamation_type': 'total_usage',\
'usage_count': 18,\
'total_usage_time': 18,\
'year': 2020}
]}"
{
"result": {
"reply": {
"items": [
{
"configuration_item": "eaa9604d3790200044e0bfc8bcbe5dc1",
"month_used": 2,
"norm_product": "40209c060b3022002d6c650d37673a89",
"norm_publisher": "24dcccc20b3022002d6c650d37673ab3",
"reclamation_type": "total_usage",
"usage_count": 13,
"total_usage_time": 13,
"year": 2020,
"sysId": "13d15fe59d511010f8772c637e39afe5",
"status": "INSERT"
},
{
"configuration_item": "0aa9e80d3790200044e0bfc8bcbe5da0",
"month_used": 2,
"norm_product": "40209c060b3022002d6c650d37673a89",
"norm_publisher": "24dcccc20b3022002d6c650d37673ab3",
"reclamation_type": "total_usage",
"usage_count": 19,
"total_usage_time": 19,
"year": 2020,
"sysId": "2cd15fe59d521010f9772c637e39aff4",
"status": "UPDATE"
},
{
...
},
]
},
"message": "Ok"
}
}