API Documentation

Documentação completa da API pública para revendedores

🚀 Começando

1. Obter Token de API

Acesse seu painel de revendedor e gere um token de API na seção de configurações.

Ou use a API para gerar um token:

POST https://seudominio.com/api/reseller/api-token
Authorization: Bearer <seu_jwt_token>

2. Autenticação

Todas as requisições devem incluir o token de API no header:

Authorization: Bearer <seu_api_token>

📡 Endpoints da API

Gerar Teste

POST

Gera um teste gratuito de 4 horas para seus clientes.

curl -X POST https://seudominio.com/api/public/reseller/generate-test \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta:

{
  "success": true,
  "data": {
    "id": "uuid",
    "username": "123456789",
    "password": "987654321",
    "m3u_url": "https://seudominio.com/m3u/123456789/987654321",
    "xc_api_url": "https://seudominio.com/api/v1/xc/player_api.php",
    "expires_at": "2025-01-01T12:00:00Z",
    "created_at": "2025-01-01T08:00:00Z"
  }
}

Criar Usuário

POST

Cria um usuário com assinatura mensal. Cada mês custa 1 crédito.

curl -X POST https://seudominio.com/api/public/reseller/create-user \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"months": 1}'

Parâmetros opcionais:

{
  "months": 1,              // Número de meses (1-24)
  "username": "custom",     // Opcional: username customizado
  "password": "custom123"   // Opcional: senha customizada
}

Resposta:

{
  "success": true,
  "data": {
    "id": "uuid",
    "username": "123456789",
    "password": "987654321",
    "m3u_url": "https://seudominio.com/m3u/123456789/987654321",
    "xc_api_url": "https://seudominio.com/api/v1/xc/player_api.php",
    "expires_at": "2025-02-01T08:00:00Z",
    "created_at": "2025-01-01T08:00:00Z",
    "credits_remaining": 4
  }
}

Listar Testes

GET

Lista todos os testes criados pelo revendedor.

curl -X GET "https://seudominio.com/api/public/reseller/tests?page=1&limit=20" \
  -H "Authorization: Bearer SEU_TOKEN"

Query Params:

  • page - Página (padrão: 1)
  • limit - Itens por página (padrão: 20, máx: 100)
  • status - Filtrar por: active ou expired

Listar Usuários

GET

Lista todos os usuários criados pelo revendedor.

curl -X GET "https://seudominio.com/api/public/reseller/users?page=1&limit=20" \
  -H "Authorization: Bearer SEU_TOKEN"

Query Params:

  • page - Página (padrão: 1)
  • limit - Itens por página (padrão: 20, máx: 100)
  • status - Filtrar por: active, inactive ou expired

Renovar Usuário

PATCH

Adiciona meses à assinatura de um usuário existente.

curl -X PATCH https://seudominio.com/api/public/reseller/users \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "user_id", "months": 1}'

Deletar Teste

DELETE

Deleta um teste específico.

curl -X DELETE https://seudominio.com/api/public/reseller/tests \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "test_id"}'

Deletar Usuário

DELETE

Deleta um usuário específico.

curl -X DELETE https://seudominio.com/api/public/reseller/users \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "user_id"}'

Estatísticas

GET

Retorna estatísticas do revendedor (usuários, testes, créditos, etc).

curl -X GET https://seudominio.com/api/public/reseller/stats \
  -H "Authorization: Bearer SEU_TOKEN"

Saldo de Créditos

GET

Retorna o saldo de créditos e histórico de compras.

curl -X GET https://seudominio.com/api/public/reseller/credits \
  -H "Authorization: Bearer SEU_TOKEN"

❌ Códigos de Erro

401Token de API inválido ou não fornecido
403Acesso negado (conta inativa, créditos insuficientes, etc)
404Recurso não encontrado
400Dados inválidos na requisição
500Erro interno do servidor

⚡ Limites de Taxa

Atualmente não há limites de taxa definidos. Recomendamos usar as APIs de forma responsável. Em caso de abuso, sua conta pode ser suspensa.

💬 Suporte

Para dúvidas ou problemas com a API, entre em contato através do painel de revendedor.

Acessar Painel