API consommateur

Référence API Australie

Release

australia

ft:locale

fr-FR

ft:publication_title

Référence API Australie

ft:clusterId

crapiref

bundleId

crapiref

workflow

Creator

API consommateur

Rversion finale: Australia

Mis à jour 12 mars 2026

17 minutes de lecture

L’API consommateur fournit des points de terminaison pour récupérer et mettre à jour Gestion du service client (CSM) les enregistrements des consommateurs.

En outre, vous pouvez générer de nouveaux enregistrements de profils de réseaux sociaux lors de la création d’un consommateur.

L’API consommateur nécessite le module d’extension Service clientèle (com.sn_customerservice) et est fournie dans l’espace de noms Now .

Les utilisateurs ont besoin du rôle csm_ws_integration pour un accès complet à l’API.

Consommateur : GET /now/consumer

Récupère un ensemble spécifié d’enregistrements de Gestion du service client (CSM) consommateurs.

Format d'URL

URL versionnée : /api/now/{api_version}/consumer

URL par défaut : /api/now/consumer

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 1. Paramètres de chemin d'accès
Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par exemple, `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente. Type de données : chaîne

Tableau 2. Paramètres de requête
Nom	Description
sysparm_limit	Nombre maximal d’enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d’enregistrements, utilisez le paramètre pour paginer la récupération de l’enregistrement sysparm_offset . Dans la réponse, le paramètre hasMore booléen est renvoyé. Cela indique s’il existe d’autres enregistrements à renvoyer qui répondent aux critères de filtre. Type de données : nombre Valeur par défaut : 10
sysparm_offset	Démarrage de l’index d’enregistrement pour lequel commencer à récupérer des enregistrements. Utilisez cette valeur pour paginer la récupération de l’enregistrement. Cette fonctionnalité permet de récupérer tous les enregistrements, quel que soit leur nombre, en petits blocs gérables. Par exemple, la première fois que vous appelez ce point sysparm_offset de terminaison est défini sur « 0 ». Pour parcourir simplement tous les enregistrements disponibles, utilisez `sysparm_offset=sysparm_offset+sysparm_limit` jusqu’à ce que vous atteigniez la fin de tous les enregistrements. Ne transmettez pas de nombre négatif dans le sysparm_offset paramètre. Type de données : nombre Par défaut : 0
sysparm_query	Requête codée utilisée pour filtrer l’ensemble de résultats. Par exemple : `sysparm_query=caller_id=javascript :gs.getUserID()^active=true` La requête codée prend en charge le tri par. Pour trier les réponses en fonction de certains champs, utilisez les clauses ORDERBY et ORDERBYDESC dans sysparm_query. Par exemple, `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` filtre tous les enregistrements actifs et classe les résultats par ordre croissant par numéro d’abord, puis par ordre décroissant par catégorie. Si une partie de la requête n’est pas valide, par exemple en spécifiant un nom de champ non valide, l’instance ignore la partie non valide. Il renvoie ensuite les lignes en utilisant uniquement la partie valide de la requête. Vous pouvez contrôler ce comportement à l’aide de la propriété glide.invalid_query.returns_no_rows. Définissez cette propriété sur vrai pour ne retourner aucune ligne sur une requête non valide. Remarque : La glide.invalid_query.returns_no_rows propriété contrôle le comportement de toutes les requêtes dans l’instance, notamment dans les listes, les scripts (GlideRecord.query()) et les API de service Web. Type de données : chaîne

Tableau 3. Paramètres de corps de demande (XML ou JSON)
Élément	Description
Néant

En-têtes

Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP 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.

Tableau 4. En-têtes de demandes
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

Tableau 5. En-têtes de réponses
En-tête	Description
Néant

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.

Tableau 6. Codes d'état
Code d'état	Description
200	Réussi. La demande a été traitée avec succès.
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.
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.

Paramètres du corps de la réponse (JSON ou XML)

Le point de terminaison peut renvoyer les éléments JSON ou XML suivants dans le corps de la réponse. En plus de la liste d’éléments définie ci-dessous (qui définit les éléments d’un système de base), le point de terminaison renvoie également tous les champs personnalisés ajoutés à la table Consommateur [csm_consumer]. Pour plus d’informations sur ces éléments, reportez-vous à la définition de votre table spécifique [Définition du système > Tables].


Élément	Description
actif	Marqueur indiquant si le consommateur est actif. Valeurs possibles : vrai : consommateur actif faux : consommateur désactivé Type de données : booléennes Par défaut : true
business_phone	Numéro de téléphone professionnel du consommateur. Type de données : chaîne Longueur maximale : 40
city	Ville dans laquelle réside le consommateur. Type de données : chaîne Longueur maximale : 100
pays	Pays dans lequel réside le consommateur. Type de données : chaîne Longueur maximale : 40
date_format	Format dans lequel afficher les dates. Valeurs valides : jj-mm-aaaa jj/mm/aaaa jj.mm.aaaa mm-jj-aaaa aaaa-mm-jj Type de données : chaîne Longueur maximale : 40 Par défaut : vide (format de date système)
e-mail	Adresse e-mail du consommateur. Type de données : chaîne Longueur maximale : 100
par télécopieur	Numéro de télécopie du consommateur. Type de données : chaîne Longueur maximale : 40
first_name	Prénom du consommateur. Type de données : chaîne Longueur maximale : 50
sexe	Sexe du consommateur. Type de données : chaîne Longueur maximale : 40
home_phone	Numéro de téléphone du domicile du consommateur. Type de données : chaîne Longueur maximale : 40
household	Sys_id de l’enregistrement qui décrit les caractéristiques du ménage. Type de données : chaîne Table : Ménage [csm_household]
last_name	Nom de famille du consommateur. Type de données : chaîne Longueur maximale : 50
middle_name	Deuxième prénom du consommateur. Type de données : chaîne Longueur maximale : 50
mobile_phone	Numéro de téléphone mobile du consommateur. Type de données : chaîne Longueur maximale : 40
nom	Nom complet du consommateur ; first_name+middle_name+last_name. Type de données : chaîne Longueur maximale : 152
notes	Notes sur le consommateur. Type de données : chaîne Longueur maximale : 4 000
Notification	Indique si le consommateur doit recevoir des notifications. Valeurs valides : 1 : Désactivé 2 : Activé Type de données : nombre (entier) Longueur maximale : 40 Par défaut : 2
Numéro	Numéro unique associé au consommateur. Type de données : chaîne Longueur maximale : 40
photo	Photo du consommateur. Type de données : image
preferred_language	Langue primaire du consommateur. Type de données : chaîne Longueur maximale : 3
Préfixe	Préfixe du nom de consommateur tel que Dr., M., Mme ou Mme. Type de données : chaîne Longueur maximale : 40
primaire	Marqueur indiquant s’il s’agit du consommateur primaire. Valeurs possibles : vrai : consommateur primaire faux : non consommateur primaire Type de données : booléennes Valeur par défaut : false
État	État dans lequel réside le consommateur. Type de données : chaîne Longueur maximale : 100
rue	Adresse postale du consommateur. Type de données : chaîne Longueur maximale : 255
suffixe	Suffixe du nom de consommateur tel que Jr., Sr. ou II. Type de données : chaîne
sys_created_by	Utilisateur ayant créé l’enregistrement du consommateur. Type de données : chaîne Longueur maximale : 40
sys_created_on	Date et heure de création initiale de l’enregistrement de consommateur. Type de données : chaîne
sys_domain	ServiceNow Domaine dans lequel se trouvent les informations sur les consommateurs. Type de données : chaîne
sys_id	Identificateur unique pour le consommateur. Type de données : chaîne
sys_mod_count	Nombre de fois où les informations de consommateur associées ont été modifiées. Type de données : nombre (entier)
sys_tags	Balises système. Type de données : chaîne
sys_updated_by	Utilisateur qui a mis à jour les informations sur le consommateur pour la dernière fois. Type de données : chaîne Longueur maximale : 40
sys_updated_on	Date et heure auxquelles les informations sur les consommateurs ont été mises à jour pour la dernière fois. Type de données : chaîne
time_format	Format dans lequel afficher l’heure. Valeurs valides : hh.mm.ss : hh.mm.ss (12 heures) hh :mm :ss a : hh :mm :ss (12 heures) HH.mm.ss : hh.mm.ss (24 heures) HH :mm :ss : hh :mm :ss (24 heures) Type de données : chaîne Longueur maximale : 40 Par défaut : vide (format d’heure du système)
time_zone	Fuseau horaire du consommateur, par exemple Canada/Centre ou US/Est. Type de données : chaîne Longueur maximale : 40
Titre	Titre de l’entreprise du consommateur tel que gestionnaire, développeur de logiciels ou entrepreneur. Type de données : chaîne Longueur maximale : 60
utilisateur	Sys_id de l’utilisateur consommateur. Type de données : chaîne Table : utilisateur consommateur [csm_consumer_user]
code postal	Code postal du consommateur. Type de données : chaîne Longueur maximale : 40

Demande cURL

curl "https://instance.servicenow.com/api/now/consumer?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2>;rel="next" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": [
    {
      "country": "USA",
      "notes": "",
      "gender": "Male",
      "city": "Plano",
      "prefix": "",
      "sys_updated_on": "2016-08-12 00:19:12",
      "suffix": "",
      "title": "",
      "number": "CSMR0000004",
      "notification": "2",
      "sys_id": "01d8403fdb1b1200b6075200cf961941",
      "business_phone": "",
      "sys_updated_by": "prithvi",
      "mobile_phone": "",
      "street": "6900 Dallas Pkwy",
      "sys_created_on": "2016-06-16 19:20:13",
      "sys_domain": "global",
      "state": "TX",
      "fax": "",
      "first_name": "Harding",
      "email": "harding.asher@mailinator.com",
      "preferred_language": "",
      "sys_created_by": "guest",
      "zip": "75024",
      "home_phone": "",
      "time_format": "",
      "sys_mod_count": "8",
      "last_name": "Asher",
      "photo": "",
      "active": "true",
      "middle_name": "",
      "time_zone": "",
      "sys_tags": "",
      "name": "Harding Asher",
      "household": "",
      "date_format": "",
      "user": "c3d35d82c37122005871d44d81d3ae91",
      "primary": "false"
    },
    {
      "country": "USA",
      "notes": "",
      "gender": "Male",
      "city": "San Francisco",
      "prefix": "",
      "sys_updated_on": "2016-08-12 00:20:27",
      "suffix": "",
      "title": "",
      "number": "CSMR0000002",
      "notification": "2",
      "sys_id": "a0488cfbdb1b1200b6075200cf9619db",
      "business_phone": "",
      "sys_updated_by": "prithvi",
      "mobile_phone": "",
      "street": "144 2nd St",
      "sys_created_on": "2016-06-16 19:17:44",
      "sys_domain": "global",
      "state": "CA",
      "fax": "",
      "first_name": "Sam",
      "email": "sam.collins@mailinator.com",
      "preferred_language": "",
      "sys_created_by": "guest",
      "zip": "94105",
      "home_phone": "",
      "time_format": "",
      "sys_mod_count": "13",
      "last_name": "Collins",
      "photo": "",
      "active": "true",
      "middle_name": "",
      "time_zone": "",
      "sys_tags": "",
      "name": "Sam Collins",
      "household": "",
      "date_format": "",
      "user": "64488cfbdb1b1200b6075200cf9619db",
      "primary": "false"
    }
  ]
}

Consommateur : GET /now/consumer/{id}

Récupère l’enregistrement de consommateur spécifié Gestion du service client (CSM) .

Format d'URL

URL versionnée : /api/now/{api_version}/consumer/{id}

URL par défaut : /api/now/consumer/{id}

Remarque :

Paramètres de demande pris en charge

Tableau 7. Paramètres de chemin d'accès
Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par exemple, `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente. Type de données : chaîne
id	Sys_id de l’enregistrement de consommateur à renvoyer. Type de données : chaîne Table : Consommateur [csm_consumer]

