Integre sua revenda ao Juba Player

GET /partner/me

Consultar conta e saldo

Retorna nome e créditos disponíveis da conta autenticada. Não altera saldo.

curl --fail-with-body -X GET 'https://jubaplayer.com/api/v1/partner/me' -H "x-api-key: $JUBA_API_KEY"

Resposta 200 · dados fictícios

{
  "name": "Revenda Exemplo",
  "credits": 30
}

GET /partner/devices/{deviceId}

Consultar licença de aparelho vinculado

Somente aparelhos com pelo menos uma ativação deste revendedor (API ou painel). Aparelhos inexistentes e sem vínculo retornam o mesmo 404. A resposta não contém listas, senhas ou chave do aparelho.

deviceId · path · obrigatório: Seis pares hexadecimais separados por dois-pontos.

curl --fail-with-body -X GET 'https://jubaplayer.com/api/v1/partner/devices/aa:bb:cc:dd:ee:ff' -H "x-api-key: $JUBA_API_KEY"

Resposta 200 · dados fictícios

{
  "deviceId": "aa:bb:cc:dd:ee:ff",
  "license": {
    "status": "active",
    "plan": "annual",
    "registeredAt": "2026-11-11T12:00:00.000Z",
    "expiresAt": "2027-11-11T12:00:00.000Z"
  }
}

POST /partner/activate

Ativar ou renovar um aparelho

Consome 1 crédito e acrescenta 365 dias na configuração atual. Se a licença ainda for válida, soma ao vencimento; se expirada, começa agora. O aparelho precisa existir (abrir o app e sincronizar antes). Use Idempotency-Key em toda ativação. A operação real debita saldo; não há modo de simulação neste endpoint.

Idempotency-Key · header · opcional: Fortemente recomendado. 8–128 caracteres: letras ASCII, números, ponto, sublinhado, dois-pontos ou hífen. Use um UUID por pedido e persista antes de enviar. Mesmo revendedor + mesma chave + mesmo aparelho retorna a resposta original sem novo débito, inclusive após rotação da API key. Mesma chave com outro aparelho retorna 409. Registro de sucesso conservado enquanto a conta existir; respostas de falha não reservam a chave. Sem cabeçalho, cada POST é uma nova ativação (compatibilidade).

curl --fail-with-body -X POST 'https://jubaplayer.com/api/v1/partner/activate' -H "x-api-key: $JUBA_API_KEY" -H 'Idempotency-Key: a4939de8-394c-4fa5-aa09-21f78433b6db' -H 'Content-Type: application/json' --data '{"deviceId":"aa:bb:cc:dd:ee:ff"}'

Resposta 200 · dados fictícios

{
  "deviceId": "aa:bb:cc:dd:ee:ff",
  "license": {
    "status": "active",
    "plan": "annual",
    "registeredAt": "2026-11-11T12:00:00.000Z",
    "expiresAt": "2027-11-11T12:00:00.000Z"
  },
  "creditsLeft": 29
}

POST /partner/management-invitations

Solicitar autorização de gestão

Cria link de uso único válido por 30 minutos. Entregue approvalUrl ao cliente, que deve autenticar o próprio aparelho e aprovar explicitamente. Nunca solicite sua chave de seis dígitos. Reemitir expira o convite anterior da mesma conta/aparelho. Não concede acesso por si só. Limite de escrita: 20/min por conta.

curl --fail-with-body -X POST 'https://jubaplayer.com/api/v1/partner/management-invitations' -H "x-api-key: $JUBA_API_KEY" -H 'Content-Type: application/json' --data '{"deviceId":"aa:bb:cc:dd:ee:ff"}'

Resposta 201 · dados fictícios

