Documentação oficial

API do Monetizzy

Integre sua conta com a API do Monetizzy para autenticar sua chave, listar domínios disponíveis e criar links encurtados automaticamente.

Começar integração Minhas chaves

Visão geral

Documentação completa da API Monetizzy para integração de encurtamento e monetização de links em suas aplicações.

A API aceita parâmetros por GET ou POST, dependendo do endpoint. As respostas são retornadas em JSON e normalmente agrupadas por contexto, como authentication, shorten ou domains.

Base URL: https://monetizzy.com/api

Para usar a API, acesse sua área de desenvolvedor no painel e gere uma chave. Guarde essa chave com segurança, pois ela identifica sua conta nas chamadas.

Autenticação

Envie sua chave no parâmetro key. As chaves de usuário são gerenciadas no painel de desenvolvedores.

ANY/api/auth?key=SUA_CHAVE

Descrição: endpoint utilizado para autenticar uma chave de API e confirmar o usuário associado.

ParâmetroTipoDescrição
keystringChave de API criada no painel de desenvolvedores.

Exemplo de requisição:

curl "https://monetizzy.com/api/auth?key=SUA_CHAVE"

Exemplo de resposta:

{
  "authentication": {
    "code": "NCXxhmZ8ropSWzDf5wUiYO",
    "status": "success",
    "description": "The key was successfully authenticated.",
    "user": {
      "id": "166235",
      "username": "johndoe"
    }
  }
}

Domínios

Retorna os domínios ativos que podem ser usados no parâmetro domain ao encurtar links.

GET/api/domains/list?key=SUA_CHAVE

Exemplo de requisição:

curl "https://monetizzy.com/api/domains/list?key=SUA_CHAVE"

Exemplo de resposta:

{
  "authentication": {
    "code": "NCXxhmZ8ropSWzDf5wUiYO",
    "status": "success",
    "description": "The key was successfully authenticated.",
    "user": {
      "id": "166235",
      "username": "johndoe"
    }
  },
  "domains": {
    "code": "EOr3FGZc3oqSw6VoqUGVyL",
    "status": "success",
    "list": [
      [
        "172345",
        "example1.com"
      ],
      [
        "562451",
        "example2.com"
      ],
      [
        "934462",
        "example3.com"
      ]
    ]
  }
}

Uso do Proxy

O proxy.monetizzy.com foi criado para permitir requisições seguras para a API do Monetizzy, evitando problemas de CORS e melhorando a segurança das comunicações entre o front-end e os endpoints da API.

Quando usar: use o proxy em aplicações front-end. Para back-end, prefira chamar a API direta.

Benefícios do proxy:

  • Permite chamadas para a API sem restrições de CORS.
  • Ajuda a evitar exposição direta da chave no navegador quando usado com uma camada segura.
  • Facilita a integração do Monetizzy com aplicações web.

Todas as requisições devem ser enviadas para https://proxy.monetizzy.com com a URL original e o payload nos parâmetros.

POSThttps://proxy.monetizzy.com
curl -X POST "https://proxy.monetizzy.com" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://monetizzy.com/api/shorten/link",
    "payload": {
      "key": "SUA_CHAVE",
      "link": "https://www.exemplo.com",
      "domain": "1",
      "type": 4
    }
  }'

Autenticação via Proxy

Autentica uma chave usando o proxy como intermediário da requisição.

POSThttps://proxy.monetizzy.com -> /api/auth
curl -X POST "https://proxy.monetizzy.com" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://monetizzy.com/api/auth",
    "payload": {
      "key": "SUA_CHAVE"
    }
  }'

Exemplo de resposta:

{
  "authentication": {
    "code": "NCXxhmZ8ropSWzDf5wUiYO",
    "status": "success",
    "description": "The key was successfully authenticated.",
    "user": {
      "id": "166235",
      "username": "johndoe"
    }
  }
}

Encurtar Link via Proxy

Cria um link encurtado enviando a requisição para o proxy, que repassa o payload para a API do Monetizzy.

POSThttps://proxy.monetizzy.com -> /api/shorten/link
curl -X POST "https://proxy.monetizzy.com" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://monetizzy.com/api/shorten/link",
    "payload": {
      "key": "SUA_CHAVE",
      "link": "https://www.exemplo.com",
      "domain": "1",
      "type": 4
    }
  }'

Exemplo de resposta:

{
  "authentication": {
    "code": "NCXxhmZ8ropSWzDf5wUiYO",
    "status": "success",
    "description": "The key was successfully authenticated.",
    "user": {
      "id": "166235",
      "username": "johndoe"
    }
  },
  "shorten": {
    "code": "t3sTjGk4XKTPBIqKB70sa7",
    "status": "success",
    "description": "The link has been shortened.",
    "link": "https://example1.com/aFtguIfIbPAv7321"
  }
}

Lista de Domínios via Proxy

Retorna a lista de domínios disponíveis usando o proxy como intermediário.

POSThttps://proxy.monetizzy.com -> /api/domains/list
curl -X POST "https://proxy.monetizzy.com" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://monetizzy.com/api/domains/list",
    "payload": {
      "key": "SUA_CHAVE"
    }
  }'

Exemplo de resposta:

{
  "authentication": {
    "code": "NCXxhmZ8ropSWzDf5wUiYO",
    "status": "success",
    "description": "The key was successfully authenticated.",
    "user": {
      "id": "166235",
      "username": "johndoe"
    }
  },
  "domains": {
    "code": "EOr3FGZc3oqSw6VoqUGVyL",
    "status": "success",
    "list": [
      [
        "172345",
        "example1.com"
      ],
      [
        "562451",
        "example2.com"
      ],
      [
        "934462",
        "example3.com"
      ]
    ]
  }
}

Pronto para integrar?

Com esses endpoints você já pode integrar a API do Monetizzy em sua aplicação. Use o proxy para requisições de front-end e a API direta para requisições feitas no back-end.