Envialista API — Documentação

📡 Playlists & Dispositivos — Endpoints de envio e consulta de dispositivos IPTV

POST https://api.envialista.com/api/v1/webhook — Salvar Playlist IPTV

▼

Envia uma playlist IPTV para ser cadastrada no painel IboSol. A playlist será vinculada ao dispositivo pelo MAC Address e ao aplicativo informado.

Esta URL utiliza um gateway seguro que protege a infraestrutura de processamento, adiciona camadas de segurança e registra logs de auditoria.

🔒 Server_Key — Envie a Server_Key dentro do body JSON. Chave alfanumérica de 32 caracteres, validada no banco de dados.

📥 Body Parameters ▼

Campo	Tipo	Local	Status	Descrição	Exemplo
app_platform	string	body	Obrigatório	Nome do aplicativo (ex: BOBPLAYER, IBOPLAYER, SMARTONEPRO...)	`BOBPLAYER`
mac_address	string	body	Obrigatório	MAC do dispositivo no formato XX:XX:XX:XX:XX:XX	`11:22:33:44:55:66`
playlist_name	string	body	Obrigatório	Nome exibido no aplicativo	`Lista Premium Cliente VIP`
server_dns	string	body	Obrigatório	URL do servidor Xtream Codes	`http://servidor.exemplo.com:8080`
xtream_user	string	body	Obrigatório	Usuário do Xtream Codes	`usuario_xtream`
xtream_pass	string	body	Obrigatório	Senha do Xtream Codes	`senha_xtream`
pin	string	body	Opcional	PIN de proteção da playlist (opcional)	`1234`
Server_Key	string	body	Obrigatório	Chave de autenticação do servidor	`sua-chave-de-autenticacao-aqui`

📤 Exemplo de Requisição ▼

POST /api/v1/webhook

{
  "app_platform": "BOBPLAYER",
  "mac_address": "11:22:33:44:55:66",
  "playlist_name": "Lista Premium Cliente VIP",
  "server_dns": "http://servidor.exemplo.com:8080",
  "xtream_user": "usuario_xtream",
  "xtream_pass": "senha_xtream",
  "pin": "1234",
  "Server_Key": "sua-chave-de-autenticacao-aqui"
}

cURL

curl -X POST https://api.envialista.com/api/v1/webhook \
  -H "Content-Type: application/json" \
  -d '{
    "app_platform": "BOBPLAYER",
    "mac_address": "11:22:33:44:55:66",
    "playlist_name": "Lista Premium Cliente VIP",
    "server_dns": "http://servidor.exemplo.com:8080",
    "xtream_user": "usuario_xtream",
    "xtream_pass": "senha_xtream",
    "pin": "1234",
    "Server_Key": "sua-chave-de-autenticacao-aqui"
  }'

✅ Respostas ▼

200 Sucesso

Response

{
  "status": true,
  "statusCode": "00000",
  "msg": "Playlist saved successfully"
}

401 Server_Key inválida ou servidor inativo

Response

{
  "status": false,
  "msg": "Acesso negado. Server_Key inválida ou inativa."
}

422 Campos obrigatórios ausentes

Response

{
  "status": false,
  "msg": "Campos obrigatórios não informados.",
  "campos_faltantes": ["mac_address", "server_dns"]
}

POST https://api.envialista.com/api/v1/check-device — Consultar Dados do Dispositivo

▼

Consulta informações completas do dispositivo incluindo dados do aplicativo, vencimento e status. Retorna informações detalhadas sobre a configuração e status atual.

🔒 Server_Key — Envie a Server_Key dentro do body JSON.

📥 Body Parameters ▼

Campo	Tipo	Local	Status	Descrição	Exemplo
app_platform	string	body	Obrigatório	Nome do aplicativo (ex: BOBPLAYER)	`BOBPLAYER`
mac_address	string	body	Obrigatório	MAC do dispositivo (XX:XX:XX:XX:XX:XX)	`11:22:33:44:55:66`
Server_Key	string	body	Obrigatório	Chave de autenticação do servidor	`sua-chave-de-autenticacao-aqui`

📤 Exemplo de Requisição ▼

POST /api/v1/check-device

{
  "app_platform": "BOBPLAYER",
  "mac_address": "11:22:33:44:55:66",
  "Server_Key": "sua-chave-de-autenticacao-aqui"
}

cURL

curl -X POST https://api.envialista.com/api/v1/check-device \
  -H "Content-Type: application/json" \
  -d '{
    "app_platform": "BOBPLAYER",
    "mac_address": "11:22:33:44:55:66",
    "Server_Key": "sua-chave-de-autenticacao-aqui"
  }'

✅ Respostas ▼

200 Sucesso

Response

{
  "status": true,
  "device": {
    "mac_address": "11:22:33:44:55:66",
    "expiration_date": "2026-12-31",
    "days_remaining": 229,
    "is_active": true,
    "last_connection": "2026-05-15 14:30:00"
  }
}

401 Server_Key inválida

Response

{
  "status": false,
  "msg": "Acesso negado. Server_Key inválida ou inativa."
}

422 Dispositivo não encontrado

Response

{
  "status": false,
  "msg": "Dispositivo não encontrado no sistema.",
  "mac_address": "11:22:33:44:55:66"
}

📡 Apps — Endpoints relacionados a aplicações

GET https://api.envialista.com/wp-json/all/api/v1/apps — Listar Apps

▼

Retorna a lista completa de aplicações disponíveis na conta.

Com a lista obtida neste endpoint você pode preencher o campo app_platform nos demais endpoints que exigem a identificação do aplicativo.

🔒 Server_Key — Envie o token no header Authorization: Bearer {Server_Key}

📋 Headers ▼

Campo	Tipo	Local	Status	Descrição	Exemplo
Authorization	string	header	Obrigatório	Token de autenticação da conta.	`Bearer eyJhbGci...`

✅ Respostas ▼

200 Sucesso

Response

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Meu App Principal",
      "slug": "meu-app-principal",
      "status": "active"
    },
    {
      "id": 2,
      "name": "App de Testes",
      "slug": "app-de-testes",
      "status": "inactive"
    }
  ],
  "total": 2
}

401 Não autorizado

Response

{
  "success": false,
  "message": "Token inválido ou ausente."
}

🔐 Autenticação

Regra	Descrição
Formato	String alfanumérica de 32 caracteres
Localização	Dentro do body JSON como campo Server_Key
Validação	Verificada no banco de dados (servidor deve estar ativo)
Bloqueio	Servidores inativos ou com key inválida são recusados

⚡ Limites e Observações

Item	Detalhe
Rate Limit	10 requisições por minuto por Server_Key
Timeout	~15 segundos (inclui resolução de captcha)
Content-Type	application/json (obrigatório)
Método	POST para envio, GET para consulta
HTTPS	Obrigatório (SSL/TLS)
API Gateway	Requisições são processadas através de gateway seguro

💬 Suporte e Contato

Canal	Informação
WhatsApp	+55 31 99997-5164
Email	base64system@gmail.com
API Endpoint	https://api.envialista.com/api/v1/webhook
Status da API	https://api.envialista.com/api/v1/status
Documentação	https://envialista.com/docs/
Site Oficial	https://envialista.com