Crear Variación

Crea una nueva variación en el sistema. Permite definir opciones para productos.

---

Entorno

URL base: https://api.guarani.app

Endpoint

POST /variaciones

Ejemplo de solicitud

curl -X POST "https://api.guarani.app/variaciones" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "nombre": "Tamaño",
    "descripcion": "Tamaños disponibles para la prenda",
    "variaciones": [
      { "valor": "S" },
      { "valor": "M" },
      { "valor": "L" },
      { "valor": "XL" }
    ]
  }' | jq

Nota: Asegúrate de reemplazar <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Encabezados de la Solicitud

Encabezado	Valor	Descripción
Content-Type	application/json	Indica que los datos se envían en formato JSON.
x-api-key	Bearer <access_token>	Token de autenticación necesario para acceder al recurso.

Descripción de Campos

Parámetro	Tipo	Requerido	Tamaño	Descripción
nombre	string	Sí	100	Nombre de la variación. Ejemplo: "Tamaño", "Color".
descripcion	string	Sí	255	Descripción detallada de la variación.
variaciones	array	Sí	-	Lista de valores que pertenecen a la variación. Debe contener al menos un ítem.

variaciones (array)

| valor | string | Sí | 100 | Valor individual de la variación. Ejemplo: "S", "M", "Rojo". |

Ejemplo de respuesta

{
  "success": true,
  "codigo": "201",
  "message": "Recurso creado con éxito.",
  "data": {
    "id": "a3f0c6d9-8b5f-4e8f-b3d5-63e7b3c73d2e",
    "nombre": "Tamaño",
    "descripcion": "Tamaños disponibles para la prenda",
    "variaciones": [
      {
        "id": "f0a1e3a7-9e72-43d7-8d27-3ae9f76e2b1c",
        "valor": "S"
      },
      {
        "id": "b3e9a55c-01fc-4fcb-a4b3-5b52f3d4e2b9",
        "valor": "M"
      },
      {
        "id": "d6c9e1d4-bf7e-41f6-b913-b2b3b86ffba3",
        "valor": "L"
      },
      {
        "id": "e7c8b923-b0cc-4b01-865a-c14b1f019d34",
        "valor": "XL"
      }
    ]
  }
}

Recursos adicionales

Para más información sobre posibles errores y cómo manejarlos, consulta errores.