Tableau 8. Paramètres de requête
Nom	Description
Néant

Tableau 9. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Néant

En-têtes

Tableau 10. En-têtes de demandes
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

Tableau 11. En-têtes de réponses
En-tête	Description
Néant

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.

Tableau 12. Codes d'état
Code d'état	Description
200	Réussi. La demande a été traitée avec succès.
401	Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
404	Indique que la demande n’est pas valide. Cela peut être dû à l’une des raisons suivantes : Le ticket demandé n’existe pas. L’utilisateur n’a pas accès à l’enregistrement du consommateur.
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.

Paramètres du corps de la réponse (JSON ou XML)


Élément	Description
actif	Marqueur indiquant si le consommateur est actif. Valeurs possibles : vrai : consommateur actif faux : consommateur désactivé Type de données : booléennes Par défaut : true
business_phone	Numéro de téléphone professionnel du consommateur. Type de données : chaîne Longueur maximale : 40
city	Ville dans laquelle réside le consommateur. Type de données : chaîne Longueur maximale : 100
pays	Pays dans lequel réside le consommateur. Type de données : chaîne Longueur maximale : 40
date_format	Format dans lequel afficher les dates. Valeurs valides : jj-mm-aaaa jj/mm/aaaa jj.mm.aaaa mm-jj-aaaa aaaa-mm-jj Type de données : chaîne Longueur maximale : 40 Par défaut : vide (format de date système)
e-mail	Adresse e-mail du consommateur. Type de données : chaîne Longueur maximale : 100
par télécopieur	Numéro de télécopie du consommateur. Type de données : chaîne Longueur maximale : 40
first_name	Prénom du consommateur. Type de données : chaîne Longueur maximale : 50
sexe	Sexe du consommateur. Type de données : chaîne Longueur maximale : 40
home_phone	Numéro de téléphone du domicile du consommateur. Type de données : chaîne Longueur maximale : 40
household	Sys_id de l’enregistrement qui décrit les caractéristiques du ménage. Type de données : chaîne Table : Ménage [csm_household]
last_name	Nom de famille du consommateur. Type de données : chaîne Longueur maximale : 50
middle_name	Deuxième prénom du consommateur. Type de données : chaîne Longueur maximale : 50
mobile_phone	Numéro de téléphone mobile du consommateur. Type de données : chaîne Longueur maximale : 40
nom	Nom complet du consommateur ; first_name+middle_name+last_name. Type de données : chaîne Longueur maximale : 152
notes	Notes sur le consommateur. Type de données : chaîne Longueur maximale : 4 000
Notification	Indique si le consommateur doit recevoir des notifications. Valeurs valides : 1 : Désactivé 2 : Activé Type de données : nombre (entier) Longueur maximale : 40 Par défaut : 2
Numéro	Numéro unique associé au consommateur. Type de données : chaîne Longueur maximale : 40
photo	Photo du consommateur. Type de données : image
preferred_language	Langue primaire du consommateur. Type de données : chaîne Longueur maximale : 3
Préfixe	Préfixe du nom de consommateur tel que Dr., M., Mme ou Mme. Type de données : chaîne Longueur maximale : 40
primaire	Marqueur indiquant s’il s’agit du consommateur primaire. Valeurs possibles : vrai : consommateur primaire faux : non consommateur primaire Type de données : booléennes Valeur par défaut : false
État	État dans lequel réside le consommateur. Type de données : chaîne Longueur maximale : 100
rue	Adresse postale du consommateur. Type de données : chaîne Longueur maximale : 255
suffixe	Suffixe du nom de consommateur tel que Jr., Sr. ou II. Type de données : chaîne
sys_created_by	Utilisateur ayant créé l’enregistrement du consommateur. Type de données : chaîne Longueur maximale : 40
sys_created_on	Date et heure de création initiale de l’enregistrement de consommateur. Type de données : chaîne
sys_domain	ServiceNow Domaine dans lequel se trouvent les informations sur les consommateurs. Type de données : chaîne
sys_id	Identificateur unique pour le consommateur. Type de données : chaîne
sys_mod_count	Nombre de fois où les informations de consommateur associées ont été modifiées. Type de données : nombre (entier)
sys_updated_by	Utilisateur qui a mis à jour les informations sur le consommateur pour la dernière fois. Type de données : chaîne Longueur maximale : 40
sys_updated_on	Date et heure auxquelles les informations sur les consommateurs ont été mises à jour pour la dernière fois. Type de données : chaîne
time_format	Format dans lequel afficher l’heure. Valeurs valides : hh.mm.ss : hh.mm.ss (12 heures) hh :mm :ss a : hh :mm :ss (12 heures) HH.mm.ss : hh.mm.ss (24 heures) HH :mm :ss : hh :mm :ss (24 heures) Type de données : chaîne Longueur maximale : 40 Par défaut : vide (format d’heure du système)
time_zone	Fuseau horaire du consommateur, par exemple Canada/Centre ou US/Est. Type de données : chaîne Longueur maximale : 40
Titre	Titre de l’entreprise du consommateur tel que gestionnaire, développeur de logiciels ou entrepreneur. Type de données : chaîne Longueur maximale : 60
utilisateur	Sys_id de l’utilisateur consommateur. Type de données : chaîne Table : utilisateur consommateur [csm_consumer_user]
code postal	Code postal du consommateur. Type de données : chaîne Longueur maximale : 40

