# 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:

1. **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.
2. **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:

1. **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:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-comment"><a href="https://catalogo-staging-1062351960128.us-east1.run.app/">https://catalogo-staging-1062351960128.us-east1.run.app/</a></span>`</div></div>
2. **Genera un token de acceso** (siguiendo la guía de [Autenticación](https://docs.digital.gob.do/books/manual-de-integracion-api/page/autenticacion)).  
    Este token será necesario para consumir cualquier endpoint protegido.
3. **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:

1. Solicita a OGTIC la habilitación de tu usuario para **producción**.
2. 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](https://docs.digital.gob.do/books/manual-de-integracion-api/page/autenticacion#bkmrk-recupere-nuevo-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**.