API
Cada acción es un endpoint HTTP: POST https://app.netzo.ai/api/rpc/<tabla>/<acción>, con un cuerpo JSON. Los nombres API vienen de Dominios.
curl -X POST "https://app.netzo.ai/api/rpc/salesorders/find" \
-H "x-api-key: $NETZO_API_KEY" \
-H "content-type: application/json" \
-d '{ "pagination": { "page": 1, "pageSize": 25 } }'| Necesitas | Usa |
|---|---|
| Autenticarte | x-api-key: <clave>, o un token OAuth bearer. Ve Autenticación |
| Actuar en un lugar | ?moduleUid=<módulo>&entityId=<fila> |
| Probar una escritura sin guardar | x-netzo-dry-run: 1 |
| Errores en español | Accept-Language: es |
| Cada endpoint que tu clave puede llamar | https://app.netzo.ai/openapi.json, interactivo en /scalar |
El documento OpenAPI lista solo los endpoints que tu credencial puede llamar, así un cliente generado nunca ofrece una acción que sería rechazada. Una llamada rechazada devuelve un código, un mensaje en el idioma de quien llama y cómo corregirlo. Ve Errores y límites.
Lugares
Cada llamada puede nombrar su lugar. Sin lugar, una lectura cubre todos los lugares que permiten tus permisos.
| Superficie | Lugar sales/acme-mx |
|---|---|
| API | ?moduleUid=sales&entityId=acme-mx |
| MCP | "moduleUid": "sales", "entityId": "acme-mx" |
| CLI | --place sales/acme-mx |
Carga muchos registros
Para cada fila, busca con find el registro por su clave de negocio, como el SKU de un producto, luego actualiza con update el que encuentres o crea uno nuevo con create. Así una segunda ejecución actualiza en lugar de duplicar. Envía primero x-netzo-dry-run: 1 para revisar cada fila sin guardar.