API para integrações

A conversão entra no seu sistema sem mudar o seu fluxo.

Crie conversões e lotes, consulte o estado persistido e receba eventos assinados quando o trabalho terminar. Disponível com o adicional + API, em qualquer plano pago.

Uma requisição para começar.

Envie o PDF em multipart, informe uma chave de idempotência e receba um recurso assíncrono para acompanhar.

Ler documentação Criar conta

criar-conversao.sh

curl -X POST https://api.seudominio.com/api/v1/conversions \
  -H "Authorization: Bearer $UNO_API_KEY" \
  -H "Idempotency-Key: pedido-demo-001" \
  -F "file=@etiqueta.pdf" \
  -F "size=100x150"

{
  "id": "cnv_...",
  "status": "queued",
  "progress": 0
}

Chaves protegidas

O segredo é exibido uma vez e armazenado somente como hash.

Idempotência

A mesma operação pode ser repetida sem criar uma conversão duplicada.

Webhooks assinados

Eventos de conclusão e falha usam assinatura HMAC-SHA-256.

Escopo por organização

Recursos e limites pertencem à organização autenticada.

Contrato v1

Recursos previsíveis, falhas explícitas.

Conversões

POST /api/v1/conversionsGET /api/v1/conversions/:id

Lotes

POST /api/v1/batchesGET /api/v1/batches/:id

Uso

GET /api/v1/usage

Limite, reservado, confirmado e restante.