API para programadores

A API do Azpy permite-lhe converter ficheiros programaticamente com uma interface HTTP simples e previsível. Partilha o mesmo motor do site, pelo que a conversão que testa no navegador comporta-se de forma idêntica através da API.

Endpoints

POST

/api/v1/convert/:slug

Converte um ficheiro carregado. O :slug é o id de conversão, ex. docx-to-pdf.

GET

/api/v1/convert/:slug

Verifica se uma conversão de servidor está disponível e os seus limites atuais.

GET

/api/v1/tools

Lista todas as conversões suportadas com o modo de processamento e formatos aceites.

Exemplo, converter DOCX para PDF

curl -X POST https://azpy.es/api/v1/convert/docx-to-pdf \
  -H "Authorization: Bearer A_SUA_CHAVE_API" \
  -F "file=@report.docx" \
  --output report.pdf

Resposta

200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="report.pdf"

[bytes do PDF]

Autenticação

Os pedidos são autenticados com uma chave API enviada como token Bearer. As chaves são emitidas no plano Business. Sem chave, os pedidos não autenticados são limitados e sujeitos a limite de velocidade por IP.

Limites

As chaves API Business beneficiam de limites de tamanho de ficheiro e quotas de utilização superiores conforme o plano. As conversões em curso são temporárias e nunca são armazenadas; os ficheiros são eliminados imediatamente após a conversão.