Crear productos de forma masiva
API operation: Abrir la operación en la Referencia de la API
Usa POST /bulks/products para crear productos en una solicitud administrativa. La operación pública actual es ProductBulk.register y requiere autenticación de administrador o administrador de negocio.
El campo de solicitud products contiene un arreglo codificado en JSON. Las reglas del comportamiento descrito exigen name, price, category_id y business_id en cada elemento.
{
"products": "[{\"name\":\"Example product\",\"price\":12,\"category_id\":272,\"business_id\":41}]"
}
Los límites del comportamiento descrito permiten hasta 1,000 productos en un máximo de cinco negocios. Un administrador de negocio solo puede incluir productos de negocios propios, y cada categoría debe pertenecer al negocio indicado. La operación valida la colección antes de crear los registros; trata cualquier fallo como un lote fallido y comprueba la respuesta antes de continuar.
Los campos cuyos nombres empiezan con metafield_ se convierten en metafields de producto durante la creación masiva. Por ejemplo, metafield_color crea la clave de metafield color. Usa solo valores sintéticos en los ejemplos y confirma el esquema completo de solicitud en la referencia pública.
Referencia de OpenAPI
Operación: POST /bulks/products
Campos del cuerpo de la solicitud
| Nombre | Tipo | Obligatorio |
|---|---|---|
products | string | Sí |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta exitosa. El contenido de result varía según la operación y se devuelve como JSON. |
| 400 | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código. |
| 401 | Respuesta de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error: el proyecto no existe o no tiene una suscripción activa. |
| 404 | Respuesta vacía: la versión de API solicitada no está admitida. |
| 429 | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key. |
| 500 | Respuesta de error: falló la búsqueda o inicialización del proyecto. |
| 503 | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on_error = closed (cabecera Retry-After: 1). |