Identificar a conta (dados do seller)
GET
{{base_url}}/api/auth/me
Autenticação
Bearer pela sua API Key real (vk_live_* produção, vk_test_* sandbox). Crie a chave em https://app.dotfy.com.br/dashboard/chaves-api. Sem o header → 401. Com chave inválida/revogada → 401. Com chave sem o escopo necessário → 403 insufficient_scope.Identificar a conta
200 = chave válida, 401 = inválida/revogada/expirada).id, email, taxId (CPF/CNPJ), companyId e o adquirente (acquirer) atribuído à sua conta — informação útil para construir UIs de "painel do seller" sem hardcodar.Resposta
authenticated (bool) — sempre true em sucesso.authMethod (string) — "api-key" quando autenticado via Bearer (este caso).user (object) — id, email, name, role, avatarUrl, taxId, taxIdType (CPF|CNPJ), companyId, acquirer (WOOVI|TREEAL|ASAAS|SIMPAY), onboardingStatus, disabledFeatures.impersonation.isImpersonating (bool) — sempre false para autenticação via API Key.Quer dados completos da empresa (razão social, endereço, dados do representante)? Hoje o endpoint retorna taxIdecompanyId— os campos completos de empresa estão disponíveis no dashboard. Se precisar dos dados completos via API, abra um ticket de suporte: estamos avaliando exporGET /api/selleragregado em uma próxima versão.
Requisição
Parâmetros Header
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '{{base_url}}/api/auth/me' \
--header 'Authorization: Bearer {{api_key}}'Response Response Example
200 - Sucesso (200) — chave válida (vk_test_/vk_live_)
{
"authenticated": true,
"authMethod": "api-key",
"user": {
"id": "clxxx0001",
"email": "contato@suaempresa.com.br",
"name": "Sua Empresa LTDA",
"role": "USER",
"avatarUrl": null,
"acquirer": "TREEAL",
"disabledFeatures": [],
"taxId": "12345678000190",
"onboardingStatus": "COMPLETED",
"companyId": "clcompany0001"
},
"impersonation": { "isImpersonating": false }
}Modificado em 2026-05-07 16:12:35