Como mapear quem consome minhas APIs?

Você consegue mapear o consumidor de uma API por meio de client ID e/ou access token informados na requisição. Para ver as credenciais informadas, insira interceptores no fluxo da API. Isso deve ser feito na API, recurso ou operação como um todo.

Há duas formas diferentes de recuperar o client ID e/ou o access token:

  • Usando o interceptor de Log e checando os detalhes de uma requisição na aba GATEWAY TRACE do Trace de uma API; ou

  • Inserindo interceptors de validação de client ID e/ou access token e checando as credenciais na aba OVERVIEW do Trace. Os interceptores podem ser:

Neste caso, você precisa ter uma app cadastrada no Manager.

API de exemplo: Documentation Images

Na imagem abaixo, vemos o registro de uma requisição feita a um recurso em que apenas incluímos um interceptor de Log. Enviamos uma requisição com client_id e access_token em headers. No entanto, o client ID não é de nenhuma app cadastrada no Manager. No Trace da API, este é o registro da chamada:

trace no app

Clicando sobre o registro, você é direcionado à aba OVERVIEW do Trace. Como não incluímos interceptors que validam Client ID ou access token no fluxo da API, eles não são validados e nem exibidos nos campos correspondentes:

trace no app overview

Entretanto, com o interceptor de Log no fluxo, podemos ver os detalhes da requisição clicando na aba GATEWAY TRACE. O client_id e o access_token informados na requisição são exibidos nos headers:

trace no app details

Se fizermos uma chamada à API utilizando as credenciais de uma app cadastrada no Manager com validação de client ID e token, a informação é mais completa. Primeiro, adicionamos o interceptor de OAuth no fluxo do recurso que será chamado. Na requisição, informamos via header o client_ID e o access_token da app. Nesse caso, o Trace da API já exibe a app e o proprietário do token:

trace app

Clicando sobre o registro, a aba OVERVIEW exibe o client ID (criptografado em md5) e o access token:

trace app overview

Se você colocar também um interceptor de Log, poderá ver as mesmas credenciais nos detalhes da aba GATEWAY TRACE.

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]