Cómo empezar
- Un administrador de la empresa abre Empresa › Integraciones en la aplicación y crea una integración.
- Otorga datos autorizados por dominio y grupo de campos. Los grupos
confidentialypeoplerequieren una confirmación explícita. - Para webhooks, crea un destino con una URL HTTPS y copia el secreto de firma, que se muestra una sola vez. Para la API, crea un cliente OAuth 2.0 o una API key.
- Envía el evento de prueba, verifica la firma en el receptor y activa el destino.
Los permisos pertenecen a la empresa y se pueden revocar en cualquier momento; al revocar, la API responde 403 de inmediato y se cancelan las entregas pendientes.
Referencia
| Sección | Contenido |
|---|---|
| Webhooks | Envoltorio, cabeceras, firma, reintentos, orden, idempotencia y autenticación hacia su receptor. |
| API de datos | Tokens OAuth 2.0, scopes, recursos, paginación por cursor, cuotas y errores. |
| Catálogo de eventos | Cada tipo de evento, su dominio y su esquema JSON. |
| Guías por sistema | SAP Integration Suite, MuleSoft, Boomi, Azure Logic Apps, Power Automate, Dynamics 365, Salesforce, HubSpot, n8n, Make, Zapier y verificación de firma en Node.js, Python, Java y C#. |
| Errores | Un documento por cada código de error de la API. |
| Seguridad | Paquete de evaluación de seguridad, con versión descargable en PDF. |
URL que Masnet emite
Las siguientes direcciones aparecen en los envíos y respuestas de la API y resuelven a esta documentación:
| Dónde aparece | Dirección |
|---|---|
Miembro dataschema del envoltorio | https://masnet.com/developers/schemas/<objeto>/v1.json |
| Esquema del envoltorio | https://masnet.com/developers/schemas/envelope/v1.json |
Miembro type de un error | https://masnet.com/developers/errors/<código> |
Cabecera User-Agent de los webhooks | Masnet-Webhooks/1.0 (+https://masnet.com/developers/webhooks) |
Versiones y compatibilidad
- La versión mayor va en el tipo de evento (
.v1), en la ruta de la API (/v1) y en los esquemas. - Son compatibles dentro de una versión mayor: campos opcionales nuevos, tipos de evento nuevos y valores nuevos en enumeraciones abiertas. Escriba su receptor para ignorar lo que no conozca.
- Un cambio incompatible crea una versión mayor nueva que se publica en paralelo.
Soporte y contacto
Para consultas técnicas escriba a [email protected] e indique el correlation_id de la respuesta o el webhook-id del evento. Las vulnerabilidades se reportan a [email protected], según el Anexo B de los Anexos complementarios.