Lion Flex — Documentação Oficial da API

🔑 1. Autenticação na API & Regra de Créditos

Todas as chamadas aos endpoints de troca de nome exigem sua chave de API ativa (flx_live_...), enviada no cabeçalho HTTP:

x-api-key: flx_live_9b0e271a5f6e8c7438db02c918a

🛡️ Política de Cobrança Justa:

• Cada alteração de nome confirmada com sucesso consome 1 crédito.
• Se a conta do motorista estiver bloqueada pela Amazon, senha inválida ou token incorreto, NENHUM crédito é cobrado.
• Caso seu saldo atinja 0, a API responde com HTTP 402 Payment Required.

NOVO

🦊 2. Como Gerar o Link de Login Amazon e Obter o Token

Para trocar o nome de um motorista na Amazon Flex, seu bot ou aplicação precisa do Token de Sessão do Motorista (conhecido tecnicamente como Refresh Token, que sempre se inicia com Atnr|...).

1 Como Funciona o Fluxo Oficial de Login da Amazon (OAuth 2.0 PKCE)

1. Você gera a URL oficial de login da Amazon Flex configurada com PKCE (código SHA-256 e serial de dispositivo emulado).
2. Você envia esse link para o motorista (no WhatsApp ou no seu sistema).
3. O motorista abre o link, digita o e-mail e senha da conta Amazon Flex e resolve a verificação.
4. Ao concluir com sucesso, a Amazon tenta redirecionar para a página do app:
https://www.amazon.com/ap/maplanding?openid.oa2.code=ANc12345678...
5. O motorista (ou seu sistema) copia essa URL e envia para a troca: a Amazon entrega o Refresh Token oficial (Atnr|...).

📋 Opção A: Scripts Prontos para Copiar e Colar (Standalone)

Se você prefere que o seu próprio robô faça tudo de forma independente, disponibilizamos scripts 100% prontos que utilizam apenas bibliotecas nativas (sem precisar instalar nada):

Script Node.js pronto para execução direta:

⚡ Opção B: Gerador Interativo Direto pelo Navegador

Você também pode testar e gerar o token agora mesmo usando a ferramenta abaixo:

Passo 1: Gerar o link oficial de login da Amazon:

POST

3. /api/v1/name-change

Executa a atualização instantânea do nome cadastral do motorista usando o token obtido na etapa anterior.

Campo	Tipo	Obrigatório	Descrição
accountToken	string	Sim	Token de login do motorista obtido no Passo 2 (inicia com `Atnr\|...`).
firstName	string	Sim	Primeiro nome legal do motorista (ex: Carlos).
middleName	string	Não	Nome do meio (opcional).
lastName	string	Sim	Sobrenome legal do motorista (ex: Silva).

Exemplo de Resposta de Sucesso (HTTP 200 OK):

{
  "ok": true,
  "status": "COMPLETED",
  "message": "Nome atualizado com sucesso.",
  "before": { "firstName": "Jose", "lastName": "Souza" },
  "after": { "firstName": "Carlos", "middleName": "Eduardo", "lastName": "Silva" },
  "creditsRemaining": 14,
  "transactionId": "tx_1700000000",
  "timestamp": "2026-10-02T22:00:00.000Z"
}

GET

4. /api/v1/credits

Consulta o saldo de créditos disponível na sua conta em tempo real.

{
  "ok": true,
  "account": { "email": "cliente@dominio.com", "credits": 25, "active": true },
  "key": { "name": "Chave Producao", "createdAt": "2026-10-01T12:00:00.000Z" }
}

GET

5. /api/v1/plans

Lista os pacotes de créditos ativos, promoções e cupons para checkout automatizado.

GET /api/v1/plans?promo=VIP20

API de Automação de Troca de Nomes & Token Amazon