Documentação da API.
Rotas públicas oficiais para conectar seu site, checkout próprio, bot do Discord ou automação diretamente à Cubyc usando sua Chave de API ou Token OAuth2.
1. Visão Geral & Modelo Pós-Pago
Base URL pública, funcionamento das chaves e idempotência segura.
https://cubyc.com.br/api/v1Respostas JSON UTF-8 com CORS liberado.Idempotency-KeyEnvie um ID único por pedido para evitar duplicar geração.2. Autenticação Bearer & Escopos
Mande sua chave ou token OAuth no cabeçalho Authorization de todas as rotas protegidas.
| Tipo de Token | Prefixo | Escopos & Permissões |
|---|---|---|
| Chave de API | cb_live_… | Criada no painel em Conexões › Chaves de API. Libera acesso completo às rotas v1 da conta. |
| Token OAuth2 | cba_… | Para apps autorizados pelo usuário. Respeita os escopos concedidos: perfil, chaves, email, lojas. |
3. Consultar Conta & Carteira
Retorna o plano ativo, custo por ativação e saldo disponível/reservado.
/api/v1/accountCaso precise consultar apenas os valores financeiros, use GET /api/v1/balance (escopo chaves).
{
"account": {
"id": "b7f2c1a0-...",
"name": "Sua Loja",
"plan": "pro",
"balance": 145.50,
"reservedBalance": 3.00,
"activationPrice": 1.50,
"status": "Ativo",
"canGenKeys": true
}
}4. Buscar Jogos no Catálogo
Consulta os jogos disponíveis, AppIDs, capas Steam e selos (Denuvo, Online, Auto-Fix, AAA).
/api/v1/catalogTambém acessível pelo alias GET /api/v1/games/search com os mesmos parâmetros:
| Parâmetro | Exemplo / Valores | Descrição |
|---|---|---|
q | elden | Busca por nome ou Steam AppID. |
ids | 730,1245620 | Retorna diretamente os AppIDs solicitados (até 100). |
drm | todos | drm | nativo | Filtra títulos com Denuvo ou proteção nativa Steam. |
func | todos | online | fixes | aaa | Filtra suporte a multiplayer online, fixes automáticos ou AAA. |
type | todos | jogos | dlcs | Filtra entre jogos base e DLCs. |
page / limit | 1 / 50 | Paginação (máximo 100 itens por chamada). |
5. Gerar & Consultar Chaves
Emita de 1 a 100 chaves por chamada e consulte ativações em tempo real.
/api/v1/keys/generate/api/v1/keys/statusPasse ?key=XXXXX-… ou envie POST com { "keys": ["...", "..."] } (até 20). Também disponível via GET /api/v1/keys/{code}.
/api/v1/generateGeração em combo ou por nome do jogo: { "games": ["Elden Ring", "1091500"], "quantity": 1, "isCombo": true }.
6. Webhooks de Entrada (Lojas)
URL gerada para cada conexão em Conexões › Plataformas para sincronizar vendas em tempo real.
/api/webhooks/loja/{id}Compatível com os eventos nativos da CentralCart, BukioPay, Nerix, Sharpify e Ereemby (incluindo validação opcional de assinatura HMAC configurável no modal da conexão).
7. Códigos de Resposta & Rate Limits
Falhas seguem o padrão { error: { code, message } }.
| Status | Código | Motivo |
|---|---|---|
400 | invalid_request | Parâmetro ausente ou fora do limite permitido. |
401 | unauthorized | Token Bearer inválido, expirado ou revogado. |
403 | forbidden | Escopo OAuth insuficiente ou plano sem API pública habilitada. |
404 | game_not_found / not_found | AppID não encontrado no catálogo ou chave inexistente na conta. |
429 | rate_limited | Limite de requisições atingido (120/min gerais · 30 gerações/min). |