API de conversion

Authentification

Créez une clé dans Paramètres → Clés API, puis transmettez-la avec chaque requête :

x-api-key: <votre clé>

Les conversions sont débitées du solde du propriétaire de la clé (10 crédits par tâche, tous formats compris). Une tâche en échec est remboursée automatiquement.

Lancer une conversion

Envoyez les octets bruts d’une image PNG, JPEG ou WebP :

curl -X POST https://layerback.com/api/v1/convert \
  -H "x-api-key: $LAYERBACK_KEY" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @diagramme.png

{ "job_id": "5c048e6f-ec4d-43ad-9eee-0697414d5cef" }

L’API renvoie 402 si le solde est vide, 413 au-delà de 20 Mo, 415 pour des données non prises en charge et 429 lorsque la limite horaire est atteinte.

Suivre l’état de la tâche

curl https://layerback.com/api/v1/jobs/$JOB_ID \
  -H "x-api-key: $LAYERBACK_KEY"

{
  "job_id": "5c048e6f-…",
  "status": "succeeded",
  "total_seconds": 46.9,
  "formats": ["vsdx", "pptx", "drawio", "svg", "ir", "preview"]
}

status passe par queued, running, puis succeeded ou failed. Une vérification toutes les quelques secondes suffit ; le traitement dure généralement 30 à 60 secondes.

Télécharger les fichiers

curl -L "https://layerback.com/api/v1/jobs/$JOB_ID/download?format=vsdx" \
  -H "x-api-key: $LAYERBACK_KEY" -o diagramme.vsdx

format accepte vsdx, pptx, drawio, svg, ir (JSON structuré) et preview (PNG). Les téléchargements peuvent être répétés sans frais. Le point d’accès pouvant répondre par une redirection 302, votre client doit la suivre (-L avec curl).

Webhook de fin de traitement

Pour éviter les requêtes répétées, passez une URL HTTPS publique dans callback_url au démarrage :

curl -X POST "https://layerback.com/api/v1/convert?callback_url=https://votre.app/hooks/layerback" \
  -H "x-api-key: $LAYERBACK_KEY" \
  --data-binary @diagramme.png

Le webhook signale succès et échec avec le même schéma. Deux tentatives d’envoi sont effectuées ; pour un résultat critique, vérifiez aussi la tâche via son point d’accès.

OpenAPI et limites

La spécification complète se trouve sur layerback.com/openapi.yaml.

• Images PNG, JPEG et WebP jusqu’à 20 Mo
• 20 conversions par heure et par compte ; pour le traitement par lots, contactez davie@daviechen.com
• Les fichiers sont conservés au moins 72 heures et doivent être téléchargés dans ce délai