A API do plicflix

• Endereço: https://api.plicflix.com
• Formato: JSON (Content-Type: application/json), UTF-8. Erros sempre no formato {"erro": "mensagem"} e, quando há um motivo para máquinas, {"erro": "…", "codigo": "…"}.
• Corpo: no máximo 64 KiB; campos desconhecidos são recusados (400).
• Dinheiro: em centavos. Mês: AAAA-MM, fuso de Brasília.
• Limites: cadastro, login e troca pelo navegador têm limite por IP (429 ao passar).
• Para máquinas: /openapi.json (OpenAPI 3.1).

Rotas do estúdio (o SEU servidor)

Autenticação: Authorization: Bearer pk_… (a chave do painel). Só no servidor.

POST /v1/ingresso/trocar — a troca do token

POST /v1/ingresso/trocar
Authorization: Bearer pk_…
Content-Type: application/json

{"token":"pft_…"}

• jogador.id: pf_ + 24 caracteres; fixo para essa pessoa no seu jogo e diferente em cada jogo.
• jogador.nome: o apelido (até 24 letras); pode mudar.
• assinante: false para testadores sem assinatura.

GET /v1/parceiro/jogos

Os seus jogos: {"parceiro":"Seu Estúdio","jogos":[{"slug","nome","url","tipo","ativo","situacao","motivo_recusa","status","status_url"}]}. situacao: rascunho, em_revisao, recusado ou publicado. status: o que a vigia viu (online, instavel, offline ou vazio).

PUT /v1/parceiro/jogos/{slug}

Edita a vitrine. Parcial: só os campos enviados mudam; os omitidos ficam como estão. As imagens e o vídeo só mudam pelo painel (onde a qualidade é conferida). Campos: nome, subtitulo, descricao, descricao_longa, estudio, generos[], tags[], classificacao, plataformas[], multijogador, cor, status_url. Regras em VITRINE. Não muda url, slug nem a situação.

GET /v1/parceiro/casos

Os casos de reclamação: {"casos":[{"id","jogo","mes","situacao","aberto_em","prazo","prova","prova_em","decidido_em","motivos":[…]}]}. situacao: aberto, em_analise, corrigido ou perdido.

POST /v1/parceiro/casos/{id}/prova

{"prova":"o que mudou e como conferir"} → 200 {"situacao":"em_analise"}. Fora do prazo: 409.

GET /v1/parceiro/repasses

O extrato: {"repasses":[{"mes":"2026-11","jogo":"seu-slug","jogadores":120,"segundos":431000,"pago_centavos":53210,"retido_centavos":0}]}.

Rota do navegador (jogos sem servidor)

POST /v1/ingresso/navegador

{"token":"pft_…"}, chamada pela página do jogo (o Plicflix.jogador() faz isso). Sem chave; o cabeçalho Origin precisa ser a origem do endereço cadastrado do jogo (senão 403). Resposta igual à da troca, mais "pelo_navegador": true. Veja MOTORES.

Entrar com Plicflix (OAuth 2.0 + PKCE)

O login fora do app (o seu site, o seu app nativo). O guia completo, com exemplos, está em OAUTH.

Pública

Testar pela API

Para um teste automático do seu jogo sem o app, faça a parte do jogador pela API com uma conta testadora do seu jogo (passo 8 do COMECE). Autenticação do jogador: Authorization: Bearer <token da conta>.

API=https://api.plicflix.com
# 1. entrar (a conta já criada e com o e-mail confirmado; testadora do jogo)
TOK=$(curl -s -X POST $API/v1/entrar -d '{"email":"voce@estudio.com","senha":"…"}' | jq -r .token)
# 2. "tocar em Jogar": devolve a URL que o app abriria
curl -s -X POST $API/v1/jogos/SEU-SLUG/jogar -H "Authorization: Bearer $TOK" -d '{"plataforma":"web"}'
# → {"partida":"pt_…","url":"https://seu-jogo/?ref=plicflix#plicflix=pft_…&pf_idioma=pt-BR&pf_plataforma=web&pf_api=…", …}
# 3. abra essa URL num navegador automatizado (Playwright, Puppeteer) DENTRO de um iframe
#    numa página https de outro site, ou mande o token direto para a sua rota:
curl -s -X POST https://seu-jogo/api/plicflix/entrar -d '{"token":"pft_…"}'

O que o app faz durante a partida (para reproduzir num teste):

Uma partida vale até o fim ou até a mesma conta abrir outra (um jogador só joga uma coisa por vez): depois disso, as rotas dela respondem 410 {"erro":"partida encerrada"}.

As rotas da conta do jogador (POST /v1/contas, /v1/eu/confirmar, /v1/senha/esqueci etc.) estão no /openapi.json.

Os códigos de erro mais comuns