5 operaciones · base https://api.bestdoctorsrd.com
GET/v1/platform/oauth-clients
Lista los clientes socios
Devuelve qué clientes hay, de qué institución son y con qué ámbitos. Nunca devuelve el secreto de ninguno.
Respuestas
Código
Descripción
Devuelve
200
Respuesta correcta
OAuthClientListOut
POST/v1/platform/oauth-clients
Da de alta un cliente OAuth
Crea el cliente ligado a una institución y con los ámbitos elegidos. La respuesta trae el `client_secret` en claro: es la única vez que sale del servidor.
Cuerpo obligatorioOAuthClientCreateIn
Campo
Tipo
Obl.
tenant_id
string
Sí
name
string
Sí
scopes
lista de string
Sí
Respuestas
Código
Descripción
Devuelve
201
Respuesta correcta
OAuthClientSecretOut
404
La institución indicada no existe.
—
409
La institución está suspendida.
—
422
Ámbitos desconocidos o lista vacía.
—
GET/v1/platform/oauth-clients/scopes
Catálogo de ámbitos disponibles
Ámbitos que se pueden conceder a un cliente. Es la lista contra la que se valida el alta.
Respuestas
Código
Descripción
Devuelve
200
Respuesta correcta
lista de OAuthScopeOut
POST/v1/platform/oauth-clients/{client_pk}/revoke
Revoca un cliente
Apaga el cliente y deja constancia de quién lo revocó, cuándo y por qué. Un cliente revocado no vuelve: se da de alta uno nuevo.
Genera un secreto nuevo y devuelve el valor en claro una sola vez. El anterior deja de servir en el acto. Si el cliente todavía no tenía identidad OAuth, se le crea aquí.
Parámetros
Nombre
En
Tipo
Obl.
client_pk
path
integer
Sí
Respuestas
Código
Descripción
Devuelve
200
Respuesta correcta
OAuthClientSecretOut
404
El cliente no existe.
—
409
El cliente está revocado o su institución está suspendida.