Pular para o conteúdo principal

Autenticação

Toda requisição leva a credencial no header Authorization:

GET /api/v1/imoveis HTTP/1.1
Host: admin.independenceimoveis.com.br
Authorization: Bearer ind_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Regras da credencial​

  • Nunca vai na URL nem na query string: URLs aparecem em logs.
  • Vale até ser revogada. Não expira.
  • É exclusiva do parceiro e dá acesso apenas a esta API de imóveis.
  • A Independence mostra o token uma única vez, no momento da emissão. Guarde-o num cofre de senhas. Se ele for perdido, é preciso emitir outro.
  • Troca sem interrupção: peça uma credencial nova, coloque-a em uso e avise a Independence. A antiga é revogada só depois que a nova estiver funcionando.

Respostas de erro de autenticação​

SituaçãoHTTPCorpo
Header ausente401{"mensagem": "Credencial ausente: envie Authorization: Bearer <token>."}
Credencial inválida ou revogada401{"mensagem": "Credencial inválida."}

A revogação vale na requisição seguinte, sem cache.