​
Metodo de Autenticacao

A API do Real Oficial utiliza Bearer Token para autenticacao. Apos fazer login, voce recebera um token que deve ser enviado em todas as requisicoes subsequentes.

​
Obtendo seu Token

1

Crie uma conta

Registre-se em app.realoficial.com.br.
2

Obtenha seu token

Use o endpoint /login para obter seu token ou acesse Configuracoes > Seguranca no dashboard.
3

Use o token

Inclua o token no header Authorization de todas as requisicoes.

​
Formato do Header

Todas as requisicoes autenticadas devem incluir o header Authorization: 
Authorization: Bearer SEU_TOKEN_AQUI

​
Exemplo de Requisicao

curl -X GET "https://api.realoficial.com.br/api/v1/user" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json"

​
Tokens e Seguranca

Seu token e permanente. Uma vez gerado, seu token nao expira e permanece o mesmo. Guarde-o em um local seguro.
Mantenha seu token seguro! Nunca compartilhe ou exponha seu token em codigo publico, repositorios Git ou logs.

​
Boas praticas

Variaveis de ambiente

Armazene tokens em variaveis de ambiente, nunca no codigo

HTTPS apenas

Sempre use HTTPS para todas as requisicoes

Token fixo

Seu token e permanente e nao expira, guarde-o com seguranca

Monitoramento

Monitore o uso da sua conta para detectar acessos nao autorizados

​
Codigos de Erro de Autenticacao

CodigoDescricao
401Token invalido ou ausente
403Token valido mas sem permissao para o recurso

​
Exemplo de resposta de erro

{
  "error": "Token invalido ou expirado"
}

​
Proximos passos

Login

Faca login e obtenha seu token

Criar Projeto

Comece criando seu primeiro projeto