Demande cURL

curl "https://instance.servicenow.com/api/now/consumer/01d8403fdb1b1200b6075200cf961941 \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "country": "USA",
    "notes": "",
    "gender": "Male",
    "city": "Plano",
    "prefix": "",
    "sys_updated_on": "2016-08-12 00:19:12",
    "suffix": "",
    "title": "",
    "number": "CSMR0000004",
    "notification": "2",
    "sys_id": "01d8403fdb1b1200b6075200cf961941",
    "business_phone": "",
    "sys_updated_by": "prithvi",
    "mobile_phone": "",
    "street": "6900 Dallas Pkwy",
    "sys_created_on": "2016-06-16 19:20:13",
    "sys_domain": "global",
    "state": "TX",
    "fax": "",
    "first_name": "Harding",
    "email": "harding.asher@mailinator.com",
    "preferred_language": "",
    "sys_created_by": "guest",
    "zip": "75024",
    "home_phone": "",
    "time_format": "",
    "sys_mod_count": "8",
    "last_name": "Asher",
    "photo": "",
    "active": "true",
    "middle_name": "",
    "time_zone": "",
    "sys_tags": "",
    "name": "Harding Asher",
    "household": "",
    "date_format": "",
    "user": "c3d35d82c37122005871d44d81d3ae91",
    "primary": "false"
  }
}

