Documentação da API

Integre dados da Serenys List diretamente em suas aplicações. Nossa API RESTful é simples, tipada e segura.

v1.0.0 Stable

HTTPS Only

Autenticação

Todos os endpoints da API requerem autenticação via API Key. Você deve enviar sua chave no cabeçalho HTTP Authorization.

Segurança da Chave

Suas chaves de API carregam privilégios de escrita. Nunca as compartilhe em repositórios públicos ou no client-side (navegador).

Formato do Header

1const headers = {
2  "Authorization": "Bearer acq_a1b2c3..."
3};

Rate Limits

Implementamos limites de taxa para garantir a estabilidade do serviço.

Autenticado: 60 requisições / minuto por chave.

Headers incluídos: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

POST

/bots/:id/stats

Atualize a contagem de servidores e shards do seu bot.

1await fetch('https://acq.lat/api/v1/bots/123/stats', {
2  method: 'POST',
3  headers: {
4    'Authorization': 'Bearer acq_KEY',
5    'Content-Type': 'application/json'
6  },
7  body: JSON.stringify({ serverCount: 1500 })
8});

POST

/bots/:id/commands

Sincronize os comandos (slash commands) do seu bot. Substitui a lista atual.

1await fetch('https://acq.lat/api/v1/bots/123/commands', {
2  method: 'POST',
3  headers: {
4    'Authorization': 'Bearer acq_KEY',
5    'Content-Type': 'application/json'
6  },
7  body: JSON.stringify([
8    { name: 'ping', description: 'Pong!' }
9  ])
10});

GET

/bots/:id

Obtém informações de um bot.

1const res = await fetch('https://acq.lat/api/v1/bots/123', {
2  headers: { 'Authorization': 'Bearer acq_KEY' }
3});
4const data = await res.json();

GET

/users/:id

Obtém informações públicas de um usuário.

1const res = await fetch('https://acq.lat/api/v1/users/123', {
2  headers: { 'Authorization': 'Bearer acq_KEY' }
3});