# Ative Aqui — API de Players

> API HTTP para assinantes do Módulo de Players. Permite cadastrar aparelhos, conferir o estado nos aplicativos, gerenciar playlists e acompanhar operações em fila. Exige chave individual e escopos. Operações de escrita atuam em aparelhos reais.

## Documentação

- [Guia completo para IA](https://ativeaqui.com/llms-full.txt): autenticação, fluxo, segurança, limites, exemplos e endpoints.
- [Documentação navegável e Swagger](https://ativeaqui.com/docs/players/): introdução e referência interativa.
- [OpenAPI 3.1](https://ativeaqui.com/docs/players-openapi.yaml): contrato legível por ferramentas, com esquemas e parâmetros.
- [Gerenciar chaves](https://ativeaqui.com/painel/api/): requer sessão do assinante.

## Regras para agentes

- Nunca solicite ou exponha a chave de API, device key, senha ou URL completa de playlist em conversas e logs.
- Antes de qualquer POST, PATCH ou DELETE que altere um aplicativo, peça ao usuário o aparelho e a alteração desejada; confirme o estado e use Idempotency-Key única.
- Operações remotas retornam HTTP 202. Consulte o status; não repita uma escrita após timeout ou estado `review`.
- O Swagger permite enviar chamadas reais. Prefira leituras até receber autorização para a escrita específica.