Agregar o modificar Categorías
Endpoint
Método: POST
URL: https://api.datacrush.la/ecommerce/v1/category/add
Parámetros de consulta
| Parámetro | Tipo | Descripción |
| portal_id | integer | Identificador único del portal. Requerido. |
| api_key | string | Clave de autenticación de la API. Requerido. |
Cuerpo de la solicitud
La solicitud debe enviarse en formato JSON y debe contener un array de objetos de categoría.
Estructura del JSON
[
{
"id": 2,
"name": "Escritura",
"handle": "boligrafos",
"url": "http://www.domain.com/product/detail/Pendrive-Synth-8GB/2",
"description": "Descripción del pendrive",
"parent": 0
}
]
Campos del cuerpo de la solicitud
| Campo | Tipo | Descripción |
| id | integer | Identificador único de la categoría. Si la categoría ya existe, se actualizará. Si no existe, se creará una nueva. |
| name | string | Nombre de la categoría. Debe ser un texto representativo del tipo de productos incluidos. |
| handle | string | Identificador de la categoría en formato URL-friendly. Se recomienda que sea una versión simplificada del nombre, sin espacios ni caracteres especiales. |
| url | string | URL de referencia de la categoría. Debe ser un enlace válido y accesible. |
| description | string | Descripción de la categoría. Debe proporcionar información clara sobre los productos incluidos. |
| parent | integer | ID de la categoría padre. Si es 0, la categoría será de nivel superior. En caso de que pertenezca a una categoría mayor, debe contener el id de dicha categoría. |
Respuesta
Respuesta exitosa
- Ejemplo de respuesta:
{
"result": "success"
}
Respuestas de error
Los errores se devuelven en el siguiente formato:
{
"result": "fail",
"error": {
"code": 210,
"message": "Error al decodificar JSON"
},
"error_list": []
}
| Código interno | Mensaje de error | Descripción |
| 210 | "Error al decodificar JSON" | El formato del JSON enviado es inválido. |
| 401 | "No autorizado" | Falta la clave de la API o es incorrecta. |
| 403 | "Acceso denegado" | El usuario no tiene permisos para esta operación. |
| 500 | "Error interno del servidor" | Ocurrió un error inesperado en el servidor. |
Notas
- La clave api_key es obligatoria para la autenticación.
- Si el id de la categoría ya existe, se actualizarán sus datos.
- Si el id no existe, se creará una nueva categoría.
- Las categorías con parent: 0 serán consideradas de nivel superior.
- Para evitar errores de código 210, asegúrate de enviar el JSON con la estructura correcta.
Comentarios
0 comentarios
El artículo está cerrado para comentarios.