Aller au contenu principal

Générateur de requête API

Configurez les éléments d’une requête HTTP puis générez des exemples prêts à utiliser en cURL, Fetch ou Axios directement dans votre navigateur.

  • Presse-papiers
  • Export

Intégrer ce widget

Personnalisez le rendu, vérifiez l’aperçu puis copiez le code.

Aperçu

Type de code d’intégration

Code à copier

Responsive et redimensionné automatiquement par Bethemesh.

Méthode

Une ligne par paramètre : clé=valeur

Une ligne par en-tête : Nom: valeur

Cet outil vous a-t-il été utile ?

Comment fonctionne cet outil ?

Configurez une requête HTTP complète et générez ses équivalents cURL, Fetch et Axios.

Le générateur prépare trois extraits depuis la même configuration : cURL, Fetch et Axios. Il ne contacte pas l’URL et ne mesure ni statut HTTP ni délai de réponse. Les URL HTTP(S) sont validées puis sérialisées ; les lignes clé=valeur sont ajoutées aux paramètres existants, y compris les clés répétées. Les en-têtes sont lus en lignes Nom: valeur, avec contrôle du nom et des caractères interdits. À nom égal sans tenir compte de la casse, la dernière valeur est conservée.

Les corps JSON sont vérifiés, puis leur texte original est conservé dans les extraits. Cela évite de réécrire silencieusement un grand entier lors de la génération. Content-Type: application/json est ajouté si nécessaire, sans remplacer votre choix explicite. Les corps des méthodes GET et HEAD sont refusés pour garder une configuration utilisable avec Fetch. Les formats disponibles sont aucun corps, JSON ou texte ; les fichiers et formulaires multipart ne sont pas construits.

La sortie Fetch utilise await et lit la réponse en texte avant d’analyser un contenu annoncé comme JSON. À l’exécution, cette analyse sera soumise aux limites numériques de JavaScript. Axios doit être disponible dans votre projet ; l’extrait n’installe pas la dépendance. cURL utilise la citation POSIX. Ces clients n’ont pas les mêmes règles d’exécution : le navigateur impose CORS et certains en-têtes, cURL utilise l’environnement du terminal. La génération ne garantit donc pas une réponse identique dans chaque contexte.

Comment utiliser cet outil ?

  1. Décrire la requête

    Choisissez la méthode, l’URL absolue, les paramètres et les en-têtes. Utilisez des identifiants fictifs si le résultat est destiné à être partagé.

  2. Choisir le corps

    Sélectionnez JSON ou texte seulement pour une méthode qui l’autorise ici. Un document JSON invalide bloque la génération des trois variantes.

  3. Adapter le client

    Générez puis copiez ou téléchargez la variante utile. Ajoutez gestion des erreurs, contrôle du statut et authentification adaptés avant de l’intégrer à une application.

Cas d'utilisation

Prototyper un appel API

Passer rapidement d’une idée de requête à du code exécutable.

Comparer plusieurs clients

Vérifier les équivalences entre cURL, Fetch API et Axios.

Préparer une documentation

Fournir plusieurs exemples de consommation pour un même endpoint.

Exemples

Une recherche en cURL

L’espace du filtre est sérialisé dans la query. La commande générée est du texte ; aucune réponse API n’a été demandée.

Entrée

GET https://example.com/search; q=hello world

Résultat

curl 'https://example.com/search?q=hello+world'

Un POST dans Fetch

Le corps JSON reste une chaîne dans les options. await nécessite un contexte JavaScript compatible ; le code de réponse n’est exécuté qu’après votre intégration.

Entrée

POST https://example.com/api; JSON {"name":"Ada"}

Résultat

const response = await fetch("https://example.com/api", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": "{\"name\":\"Ada\"}"
});
const text = await response.text();
const data = text && response.headers.get("content-type")?.includes("json") ? JSON.parse(text) : text;

Conseils et bonnes pratiques

  • Un 404 peut produire un objet Response sans rejet de fetch. Ajoutez un contrôle de response.ok selon le comportement souhaité.
  • Copiez la configuration plutôt que des secrets de production. Les fichiers téléchargés contiennent les valeurs d’authentification que vous avez saisies.
  • Le code généré ne choisit pas votre politique de nouvelle tentative. Définissez-la selon la méthode et l’idempotence de l’opération réelle.

Sources et références

Questions fréquentes

Pourquoi cURL fonctionne-t-il alors que Fetch est bloqué ?

Le navigateur applique CORS et des restrictions d’en-têtes que le terminal n’impose pas. Vérifiez les réponses du serveur et l’origine autorisée, sans supposer une erreur de génération.

Le code Axios est-il autonome ?

Non. Il suppose Axios disponible et un contexte adapté à await. Ajoutez import, dépendance et traitement des erreurs selon votre projet.

Le JSON est-il réécrit dans les extraits ?

Son corps est contrôlé puis conservé comme texte. L’analyse ultérieure d’une réponse JSON est distincte et peut arrondir de grands nombres en JavaScript.

Puis-je comparer les temps de réponse ici ?

Non. Aucun appel n’est exécuté. Utilisez un client HTTP ou vos outils de développement pour tester réseau, statut, authentification et délais.

Outils associés

Des outils similaires ou complémentaires à celui-ci.

Outils similaires

Générez une commande cURL complète à partir d’une requête HTTP.

DéveloppementUtiliser l’outil

Construisez des en-têtes HTTP personnalisés et récupérez une sortie prête à utiliser dans vos requêtes.

DéveloppementUtiliser l’outil

Formatez, minifiez et validez un document JSON pour le rendre plus lisible ou plus compact.

DéveloppementMis en avantUtiliser l’outil