Documentação da API

Integre uma poderosa conversão de arquivos ao seu aplicativo com nossa API RESTful

ComecekeyObtenha a chave API
bolt

Rápido como um relâmpago

Conversão de alto desempenho com processamento otimizado

shield

Seguro e confiável

Segurança de nível empresarial com 99,9% de tempo de atividade

trending_up

Escalável

Do protótipo à produção, nós escalamos com você

terminalComeçando

Para usar a API 1converter, siga estas etapas simples:

  1. Cadastre-se para uma conta gratuita em 1converter.com
  2. Gere uma chave de API no seu painel
  3. Comece a fazer solicitações de API com sua chave de API

keyAutenticação

Todas as solicitações de API devem incluir sua chave de API no cabeçalho de autorização:

X-API-Key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY

Observação: nunca compartilhe sua chave de API ou envie-a para 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 specification (JSON)

codeTerminais 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

  • O arquivo a ser convertido (obrigatório)
  • Formato 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

Os pedidos à API são limitados por minuto. É necessário um plano pago para aceder à API:

PlanoLimite de taxa
LivreIndisponível — é necessário fazer upgrade
Iniciante5000 pedidos/minuto
Pró5000 pedidos/minuto
NegóciosIlimitado

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

integration_instructionsExemplos 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?

Se você tiver dúvidas ou precisar de ajuda com a API, estamos aqui para ajudar!

support_agentContate o suportekeyGerenciar chaves de API