API de conversión

Autenticación

Crea una clave en Ajustes → Claves API y envíala en todas las solicitudes:

x-api-key: <tu clave>

Las conversiones se descuentan del saldo del propietario de la clave (10 créditos por trabajo, con todos los formatos incluidos). Los trabajos fallidos se reembolsan automáticamente.

Crear una conversión

Envía los bytes de la imagen en PNG, JPEG o WebP:

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

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

La API devuelve 402 cuando no hay saldo, 413 si el archivo supera 20 MB, 415 para datos no compatibles y 429 al alcanzar el límite por hora.

Consultar el estado

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 pasa por queued, running y finalmente succeeded o failed. Consulta cada pocos segundos; lo normal es que termine en 30–60 segundos.

Descargar resultados

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

format admite vsdx, pptx, drawio, svg, ir (JSON estructurado) y preview (PNG). Las descargas se pueden repetir sin coste. El endpoint puede responder con una redirección 302, así que el cliente debe seguirla (-L en curl).

Webhook al finalizar

Para evitar el sondeo, añade una URL HTTPS pública en callback_url al iniciar la conversión:

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

El webhook recibe tanto éxitos como errores con el mismo esquema. Se intentan dos entregas; para procesos importantes conviene verificar el resultado en el endpoint del trabajo.

OpenAPI y límites

La especificación completa está en layerback.com/openapi.yaml.

• PNG, JPEG y WebP de hasta 20 MB
• 20 conversiones por hora y cuenta; para lotes, escribe a davie@daviechen.com
• Los archivos se conservan al menos 72 horas; descárgalos dentro de ese plazo