🌭 Hotdog API
Une API d'entraînement : vous envoyez une image, elle répond si c'est un hot-dog. Gratuite, sans compte. Elle sert à s'exercer à créer des apps Zapier, Make et n8n.
Obtenir une clé API
- Essayez l'API ici, sur des images d'exemple.
- Exécutez les requêtes du cours.
- Copiez-les vers Postman, n8n, Make ou Zapier.
Votre clé API
Copiez-la maintenant : elle n'est affichée qu'une fois (le serveur n'en garde pas la valeur) et reste visible tant que cet onglet est ouvert. Gardez-la pour vous. Perdue ? Créez-en une autre.
Est-ce un hot-dog ?
Choisissez une image d'exemple, ou envoyez la vôtre. Chaque essai utilise 1 classification du jour.
Les images sont analysées en mémoire et ne sont jamais conservées.
Vérifier la clé
Appelle GET /v1/me : sans coût, pour savoir si la clé fonctionne.
Les requêtes du cours
Choisissez une requête, exécutez-la ici, puis copiez-la vers votre outil. Votre clé et l'en-tête X-Integration-Source sont déjà inclus.
Copier cette requête vers…
- Copiez le cURL.
- Dans Postman : Import, collez, validez.
- Cliquez sur Send.
Toutes les requêtes d'un coup : importez la collection et l'environnement, puis choisissez l'environnement « ma clé » (il contient votre clé : ne le partagez pas).
- Copiez le nœud.
- Dans votre workflow n8n, cliquez dans le canvas et collez (Ctrl/⌘+V) : un nœud « HTTP Request » apparaît.
- Exécutez le nœud.
Voir le nœud
Pour l'envoi de fichier, placez avant ce nœud un nœud qui fournit un fichier binaire nommé data (par exemple « Read/Write Files from Disk »).
Autre méthode : importer un cURL
Dans un nœud « HTTP Request », cliquez sur Import cURL et collez :
Pour une vraie app, mettez la clé dans des « credentials » (Header Auth) plutôt que dans le nœud.
- Copiez le blueprint.
- Dans un scénario Make, clic droit sur le canvas puis Paste : le module « HTTP › Make a request » apparaît.
- Exécutez le module (Run this module only).
Voir le blueprint
Le fichier téléchargé s'importe avec Import blueprint dans le menu d'un scénario. Ce blueprint reprend la structure d'exports réels de Make, mais n'a pas été essayé de bout en bout : s'il est refusé, utilisez les champs ci-dessous.
Un envoi de fichier ne se copie pas en un bloc : reportez les champs ci-dessous dans le module HTTP › Make a request.
Ou reporter les champs un par un
Zapier ne sait ni coller une requête, ni importer un fichier. La façon la plus directe est une étape de code.
- Dans votre Zap, ajoutez l'action Code by Zapier, événement Run JavaScript.
- Copiez le code puis collez-le dans le champ Code.
- Testez l'étape : la sortie contient
statuset les champs de la réponse.
Voir le code
Une étape de code ne peut pas envoyer de fichier ici : utilisez « Classifier une image à partir d'une URL ».
Ou avec Webhooks by Zapier › Custom Request
Les applications intégrées (Code, Webhooks) dépendent de votre offre Zapier : vérifiez dans votre compte. Pour réutiliser ensuite une étape, utilisez la copie d'étape propre à Zapier.
Recevoir des événements (webhooks)
Un webhook, c'est l'API qui vous appelle : à chaque événement, elle envoie un POST à l'adresse indiquée. C'est ce qui déclenche un scénario « dès qu'un hot-dog est créé ».
Où trouver une adresse ? (publique, en https)
- Make : module Webhooks, « Custom webhook » (copiez l'adresse du webhook)
- Zapier : « Webhooks by Zapier », déclencheur « Catch Hook »
- n8n : nœud « Webhook » (URL de production)
- Sans rien configurer : une adresse jetable sur webhook.site
Secret de signature (affiché une seule fois) :
Il sert à vérifier l'en-tête X-Hotdog-Signature. Pour un premier essai, ignorez-le.
Pour déclencher un événement : exécutez « Créer un hot-dog » dans l'onglet Requêtes, puis ouvrez « Historique » ci-dessus.
Connecter votre app
Dans la connexion (authentification) de votre app Zapier, Make ou n8n :
La clé peut aussi s'envoyer sous la forme Authorization: Bearer <clé>.
Mes appels par plateforme
L'API compte vos appels selon l'en-tête X-Integration-Source (postman, make, zapier, n8n…). Les copies de l'onglet Requêtes l'envoient déjà.
Recommencer ou terminer
Réinitialiser mes données supprime vos hot-dogs, spots, historique et webhooks, et garde votre clé et son quota.
Révoquer ma clé la désactive aussitôt et supprime tout ce qui lui est lié.