Utiliser l’aire de jeu de référence de l’API
Les lecteurs d’une référence d’API publiée peuvent envoyer des requêtes de test en direct depuis leur navigateur, sans configuration : cliquez sur Try it sur n’importe quelle page d’opération, ou utilisez la page GraphQL playground d’une référence GraphQL. La requête est préremplie à partir de la spécification publiée ; vous n’avez donc généralement qu’à renseigner les valeurs qui changent. Si vous publiez une référence, c’est l’expérience dont bénéficient vos lecteurs ; vous contrôlez les serveurs, la sécurité et la visibilité dans Personnaliser une référence d’API.
Envoyer une requête REST
Ouvrez une page d’opération dans la référence publiée et cliquez sur Try it.
Renseignez les onglets dont le endpoint a besoin : Params, Body et Auth apparaissent uniquement lorsque l’opération les déclare, tandis que Headers est toujours disponible.
Cliquez sur Send.
La réponse s’affiche en dessous avec le statut, les en-têtes et le corps mis en forme.
Exécuter une requête GraphQL
Les références GraphQL disposent d’une page d’aire de jeu dédiée plutôt que de pages par opération. Rédigez votre requête, ajoutez des variables ou des en-têtes si nécessaire, puis cliquez sur Run request. Pour des raisons de sécurité, les requêtes sont limitées aux hôtes autorisés et aux règles de sécurité du proxy définies dans la référence, tandis que l’URL du endpoint peut être modifiée.
Les identifiants et les en-têtes que vous saisissez restent dans votre navigateur et ne sont jamais publiés avec la référence.