Autenticación

Contrato aprobado · en validación

Autenticación

Usa una clave emitida para la API V2 desde tu nuevo espacio de Shipbuy y envíala completa en X-API-Key. No se aceptan tokens de inicio de sesión de la App ni JWT de V1. La clave fija la cuenta, el entorno y los permisos; cambiar la documentación no los modifica. El envío independiente requiere allowStandaloneShipping. Con almacenes seleccionados, requiere warehouseId y shipFrom coincidentes; solo warehouses.all permite cualquier origen. Un recurso sin tienda requiere stores.all y una preparación sin almacén requiere allowUnassignedFulfillments; un envío puramente standalone no exige esos dos indicadores.

Content-Type: application/json
X-API-Key: <your-v2-api-key>
Administrar claves de V2

Notas de integración

Guarda la clave nueva o rotada cuando se muestre una sola vez, en la configuración segura del servidor. Caduca a los 365 días por defecto y permite elegir expresamente una duración permanente. Puedes pausarla, revocarla o rotarla; el solapamiento es de 24 horas por defecto y hasta 7 días. Gestiona los datos de prueba en Settings → Developer → Sandbox; la disponibilidad en producción se indica en cada operación.

Las escrituras de V2 requieren Idempotency-Key; PATCH también requiere If-Match. Conserva la clave, el contenido y el If-Match original al reintentar una escritura incierta. IDs e importes son cadenas; las fechas y horas están en UTC. Se aplican la caducidad de tarifas, las reglas de negocio y los permisos combinados.