OneProvider

Referência de métodos da API de revenda

Todos os endpoints da API de revenda em uma tabela, com escopo e flag de idempotência, e a especificação OpenAPI 3.1 da OneProvider, pronta para importar.

Todos os endpoints da API de revendedores em uma só tabela, com a permissão e o indicador de idempotência de cada um, e um link para a especificação OpenAPI 3.1.

Todos os modelos, recursos e preços Índice da documentação para agentes de IA: https://oneprovider.dev/docs/llms.txt

Base URL: https://app.oneprovider.dev/partner/v1. Especificação OpenAPI 3.1 legível por máquina: https://app.oneprovider.dev/partner/v1/openapi.yaml (pública, não exige token).

A coluna “Idempotency” marca os métodos que exigem o cabeçalho Idempotency-Key. A permissão “any” significa qualquer token válido, “none” significa que nenhum token é necessário.

Métodos da API
MétodoCaminhoScopeIdempotencyFinalidade
GET/meany-Token, permissões, revendedor.
GET/balanceread-Saldo de revendedor, reservado, disponível, preço de atacado, formas de pagamento para recarga.
GET/balance/transactionsread-Transações do saldo (cursor).
POST/balance/topupsbillingobrigatórioCria um pagamento de recarga, retorna pay_url.
GET/balance/topups/{order_id}billing-Status do seu próprio pagamento.
GET/pricingread-Preço de atacado, desconto, limites.
GET/modelsread-Catálogo de modelos e status ao vivo.
GET/customersread-Lista os clientes (?external_id=).
GET/customers/{id}read-Um cliente.
POST/customerskeys-Cria um cliente.
PATCH/customers/{id}keys-Edita nome, nota, bloqueio (blocked).
GET/customers/{id}/usageread-Consumo de um cliente em todas as chaves ativas dele, por dia e por modelo (?days=1..90).
GET/keysread-Lista as chaves (?status=, ?query=, ?customer_id=).
GET/keys/{id}read-Uma chave sem o segredo, com dashboard_url.
GET/keys/{id}/usageread-Consumo diário e por modelo de uma chave (?days=1..90, padrão 30).
POST/keyskeysobrigatórioEmite uma chave; o segredo é retornado uma vez.
POST/keys/bulkkeysobrigatórioEmite várias chaves idênticas de uma vez.
PATCH/keys/{id}keys-Limite, validade (expires_days/hours) ou prorrogação (extend_days/hours), nome, rótulo do cliente.
DELETE/keys/{id}keys-Exclui uma chave (200 ou 202).
POST/keys/{id}/topupkeysobrigatórioSoma um valor ao limite da chave.
POST/keys/{id}/rotatekeysobrigatórioReemite uma chave: novo segredo, o antigo deixa de funcionar.
POST/keys/{id}/pausekeys-Pausa uma chave.
POST/keys/{id}/resumekeys-Retoma uma chave.
POST/orderskeysobrigatórioUm pedido pago de cliente: chave nova ou recarga.
GET/ordersread-Lista os pedidos (?external_order_id=).
GET/orders/{id}read-Um pedido.
GET/plansread-Os seus planos.
POST/plansplans-Cria um plano.
PATCH/plans/{id}plans-Edita um plano.
DELETE/plans/{id}plans-Exclui um plano.
GET/code-batchescodes-Lista os lotes de códigos.
POST/code-batchescodesobrigatórioCria um lote de códigos.
GET/code-batches/{id}codes-Um lote.
GET/code-batches/{id}/codescodes-Códigos de um lote (?status=).
POST/code-batches/{id}/revokecodes-Revoga os códigos não resgatados.
GET/codes/{code}codes-Status de um código.
POST/codes/{code}/redeemcodesobrigatórioResgata um código em uma chave.
GET/statsread-Estatísticas diárias (?days=1..90).
GET/auditread-Registro de ações (filtros period, actor, action, q).
GET/botbot-O bot de vendas e o bot de suporte (sem tokens).
GET/settingsread-Configurações da loja: nome, contato, marca, prefixo da chave, mensagem ao cliente.
PATCH/settingskeys-Edita as configurações da loja (só os campos enviados).
GET/payment-providersbot-Formas de pagamento do bot: CryptoBot, xRocket, Platega (sem tokens); Stars estão sempre ativadas.
GET/webhookswebhooks-Lista os webhooks.
POST/webhookswebhooks-Cria um webhook; o segredo é exibido uma vez.
DELETE/webhooks/{id}webhooks-Exclui um webhook.
POST/webhooks/{id}/testwebhooks-Envia um evento de teste.
GET/webhooks/{id}/deliverieswebhooks-Registro de entregas.
GET/openapi.yamlnone-Especificação OpenAPI 3.1 (pública).

As regras comuns (paginação, erros, limites) estão descritas em Autorização e limites .

Última atualização: 2026-11-08 Encontrou um erro? @Oneproviderhelpbot