API para Desenvolvedores

Envie registros do seu site ou sistema e ganhe comissão como afiliado

Como funciona

Faça um POST com o texto, o arquivo ou a URL que o cliente quer registrar. O MaxRegistro cria o pedido, já com o seu código de afiliado, e leva o cliente para a tela onde ele confere os dados e paga.

POST https://maxregister.com/api/v1/save

Aceita formulário HTML comum (application/x-www-form-urlencoded), formulário com arquivo (multipart/form-data) e JSON.

Campos

Campo	Obrigatório	Descrição
`text`	Um dos três	Texto a registrar. O sistema cria um arquivo .txt com ele.
`file`	Um dos três	Arquivo enviado pelo formulário (multipart/form-data). Imagem, PDF, áudio, vídeo, até 100 MB.
`url`	Um dos três	URL pública (http/https) de um arquivo já hospedado.
`affiliate`	Não	Seu código de afiliado. Fica registrado no pedido e garante a sua comissão. Código inválido é ignorado.
`redirect`	Não	Padrão true: a resposta redireciona o navegador para a tela de continuação. Use false para receber JSON com a URL.
`title`	Não	Título do registro. Se faltar, usa o nome do arquivo ou a primeira linha do texto.
`email`	Não	E-mail do cliente. Se faltar, ele informa na tela de continuação.
`description`	Não	Descrição adicional (até 5000 caracteres).

O hash SHA-256 do arquivo e a miniatura de imagens são gerados pelo sistema; não é preciso enviar.

Exemplos

Troque SEU_CODIGO pelo seu código de afiliado. Entrando na sua conta, os exemplos já aparecem com ele.

Cole no seu site. Ao enviar, o visitante vai direto para o MaxRegistro continuar o registro do texto.

<form method="POST" action="https://maxregister.com/api/v1/save">
  <input type="hidden" name="affiliate" value="SEU_CODIGO">

  <label for="texto">Texto para registrar</label>
  <textarea id="texto" name="text" rows="6" required></textarea>

  <button type="submit">Registrar no MaxRegistro</button>
</form>

Resposta

Com redirect (padrão)

O navegador é levado para a tela de continuação do pedido.

HTTP/1.1 303 See Other
Location: https://maxregister.com/save/3f6c2d1e-9b8a-4c7d-a1e2-5b6c7d8e9f01

Com redirect=false

JSON com o id do pedido e a url para o cliente continuar.

{
  "success": true,
  "id": "3f6c2d1e-9b8a-4c7d-a1e2-5b6c7d8e9f01",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://maxregister.com/save/3f6c2d1e-9b8a-4c7d-a1e2-5b6c7d8e9f01"
}

Em caso de erro, com redirect o visitante volta para a página inicial com a mensagem; com redirect=false a resposta é JSON com error e code (missing_content, file_too_large, upload_failed ou invalid_request).

Preço

Integrar é gratuito. O cliente paga o registro na tela de continuação, e você recebe a comissão de cada pagamento.

Programa de Afiliados

Quer ganhar comissão por registro? Entre no programa de afiliados e receba R$ 1 a cada R$ 10 pagos pelos clientes que você indicar.

Ver meu código de afiliado