MAG define el contrato.
MSD entrega la experiencia.
Portal · OpenAPI 3.1 · SDK · CLI · Sandbox · Quick Start · colecciones · publicación oficial.
Toda la operación.Una sola plataforma.
Sprint 8 ✅ — MAG v1.0. Sprint 9 ✅ — ecosistema desarrolladores documentado al completo.
| Sprint 9 | Estado |
|---|---|
| MSD-01 – 09 | ✅ Entregado |
| MSD v1.0 | ✅ Documentación completa |
01 · Filosofía del ecosistema
De contrato a experiencia.
MAG (07) especifica la API. MSD (08) entrega portal, SDK, OpenAPI y sandbox.
| # | Principio |
|---|---|
| 1 | OpenAPI primero — fuente única de verdad |
| 2 | SDK idiomático por lenguaje |
| 3 | Quick Start en < 10 minutos |
| 4 | Sandbox aislado · multi-tenant aware |
02 · Developer Portal
La API es el producto.
El Portal es la puerta de entrada.
Inicio · Quick Start · API Reference · OpenAPI · SDK · Sandbox · Changelog · Estado API
03 · OpenAPI 3.1
Una única especificación.
Todo el ecosistema.
MAG → OpenAPI → SDK · Explorer · CLI · Postman
| MAG | OpenAPI |
|---|---|
| MAG-02 | securitySchemes |
| MAG-04 | paths · tags |
| MAG-06 | responses · ErrorResponse |
04 · SDK oficiales
Una API excelente
merece un SDK excelente.
Python · JavaScript · PHP — generados desde OpenAPI · errores MAG-06
05 · Roustix CLI
Automatizar también
es experiencia de desarrollador.
pip install roustix-cli · SDK · OpenAPI · CI/CD
06 · Sandbox y API Explorer
Antes de producción,
todo comienza en el Sandbox.
Tenant empresa-demo · OpenAPI Explorer · cURL · Python · JS · PHP
07 · Quick Start
Primera integración
en menos de 10 minutos.
Login → JWT → /me → /maintenance/assets
08 · Postman e Insomnia
Importar y ejecutar.
Sin escribir la primera petición.
Roustix API v1 · OpenAPI → Postman · Insomnia · JWT automático
09 · Publicación
Un ecosistema coherente.
MSD v1.0 completo.
OpenAPI · SDK · CLI · colecciones · Portal — publicación sincronizada con MAG.
| Artefacto | Estado |
|---|---|
| OpenAPI v1 | 🟢 Publicado |
| Colecciones | 🟢 Snapshot v1 |
| SDK · CLI · CI/CD | 📋 Roadmap operativo |