gde-token-process-api

(0 reviews)

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 Sistemas
  • Aplicaciones 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ámetroTipo de ParámetroTipo de datoCondiciónDescripciónEjemplo
usernamebodystringObligatorio'cuit' del usuarioSADE generador del token (alfabético para usuarios de servicio)svc_TEST_APP
passwordbodystringObligatoriocontraseña respectiva del usuarioSADEa09#d8hJA&SDHM

Respuesta exitosa:

  • 200 OKDevuelve el tokenGDE
Interfaz de Salida
ClaveTipo de DatoCondiciónDescripciónValor Ejemplo
accessTokenstringObligatoriotokenGDE para declarareyJ0eXAiOiJK...
refreshTokenstringObligatoriotoken para refresh (no implementado)eyJ0eXAiOiJK...
apoderadosTokenstringObligatoriono implementadonull
aclTokenstringObligatoriono implementadonull
moreInfoTokenstringObligatoriono implementadonull

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ódigoMensajeDescripción
400Bad RequestSolicitud inválida
401Authentication deniedCredenciales incorrectas o ausentes
500Internal Server ErrorError interno del servidor
504Gateway TimeoutTiempo 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ónDescripción
v1Versión inicial

Reviews