gde-token-process-api
home
TokenGDE
Descripción
La presente integración expone servicios de SADE / GDE para:
La generación del tokenGDE, método de autenticación para consumos de servicios de SADE/GDE por sistemas externos.
Esta API puede ser consumida por:
Sistemas externos que consuman servicios de SADE autorizados por la Dirección Gerenal de Integraciones de SistemasAplicaciones de Agencia de Sistemas de Información, Secretaría de Innovación y Transformación Digital, y sistemas externos de otras reparticiones del GCBA.
Runtime: 4.9
Seguridad
La API se encuentra protegida mediante políticas configuradas en API Manager.
El acceso está restringido mediante credenciales:
client_id
client_secret
Estas deben enviarse en los headers de cada request.
Endpoints disponibles
generarToken
[POST] /
El servicio permite generar un tokenGDE para consumir serivicos de SADE, a nobre de un usuario sade existente.
Parametros de Entrada:
| Parámetro | Tipo de Parámetro | Tipo de dato | Condición | Descripción | Ejemplo |
|---|---|---|---|---|---|
username | body | string | Obligatorio | 'cuit' del usuarioSADE generador del token (alfabético para usuarios de servicio) | svc_TEST_APP |
password | body | string | Obligatorio | contraseña respectiva del usuarioSADE | a09#d8hJA&SDHM |
Respuesta exitosa:
200 OK→Devuelve el tokenGDE
Interfaz de Salida
| Clave | Tipo de Dato | Condición | Descripción | Valor Ejemplo |
|---|---|---|---|---|
accessToken | string | Obligatorio | tokenGDE para declarar | eyJ0eXAiOiJK... |
refreshToken | string | Obligatorio | token para refresh (no implementado) | eyJ0eXAiOiJK... |
apoderadosToken | string | Obligatorio | no implementado | null |
aclToken | string | Obligatorio | no implementado | null |
moreInfoToken | string | Obligatorio | no implementado | null |
Ejemplo de Request
{
"username": "2012346781",
"password": "contraseniaaFuerte"
}Ejemplo de Response
{
"accessToken": "eyJ0eXAiOi...gA3K26Q4g",
"refreshToken": "eyJ0eXAiOiJKV1Q...HOzmfVSWLmg",
"apoderadosToken": null,
"aclToken": null,
"moreInfoToken": null
}Manejo de errores
La API devuelve los siguientes códigos de error estándar:
| Código | Mensaje | Descripción |
|---|---|---|
400 | Bad Request | Solicitud inválida |
401 | Authentication denied | Credenciales incorrectas o ausentes |
500 | Internal Server Error | Error interno del servidor |
504 | Gateway Timeout | Tiempo de espera excedido |
Ante consultas o inconvenientes, comunicarse con GO de Integraciones.
Notas adicionales
- El contrato de la API se encuentra definido en RAML 1.0
- Incluye ejemplos de request y response
- Diseñada para reutilización por múltiples integraciones
Historial de versionado de la documentación
| Versión | Descripción |
|---|---|
| v1 | Versión inicial |