---
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


---

# Créer une API REST scriptée

# Créer une API REST scriptée {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

Créez une API REST scriptée pour définir des points de terminaison de service web.

## Avant de commencer

Rôle requis : web_service_admin

## Pourquoi et quand exécuter cette tâche

Par défaut, les API REST basées sur un script contiennent une ACL qui interdit aux utilisateurs ayant le rôle snc_external d'effectuer des demandes auprès de l'API.

## Procédure

1. Accédez à la ToutServices web du systèmeAPI REST basées sur un script.
2. Cliquez sur Nouveau.
3. Saisissez un nom pour le service.  
   L'ID d'API est défini automatiquement en fonction du nom. Vous pouvez modifier l'ID d'API si nécessaire.
4. Cliquez sur Envoyer.
{#t_CreateAScriptedRESTService__steps_nmg_dld_cs}

## Que faire ensuite

Après avoir créé l'API, configurez le service en fonction des besoins, par exemple en créant des ressources, en affectant des ACL ou en spécifiant les formats de demande et de réponse pris en charge.
* **[Créer une ressource d'API REST scriptée](https://servicenow-prod.fluidtopics.net/LxUaU9gVjbo1HyqHuOdvrQ)**   
  Créez une ressource d'API REST scriptée pour définir la méthode HTTP, le script de traitement et pour remplacer les paramètres du service parent.
* **[Définir les en-têtes de REST API scriptés](https://servicenow-prod.fluidtopics.net/p3ZuhANNPR_Jec8654sY_g)**   
  Définissez des en-têtes d'API REST scriptés pour contrôler les en-têtes que l'API accepte et avec lesquels elle peut répondre.
* **[Définir les paramètres de requêtes disponibles](https://servicenow-prod.fluidtopics.net/URdbAE2g491GJ~vujf1tkQ)**   
  Définissez les paramètres de requête disponibles pour contrôler les valeurs qu'un utilisateur demandeur peut transmettre dans l'URI de demande.
* **[Associer des paramètres de requête à une ressource](https://servicenow-prod.fluidtopics.net/2SfucTfcjlY2wwHQm~6D0A)**   
  Associez des paramètres de requête de l'API REST scriptés à une ressource.
* **[Configurer une API REST scriptée pour exiger une ACL](https://servicenow-prod.fluidtopics.net/aVFUm2sZBke5JfYEeB1~Lg)**   
  Les demandes adressées aux API REST scriptées respectent les ACL de plateforme, et l'utilisateur demandeur doit satisfaire à toutes les exigences en matière d'ACL de table pour accéder aux données d'instance. En outre, vous pouvez configurer l'API REST scriptée pour exiger une ACL spécifique.
* **[Activer la gestion des versions pour une API REST scriptée](https://servicenow-prod.fluidtopics.net/xjmjE_qIr4uKNobNML8D_w)**   
  Activez la gestion des versions pour une API REST scriptée afin de fournir plusieurs versions de l'API tout en maintenant la compatibilité avec les intégrations existantes.
* **[Type de contenu de la demande et de la réponse de contrôle](https://servicenow-prod.fluidtopics.net/mVKLaz_HgH9ujrXezmIxRw)**   
  Contrôle les types de contenu autorisés dans les demandes et réponses de l'API REST scriptées.
* **[Contrôle de la taille maximale de la demande](https://servicenow-prod.fluidtopics.net/l0cgqFDZI~TkU02wbsC3Pg)**   
  Vous pouvez spécifier la taille de fichier maximale autorisée dans la charge utile d'une demande d'API REST scriptée.