{
  "id": "d6f7d632-522c-445a-9664-2cf7adef2f62",
  "expiresAt": "2026-11-11T12:00:00.000Z",
  "approvalUrl": "https://jubaplayer.com/entrar#gestao=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

GET /partner/managed-devices

Listar aparelhos sob gestão

Somente vínculos atuais; gestão não implica histórico de ativação. Página de 50 itens, ordenada por vínculo mais recente.

page · query · opcional: Página, começando em 1.

curl --fail-with-body -X GET 'https://jubaplayer.com/api/v1/partner/managed-devices' -H "x-api-key: $JUBA_API_KEY"

Resposta 200 · dados fictícios

{
  "total": 1,
  "pageSize": 50,
  "items": [
    {
      "deviceId": "aa:bb:cc:dd:ee:ff",
      "managementId": "d6f7d632-522c-445a-9664-2cf7adef2f62",
      "grantedAt": "2026-11-11T12:00:00.000Z",
      "grantedBy": "admin"
    }
  ]
}

GET /partner/devices/{deviceId}/playlists

Listar metadados das próprias listas

Exige vínculo atual. Retorna somente listas criadas durante este vínculo, sem URLs ou credenciais. Listas do cliente, do admin e de outros vínculos não aparecem. Limite de leitura: 60/min por conta.

deviceId · path · obrigatório: ID do aparelho autorizado.

curl --fail-with-body -X GET 'https://jubaplayer.com/api/v1/partner/devices/aa:bb:cc:dd:ee:ff/playlists' -H "x-api-key: $JUBA_API_KEY"

Resposta 200 · dados fictícios

[
  {
    "id": "d6f7d632-522c-445a-9664-2cf7adef2f62",
    "name": "Minha lista",
    "type": "m3u",
    "createdAt": "2026-11-11T12:00:00.000Z",
    "managementId": "d6f7d632-522c-445a-9664-2cf7adef2f62"
  }
]

POST /partner/devices/{deviceId}/playlists

Adicionar lista remota

Exige vínculo atual. Só listas criadas pela revenda durante este vínculo podem ser alteradas. Revogação/transferência preserva listas, mas corta acesso; nova autorização não recupera acesso a listas de vínculos antigos. Máximo de 20 listas remotas por aparelho (inclui todas as origens). Corpo completo M3U, Xtream ou código de provedor ativo. URLs e credenciais são somente de escrita. Limite de escrita: 20/min por conta, compartilhado com convites e painel. POST não implementa Idempotency-Key: após timeout consulte as listas antes de repetir, pois pode duplicar. Salve o id retornado.

deviceId · path · obrigatório: ID do aparelho autorizado.

curl --fail-with-body -X POST 'https://jubaplayer.com/api/v1/partner/devices/aa:bb:cc:dd:ee:ff/playlists' -H "x-api-key: $JUBA_API_KEY" -H 'Content-Type: application/json' --data '{"type":"m3u","name":"Minha lista","url":"https://example.com/lista.m3u"}'

Resposta 201 · dados fictícios

{
  "id": "d6f7d632-522c-445a-9664-2cf7adef2f62"
}

PUT /partner/devices/{deviceId}/playlists/{id}

Substituir dados da própria lista

Exige vínculo atual. Só listas criadas pela revenda durante este vínculo podem ser alteradas. Revogação/transferência preserva listas, mas corta acesso; nova autorização não recupera acesso a listas de vínculos antigos. Máximo de 20 listas remotas por aparelho (inclui todas as origens). Corpo completo M3U, Xtream ou código de provedor ativo. URLs e credenciais são somente de escrita. Limite de escrita: 20/min por conta, compartilhado com convites e painel. Envie todos os campos; preserva o ID. Repetir PUT com o mesmo conteúdo mantém o estado.

deviceId · path · obrigatório: ID do aparelho autorizado.

id · path · obrigatório: UUID da lista retornado na criação.

curl --fail-with-body -X PUT 'https://jubaplayer.com/api/v1/partner/devices/aa:bb:cc:dd:ee:ff/playlists/d6f7d632-522c-445a-9664-2cf7adef2f62' -H "x-api-key: $JUBA_API_KEY" -H 'Content-Type: application/json' --data '{"type":"m3u","name":"Minha lista","url":"https://example.com/lista.m3u"}'

Resposta 200 · dados fictícios

{
  "id": "d6f7d632-522c-445a-9664-2cf7adef2f62"
}

DELETE /partner/devices/{deviceId}/playlists/{id}

Remover a própria lista

Exige vínculo atual e lista criada nele. Sem corpo JSON. Retorna 204; repetir após sucesso retorna 404. Não remove listas locais da TV.

deviceId · path · obrigatório: ID do aparelho autorizado.

id · path · obrigatório: UUID da lista retornado na criação.

curl --fail-with-body -X DELETE 'https://jubaplayer.com/api/v1/partner/devices/aa:bb:cc:dd:ee:ff/playlists/d6f7d632-522c-445a-9664-2cf7adef2f62' -H "x-api-key: $JUBA_API_KEY"

Resposta 204 · dados fictícios

Sem corpo.