Para desenvolvedores

API Reference

Integre nosso gerador ao seu site ou bot com endpoints simples e seguros.

Minhas API Keys

Base URL

/api/v1

Auth Header

x-api-key

Rate limit

por plano · por minuto

Endpoints

GET/api/v1/services

Lista serviços ativos com estoque disponível

curl -H "x-api-key: SUA_API_KEY" https://SEU_DOMINIO/api/v1/services
{
  "success": true,
  "services": [
    { "id": "svc123", "name": "Netflix", "icon": "🎬", "stockAvailable": 42 }
  ]
}

GET/api/v1/stock/availability?serviceId=ID

Verifica disponibilidade e métricas de estoque

curl -H "x-api-key: SUA_API_KEY" "https://SEU_DOMINIO/api/v1/stock/availability?serviceId=svc123"
{
  "success": true,
  "service": { "id": "svc123", "name": "Netflix" },
  "availability": { "available": 42, "total": 120, "isAvailable": true }
}

POST/api/v1/generate

Gera credenciais do serviço escolhido

curl -X POST -H "x-api-key: SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{ "serviceId": "svc123" }' https://SEU_DOMINIO/api/v1/generate
{
  "success": true,
  "account": {
    "username": "user@example.com",
    "password": "secret"
  },
  "usage": { "used": 11, "limit": 100, "remaining": 89 }
}

GET/api/v1/history?page=1&limit=20

Histórico das suas gerações (sem credenciais)

curl -H "x-api-key: SUA_API_KEY" https://SEU_DOMINIO/api/v1/history

GET/api/v1/status

Quota, rate limit e estado da API key

curl -H "x-api-key: SUA_API_KEY" https://SEU_DOMINIO/api/v1/status

Segurança & Limites

IP whitelist por key

Restringe origens permitidas

allowedServiceIds

Limita serviços por chave

Rate limit

Por plano e por minuto

Limite mensal

Gerações por API key

Quantidade máx

API keys ativas por plano

Logs detalhados

IP + user-agent por chamada

Exemplos

import axios from 'axios'
const api = axios.create({
  baseURL: 'https://SEU_DOMINIO/api/v1',
  headers: { 'x-api-key': process.env.API_KEY }
})
const { data: services } = await api.get('/services')
const svc = services.services[0].id
const { data: avail } = await api.get('/stock/availability', { params: { serviceId: svc } })
if (avail.availability.isAvailable) {
  const { data: gen } = await api.post('/generate', { serviceId: svc })
  console.log(gen.account)
}

Boas práticas

Implemente retry respeitando o retryAfter em respostas 429
Cacheie respostas de serviços e disponibilidade por alguns segundos
Não exponha sua API key em clientes — use um backend
Registre logs de falhas e sucesso para suporte