Entornos
Producción y el sandbox de staging, y cuándo usar cada uno.
La API pública de Pulsar funciona en dos entornos. Ambos exponen los mismos endpoints; solo cambian la URL base y la API key.
| Entorno | URL base | Úsalo para |
|---|---|---|
| Producción | https://draco.prod.pulsarml.com | Tu integración en vivo |
| Sandbox (staging) | https://draco.stage.pulsarml.com | Construir y probar tu integración |
Todos los ejemplos de este sitio usan la URL de producción. Para llamar al sandbox, cambia la URL base y usa tu API key del sandbox:
curl --location 'https://draco.stage.pulsarml.com/v1/machines' \
--header 'Accept: application/json' \
--header 'x-api-key: <YOUR_SANDBOX_API_KEY>'El sandbox
El sandbox es el entorno de staging de Pulsar: una copia de producción con los datos reales de tu fábrica, para probar la API. Úsalo para construir y probar tu integración antes de apuntarla a producción.
Los datos del sandbox se restablecen cada semana
El sandbox se reconstruye desde producción cada semana. Todo lo que crees o modifiques ahí, como órdenes de trabajo, SKUs, operadores o registros de producción, se elimina, y un id que hayas guardado puede apuntar después a otro registro, o a ninguno. No guardes ids del sandbox para después: vuelve a consultar los registros antes de usarlos.
Como el sandbox contiene una copia de los datos reales de producción de tu empresa, una key del sandbox da acceso a la misma información que una key de producción. Guárdala, compártela y rótala con el mismo cuidado.
API keys
Cada entorno tiene su propia API key. Una key de producción no funciona en el sandbox, y una key del sandbox no funciona en producción.
Cómo obtener una API key del sandbox
Ambos tipos de key los crea un Super Admin en la app de Pulsar, en Configuraciones → Integraciones: la página tiene un selector Producción / Sandbox, y la key se crea para el entorno seleccionado. Consulta Autenticación.
Pruébalo en la documentación
El playground de cada endpoint tiene un selector de servidor. Elige https://draco.stage.pulsarml.com y pega tu key del sandbox en el campo Autorización para enviar solicitudes al sandbox.