Documentação da API

1. Visão Geral

A API REST do Monetizzy Files permite que desenvolvedores enviem arquivos de forma automatizada. Desta forma, você pode programar uploads diretos a partir de seus servidores, bots ou aplicativos, obtendo de forma instantânea as URLs encurtadas e monetizadas para compartilhar com sua audiência.

2. Autenticação

Todas as requisições enviadas para a nossa API devem incluir um cabeçalho HTTP personalizado contendo seu token privado de desenvolvedor (disponível em seu painel na aba Configurações > Desenvolvedor):

X-API-Token: seu_token_privado_aqui

3. Endpoint de Upload

Para enviar um arquivo, você deve fazer uma requisição do tipo multipart/form-data para a nossa API:

Parâmetros no Body (form-data):

• file (Arquivo, Obrigatório): O arquivo binário que deseja enviar;
• description (String, Opcional): Descrição textual curta para exibição no link;
• password (String, Opcional): Senha para proteção de acesso ao download (apenas nos planos Pro/Business).

{
  "success": true,
  "message": "Upload concluído com sucesso.",
  "data": {
    "file_id": "mz_74a9b2c8",
    "file_name": "Ebook-Marketing-Digital.pdf",
    "file_size": 4404019,
    "download_url": "https://files.monetizzy.com/d/mz_74a9b2c8",
    "delete_url": "https://files.monetizzy.com/api/v1/files/delete/mz_74a9b2c8?token=del_7df8a72b",
    "created_at": "2026-05-23T14:00:00Z"
  }
}

4. Exemplos de Integração

Confira como realizar chamadas de upload para a API em diferentes plataformas e linguagens de programação:

curl -X POST https://files.monetizzy.com/api/v1/files/upload \
  -H "X-API-Token: seu_token_privado_aqui" \
  -F "file=@/caminho/do/arquivo/documento.pdf" \
  -F "description=Meu Ebook de Marketing"

import requests

url = "https://files.monetizzy.com/api/v1/files/upload"
headers = {
    "X-API-Token": "seu_token_privado_aqui"
}
files = {
    "file": open("documento.pdf", "rb")
}
data = {
    "description": "Meu Ebook de Marketing"
}

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

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

const form = new FormData();
form.append('file', fs.createReadStream('documento.pdf'));
form.append('description', 'Meu Ebook de Marketing');

axios.post('https://files.monetizzy.com/api/v1/files/upload', form, {
  headers: {
    ...form.getHeaders(),
    'X-API-Token': 'seu_token_privado_aqui'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(error);
});