🚀 Primeros Pasos con MATICERTS

Bienvenido a MATICERTS, la plataforma moderna para emisión y gestión de certificados digitales. Esta documentación te guiará paso a paso para integrar nuestra API REST en tu aplicación.

¿Qué es MATICERTS?

MATICERTS es una solución empresarial que permite emitir, validar y gestionar certificados digitales con seguridad OAuth 2.0. Perfecta para ERPs, CRMs, portales web y sistemas automatizados.

---

🌍 Elige tu Entorno

Contamos con dos entornos separados para que desarrolles sin riesgos:

Sandbox (Pruebas) → Perfecto para aprender y probar
Producción → Para certificados con validez legal

Parametriza la base URL en tu aplicación ({{URL}}) apuntando al entorno deseado:

🧪 Sandbox (Pruebas)

Entorno efímero y gratuito para el ciclo de desarrollo.

https://sandbox-api.maticerts.com

🚀 Producción

Infraestructura real. Emite certificados con validez legal.

https://api.maticerts.com

🔒 Buena Práctica de Seguridad

Nunca hardcodees las URLs en el código. Usa variables de entorno (.env) para cambiar entre Sandbox y Producción sin recompilar tu aplicación.

---

🔐 Autenticación: Elige tu Método

Todas las peticiones a MATICERTS deben incluir un Bearer Token en el encabezado Authorization. Ofrecemos dos métodos según tu caso de uso:

Métodos Soportados

🤖 Backend (M2M) - Recomendado

Ideal para: ERPs, CRMs, Cronjobs, integraciones automatizadas.

Usa un Personal Access Token (PAT) generado en el panel de administración. Estos tokens:

• ✅ No expiran automáticamente
• ✅ Máximo rendimiento
• ✅ Fácil de gestionar

👤 Aplicaciones Cliente

Ideal para: Portales web, aplicaciones móviles, interfaces de usuario.

Obtén un token temporal autenticando al usuario final:

curl -X POST "{{URL}}/api/v1/auth/login" \
     -H "Content-Type: application/json" \
     -d '{
           "email": "usuario@empresa.com",
           "password": "tu-contraseña-segura"
         }'

---

🛠️ Tu Primera Petición: Health Check

Verifica que tu conexión funciona correctamente. Reemplaza <TU_ACCESS_TOKEN> con tu token real:

cURL

curl -X GET "{{URL}}/api/v1/sistema/health" \
     -H "Authorization: Bearer <TU_ACCESS_TOKEN>" \
     -H "Accept: application/json"

Node.js / Fetch

const response = await fetch('{{URL}}/api/v1/sistema/health', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <TU_ACCESS_TOKEN>',
    'Accept': 'application/json'
  }
});
const data = await response.json();
console.log(data);

Python (Requests)

import requests

url = "{{URL}}/api/v1/sistema/health"
headers = {
    "Authorization": "Bearer <TU_ACCESS_TOKEN>",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

---

📚 Próximos Pasos

¡Excelente! Ya tienes tu primer endpoint funcionando. Ahora:

1. Explora el Catálogo de API en el panel lateral para descubrir todos los endpoints disponibles
2. Lee la guía paso a paso para implementar tu primer flujo de emisión de certificados
3. Consulta casos de uso para ver ejemplos reales de integración
4. Revisa troubleshooting si encuentras algún problema

🎉 ¿Necesitas ayuda?

Si tienes dudas, consulta nuestra sección de Preguntas Frecuentes o contacta al equipo de soporte.