Autenticação
Credencial, access token e refresh token.
Gere uma credencial
No workspace, o dono ou um administrador gera uma credencial: uma API Key (mdk_…)
e um Secret (mds_…). O secret aparece uma única vez, na criação — guarde-o num
cofre. Perdeu o secret, gere outra credencial e revogue a antiga.
Troque a credencial por tokens
POST /auth/token devolve um par de tokens.
Envie o access token
Em toda chamada: Authorization: Bearer mda_…. Ele vale 1 hora.
Renove pelo refresh token
Quando o access token expirar, use o refresh token (mdr_…, válido por 30 dias) em
POST /auth/refresh. Cada refresh gera um par novo e invalida o anterior; o mesmo refresh
enviado duas vezes ao mesmo tempo gera par novo para uma só das chamadas.
Revogar a credencial derruba na hora todos os tokens emitidos com ela.