Consommateur : POST /now/consumer

Crée un nouveau Gestion du service client (CSM) consommateur.

En outre, vous pouvez créer un profil de réseau social pour le consommateur à l’aide de ce point de terminaison. Pour créer le profil, vous devez spécifier les paramètres suivants dans le corps de la demande :

social_channel
social_handle
social_handle_url

Avertissement :

Ce point de terminaison n’effectue pas la validation des paramètres, car cela peut créer des frais généraux excessifs. Si un paramètre de demande est mal orthographié, n’est pas valide ou n’est pas pris en charge par le point de terminaison, il est ignoré sans avertissement.

Format d'URL

URL versionnée : /api/now/{api_version}/consumer

URL par défaut : /api/now/consumer

Remarque :

Paramètres de demande pris en charge

Tableau 13. Paramètres de chemin d'accès
Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par exemple, `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente. Type de données : chaîne

Tableau 14. Paramètres de requête
Nom	Description
Néant

Tableau 15. Paramètres de corps de demande (XML ou JSON)
Élément	Description
actif	Marqueur indiquant si le consommateur est actif. Valeurs possibles : vrai : consommateur actif faux : consommateur désactivé Type de données : booléennes Par défaut : true
business_phone	Numéro de téléphone professionnel du consommateur. Type de données : chaîne Longueur maximale : 40
city	Ville dans laquelle réside le consommateur. Type de données : chaîne Longueur maximale : 100
pays	Pays dans lequel réside le consommateur. Type de données : chaîne Longueur maximale : 40
date_format	Format dans lequel afficher les dates. Valeurs valides : jj-mm-aaaa jj/mm/aaaa jj.mm.aaaa mm-jj-aaaa aaaa-mm-jj Type de données : chaîne Longueur maximale : 40 Par défaut : vide (format de date système)
e-mail	Adresse e-mail du consommateur. Type de données : chaîne Longueur maximale : 100
par télécopieur	Numéro de télécopie du consommateur. Type de données : chaîne Longueur maximale : 40
first_name	Prénom du consommateur. Type de données : chaîne Longueur maximale : 50
sexe	Sexe du consommateur. Type de données : chaîne Longueur maximale : 40
home_phone	Numéro de téléphone du domicile du consommateur. Type de données : chaîne Longueur maximale : 40
household	Sys_id de l’enregistrement qui décrit les caractéristiques du ménage. Type de données : chaîne Table : Ménage [csm_household]
last_name	Nom de famille du consommateur. Type de données : chaîne Longueur maximale : 50
middle_name	Deuxième prénom du consommateur. Type de données : chaîne Longueur maximale : 50
mobile_phone	Numéro de téléphone mobile du consommateur. Type de données : chaîne Longueur maximale : 40
nom	Nom complet du consommateur ; first_name+middle_name+last_name. Type de données : chaîne Longueur maximale : 152
notes	Notes sur le consommateur. Type de données : chaîne Longueur maximale : 4 000
Notification	Indique si le consommateur doit recevoir des notifications. Valeurs valides : 1 : Désactivé 2 : Activé Type de données : nombre (entier) Longueur maximale : 40 Par défaut : 2
photo	Photo du consommateur. Type de données : image
preferred_language	Langue primaire du consommateur. Type de données : chaîne Longueur maximale : 3
Préfixe	Préfixe du nom de consommateur tel que Dr., M., Mme ou Mme. Type de données : chaîne Longueur maximale : 40
primaire	Marqueur indiquant s’il s’agit du consommateur primaire. Valeurs possibles : vrai : consommateur primaire faux : non consommateur primaire Type de données : booléennes Valeur par défaut : false
social_channel	Canal de réseau social auquel le consommateur est associé, tel que Twitter, Facebook ou Instagram. Type de données : chaîne
social_handle	Nom d’utilisateur sur le canal de médias sociaux. Type de données : chaîne
social_handle_url	URL du handle de canal social du consommateur. Type de données : chaîne
État	État dans lequel réside le consommateur. Type de données : chaîne Longueur maximale : 100
rue	Adresse postale du consommateur. Type de données : chaîne Longueur maximale : 255
suffixe	Suffixe du nom de consommateur tel que Jr., Sr. ou II. Type de données : chaîne
time_format	Format dans lequel afficher l’heure. Valeurs valides : hh.mm.ss : hh.mm.ss (12 heures) hh :mm :ss a : hh :mm :ss (12 heures) HH.mm.ss : hh.mm.ss (24 heures) HH :mm :ss : hh :mm :ss (24 heures) Type de données : chaîne Longueur maximale : 40 Par défaut : vide (format d’heure du système)
time_zone	Fuseau horaire du consommateur, par exemple Canada/Centre ou US/Est. Type de données : chaîne Longueur maximale : 40
Titre	Titre de l’entreprise du consommateur tel que gestionnaire, développeur de logiciels ou entrepreneur. Type de données : chaîne Longueur maximale : 60
utilisateur	Sys_id de l’utilisateur consommateur. Type de données : chaîne Table : utilisateur consommateur [csm_consumer_user]
code postal	Code postal du consommateur. Type de données : chaîne Longueur maximale : 40

En-têtes

Tableau 16. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Prend uniquement en charge application/json.
Type de contenu	Format des données du corps de la demande. Prend uniquement en charge application/json.

Tableau 17. En-têtes de réponses
En-tête	Description
Néant

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.

Tableau 18. Codes d'état
Code d'état	Description
201	Le nouvel enregistrement de consommateur a été créé avec succès.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
401	Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
500	Erreur interne du serveur. Une erreur logique s’est produite sur le code côté serveur.

Paramètres du corps de la réponse (JSON ou XML)


Élément	Description
résultat	Sys_id de l’enregistrement de consommateur nouvellement créé. Type de données : chaîne

Demande cURL

curl -X POST "https://instance.servicenow.com/api/now/consumer" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d " { \
  "country": "USA", \
  "notes": "Never comes in before 10am", \
  "gender": "Female", \
  "city": "San Marcos", \
  "prefix": "Ms", \
  "title": "Director", \
  "notification": "1", \
  "business_phone": "(555)555-1234", \
  "mobile_phone": "(555)555-1235", \
  "street": "123 Sesame St", \
  "state": "CA", \
  "fax": "(555)555-1236", \
  "first_name": "Jane", \
  "zip": "92001", \
  "home_phone": "(555)555-1234", \
  "last_name": "Brown", \
  "active": "true", \
  "middle_name": "Dell", \
  "time_zone": "PST", \
  "name": "Jane Brown", \
  "household": "4", \
  "user": "c3d35d82c37122005871d44d81d3ae91", \
  "primary": "false" \
}"
--user "username":"password"

{
    "result": "0f5c13addb93230057c3fd441d9619b8"
}