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.
MAG especifica la API. MSD entrega las herramientas para integrarla: SDK, sandbox y guías de inicio.
| Recurso | Para el integrador |
|---|---|
| OpenAPI 3.1 | Contrato máquina-legible |
| SDK · CLI | pip · npm · automatización |
| Sandbox | Probar sin tocar producción |
01 · Filosofía del ecosistema
De contrato a experiencia.
MAG especifica la API. MSD 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 |
|---|---|
| Autenticación | securitySchemes |
| Recursos | paths · tags |
| Errores | responses · ErrorResponse |
04 · SDK oficiales
Una API excelente
merece un SDK excelente.
Python · JavaScript · PHP — generados desde OpenAPI · errores tipados
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 listo para integradores.
OpenAPI · SDK · CLI · colecciones · Portal — sincronizado con el contrato MAG.
| Artefacto | Estado |
|---|---|
| OpenAPI v1 | 🟢 Publicado |
| Colecciones | 🟢 Snapshot v1 |
| SDK · CLI · CI/CD | 📋 Roadmap operativo |