Connectez KoalaPic à votre flux de travail
Automatisez la conversion d'images avec vos plateformes no-code préférées ou des webhooks personnalisés.
Comment ça marche
Obtenir une clé API
Inscrivez-vous et créez une clé API gratuite depuis votre tableau de bord.
Connectez votre plateforme
Utilisez votre clé API pour vous authentifier auprès de Zapier, Make, n8n, ou toute plateforme de webhooks.
Automatisez les conversions
Déclenchez des conversions d'images automatiquement et recevez les résultats via des webhooks.
Plateformes prises en charge
Zapier
Connectez KoalaPic à plus de 7 000 applications. Déclenchez des workflows lorsque des images sont converties, ou convertissez des images dans le cadre de n'importe quel Zap.
Déclencheurs pris en charge
Actions via l’API
Make (Integromat)
Créez des scénarios d'automatisation visuels. Utilisez le module HTTP pour appeler l'API KoalaPic et recevoir les résultats de conversion via des webhooks.
Méthode d'intégration
n8n
Automatisation de workflow auto-hébergée. Utilisez le nœud Webhook pour recevoir les événements de conversion et le nœud HTTP Request pour déclencher des conversions.
Méthode d'intégration
Webhooks personnalisés
Utilisez notre API REST et nos webhooks signés HMAC-SHA256 pour créer des intégrations personnalisées avec n'importe quelle plateforme ou backend.
Fonctionnalités
Widget intégrable
Intégrez un convertisseur à votre propre site avec une seule balise script. Il reprend votre couleur d’accent et renvoie les résultats à votre serveur.
Fonctionnalités
Événements webhook
Toutes les plateformes reçoivent les mêmes charges utiles JSON plates, adaptées au no-code.
| Événement | Description |
|---|---|
conversion.started |
La conversion a commencé le traitement |
conversion.completed |
La conversion s'est terminée avec succès |
conversion.failed |
La conversion a rencontré une erreur |
job.completed |
Tâche par lot terminée (toutes les conversions effectuées) |
test.ping |
Événement de test pour vérifier la connectivité |
Guides de configuration
-
1
Créez une clé API — Rendez-vous dans votre Tableau de bord → Clés API et générez une nouvelle clé.[Screenshot: Dashboard API Keys page]
-
2
Connectez-vous dans Zapier — Recherchez "KoalaPic" dans l'annuaire d'applications de Zapier, ou utilisez un déclencheur Webhook by Zapier avec votre URL de webhook.[Screenshot: Zapier app search]
-
3
Authentifiez-vous — Collez votre clé API lorsque demandé.[Screenshot: Zapier authentication prompt]
-
4
Choisissez un déclencheur — Sélectionnez les événements à écouter.[Screenshot: Zapier trigger selection]
-
5
Créez votre Zap — Ajoutez des actions comme enregistrer sur Google Drive, envoyer une notification Slack, ou envoyer vers votre CMS.
-
1
Ajoutez un module HTTP — Dans votre scénario Make, ajoutez un module "HTTP → Make a request".
-
2
Configurez la requête — Définissez l'URL, la méthode sur POST, et ajoutez votre clé API en tant qu'en-tête Bearer token.
-
3
Configurez un déclencheur webhook — Ajoutez un module "Webhooks → Custom webhook" comme déclencheur de votre scénario. Copiez l'URL du webhook.
-
4
Enregistrez le webhook — Dans vos paramètres de webhook KoalaPic, ajoutez l'URL du webhook Make comme point de terminaison.
-
1
Ajoutez un nœud Webhook — Créez un nouveau workflow et ajoutez un nœud "Webhook" comme déclencheur. Définissez la méthode HTTP sur POST et copiez l'URL générée.
-
2
Enregistrez dans KoalaPic — Ajoutez l'URL du webhook n8n dans vos paramètres de webhook KoalaPic.
-
3
Ajoutez un nœud HTTP Request — Pour déclencher des conversions, ajoutez un nœud "HTTP Request" avec votre clé API dans l'en-tête Authorization.
-
4
Traitez les résultats — Connectez des nœuds supplémentaires pour traiter les charges utiles des webhooks : télécharger le fichier converti, enregistrer sur un stockage, envoyer des notifications, etc.
Exemples de récepteurs de webhook
Recevez et vérifiez les charges utiles de webhook dans votre propre backend.
import hmac, hashlib, json
from flask import Flask, request
app = Flask(__name__)
WEBHOOK_SECRET = "your_webhook_secret"
@app.route("/webhook", methods=["POST"])
def handle_webhook():
signature = request.headers.get("X-KoalaPic-Signature")
expected = hmac.new(
WEBHOOK_SECRET.encode(), request.data, hashlib.sha256
).hexdigest()
if not hmac.compare_digest(signature, expected):
return "Invalid signature", 403
payload = request.json
if payload["event"] == "conversion.completed":
download_url = payload["download_url"]
# Process the converted image...
return "OK", 200
const crypto = require("crypto");
const express = require("express");
const app = express();
const WEBHOOK_SECRET = "your_webhook_secret";
app.post("/webhook", express.raw({ type: "application/json" }), (req, res) => {
const signature = req.headers["x-koalapic-signature"];
const expected = crypto
.createHmac("sha256", WEBHOOK_SECRET)
.update(req.body)
.digest("hex");
if (signature !== expected) {
return res.status(403).send("Invalid signature");
}
const payload = JSON.parse(req.body);
if (payload.event === "conversion.completed") {
const downloadUrl = payload.download_url;
// Process the converted image...
}
res.sendStatus(200);
});
Besoin d'une intégration personnalisée ?
Notre API REST prend en charge toute plateforme capable d'effectuer des requêtes HTTP. Consultez la documentation ou contactez-nous.