Cómo obtener acceso (credenciales, entorno)
Para poder utilizar el API del Catálogo de Servicios del Estado Dominicano, es necesario solicitar credenciales y configurar tu entorno de acceso.
De forma predeterminada, todos los datos del catálogo están protegidos y solo algunos endpoints básicos son públicos.
1. Solicitar un usuario y credenciales
Antes de poder autenticarte en el API, debes solicitar un usuario institucional:
-
Enviar una solicitud a la División de Arquitectura de OGTIC
-
Especifica el proyecto o sistema que consumirá el API.
-
Indica el responsable técnico de la integración.
-
Proporciona un correo de contacto institucional.
-
-
Recibirás credenciales de acceso que incluyen:
-
Usuario y contraseña inicial.
-
Instrucciones para generar tu primer token de acceso.
-
Enlace al entorno de pruebas y, posteriormente, al entorno de producción.
-
2. Configurar tu entorno de desarrollo
Una vez recibidas tus credenciales:
-
Accede al entorno de pruebas (sandbox) para validar tus integraciones.
La dirección base (base URL) será indicada en el correo de la OGTIC.
Ejemplo: -
Genera un token de acceso (siguiendo la guía de Autenticación).
Este token será necesario para consumir cualquier endpoint protegido. -
Usa herramientas como Postman o cURL para probar tus primeras solicitudes antes de integrar en tu sistema.
3. Pasar a producción
Cuando tus pruebas en sandbox estén aprobadas:
-
Solicita a OGTIC la habilitación de tu usuario para producción.
-
Recibirás:
-
Nueva URL base para producción.
-
Límites y parámetros de consumo (según los SLA vigentes).
-
Credenciales actualizadas si es necesario.
-
Notas importantes
El entorno de pruebas y producción son separados; asegúrate de usar las URLs correctas en cada fase.
Los tokens expiran; debes renovarlos periódicamente (ver Actualizar token).
El uso del API está regulado por los SLA: evita consultas masivas sin autorización.
La información sobre autenticación avanzada (renovación de tokens, roles y permisos) está en el capítulo de Autenticación.