Documentação da API

Converta arquivos a partir do seu próprio código: envie um arquivo, consulte o status e baixe o resultado. Três requisições e uma chave de API.

Obtenha a chave APIComece
curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"

Começando

Do zero ao primeiro arquivo convertido:

  1. Escolha um plano pago (Starter, Pro ou Business) em 1-converter.com. O Free não tem chaves de API.
  2. Crie uma chave em Painel → Configurações → Chaves de API e copie-a: ela aparece só uma vez.
  3. Envie a chave com o seu primeiro upload, como mostrado em Autenticação.

Autenticação

Envie a sua chave de API em cada pedido, num destes dois cabeçalhos:

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

Os dois cabeçalhos são aceites e levam a mesma chave. Use o que for mais prático para o seu cliente HTTP.

Nunca compartilhe sua chave de API nem a envie para o controle de versão.

Mantenha sua chave de API segura e nunca a exponha no código do cliente.

URL base

Todas as solicitações de API devem ser feitas para:

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

Terminais de API

Carregar e converter

Carregue um arquivo e converta-o para o formato especificado

POST/api/v1/convert/upload

Solicitar cabeçalhos

Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

Corpo da solicitação

  • fileO arquivo a ser convertido (obrigatório)
  • target_formatFormato de destino (por exemplo, 'pdf', 'jpg', 'png') (obrigatório)

Resposta

{
  "id": 4821,
  "original_file_name": "document.pdf",
  "original_format": "pdf",
  "target_format": "docx",
  "status": "pending",
  "progress": 0,
  "created_at": "2026-08-01T09:14:03Z",
  "expires_at": "2026-08-08T09:14:03Z"
}

Verifique o status

Verifique o status de uma conversão

GET/api/v1/convert/status/:id

Resposta

{
  "conversion": {
    "id": 4821,
    "original_file_name": "document.pdf",
    "target_format": "docx",
    "status": "completed",
    "progress": 100,
    "created_at": "2026-08-01T09:14:03Z",
    "expires_at": "2026-08-08T09:14:03Z"
  }
}

Baixar resultado

Baixe o arquivo convertido

GET/api/v1/convert/download/:id

Limites de taxa

Cada plano pago inclui um número mensal de chamadas à API, o mesmo que aparece na página de preços.

PlanoChamadas de API por mês
FreeSem chaves de API
Starter1.000 chamadas de API por mês
Pro10.000 chamadas de API por mês
BusinessAPI ilimitada

Quando os limites de taxa forem excedidos, você receberá uma resposta 429 Too Many Requests.

Códigos de erro

A API usa códigos de status HTTP padrão para indicar sucesso ou falha:

CódigoDescrição
400 Solicitação incorretaParâmetros de solicitação inválidos
401 Não autorizadoChave de API inválida ou ausente
403 ProibidoPermissões insuficientes
404 não encontradoRecurso não encontrado
429 Muitas solicitaçõesLimite de taxa excedido
500 Erro interno do servidorErro no servidor, tente novamente

Exemplos de código

Aqui estão exemplos em diferentes linguagens de programação:

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
  headers: {
    ...formData.getHeaders(),
    'Authorization': 'Bearer YOUR_API_KEY'
  }
}).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

Pitão

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

curvatura

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"

Precisar de ajuda?

Uma requisição falha de um jeito que esta documentação não explica? Escreva para nós com a requisição e a resposta que você recebeu.

Contate o suporteGerenciar chaves de API