API — Introducción

Última actualización: 08. octubre 2026

La API de configento.app le permite gestionar sus configuradores mediante programación: leer, crear y modificar componentes, grupos, características, valores, reglas y listas de precios, y publicar sus cambios. Ideal para transferir datos desde un sistema PIM o ERP.

Autenticación

Cada solicitud necesita una clave de API en la cabecera Authorization:

Authorization: Bearer SU_CLAVE_API
Accept: application/json
Content-Type: application/json

Las claves de API se crean en el backend V3 en Configuración → API: introduzca un nombre, elija el permiso, defina opcionalmente una fecha de caducidad y haga clic en Crear. La clave se muestra una sola vez: cópiela de inmediato y guárdela en un lugar seguro.

Importante:

Una clave pertenece al servicio (pedido de servicio) seleccionado al crearla y solo funciona con sus componentes.
Puede crear tantas claves como quiera; lo ideal es una por integración, para poder revocarlas por separado.
Una clave puede tener una fecha de caducidad opcional: funciona hasta el final de ese día y después se rechaza con 401. Puede mover o eliminar la fecha en cualquier momento; así, una clave ya caducada vuelve a ser válida. Sin fecha, una clave no caduca nunca.
Las claves se gestionan únicamente en el backend. La propia API no permite crear, modificar ni eliminar claves.

Permisos

Permiso	Permite
Solo lectura	Solo solicitudes `GET`: consultar datos sin modificar nada
Lectura y escritura	Además, crear, modificar y eliminar borradores: componentes, grupos, características, valores, reglas, listas de precios, etiquetas
+ Publicar	Además, publicar y eliminar componentes; ambos afectan a la tienda de inmediato
+ IA	Además, usar el asistente de IA a través de la API; consume tokens de IA

Publicar e IA solo pueden concederse junto con Lectura y escritura y están desactivados por defecto. Así, por ejemplo, un PIM puede mantener precios y valores en el borrador mientras una persona revisa y publica. Puede cambiar los permisos de una clave en cualquier momento en la lista; se aplican a partir de la siguiente solicitud.

No disponible para ninguna clave, sea cual sea su permiso: gestionar claves, comprar tokens de IA, leer o renovar credenciales de integración (plugins de tienda, fragmento HTML5). Esto queda reservado al backend: una clave extraviada no puede emitirse una clave de sustitución ni generar costes.

URL base

https://admin.configento.app/api/v1

Modelo de datos

Componente
├── Grupos
│   └── Características
│       └── Valores
└── Reglas

Los componentes con ID positivo están publicados; los de ID negativo son borradores sin publicar. Todo cambio realizado mediante la API se guarda primero en el borrador; solo al publicar llega a la tienda.

Endpoints principales

Componentes

GET    /components                          # Listar todos los componentes
GET    /components/{id}                     # Componente con grupos, características, valores y reglas
POST   /components                          # Crear un componente vacío
PUT    /components/{id}                     # Modificar la configuración del componente
DELETE /components/{id}                     # Eliminar el componente (¡también en vivo!) — Publicar
POST   /components/{id}/duplicate           # Copiar el componente

Grupos y características

POST   /components/{id}/groups                              # Crear grupo
PUT    /components/{id}/groups/{gid}                        # Modificar grupo
DELETE /components/{id}/groups/{gid}                        # Eliminar grupo
POST   /components/{id}/groups/{gid}/characteristics        # Crear característica
PUT    /components/{id}/groups/{gid}/characteristics/{cid}  # Modificar característica
DELETE /components/{id}/groups/{gid}/characteristics/{cid}  # Eliminar característica

Valores

POST   /components/{id}/characteristics/{cid}/values         # Crear valor
PUT    /components/{id}/characteristics/{cid}/values         # Sustituir todos los valores de una vez
PUT    /components/{id}/characteristics/{cid}/values/{vid}   # Modificar valor
DELETE /components/{id}/characteristics/{cid}/values/{vid}   # Eliminar valor

Precios

GET    /components/{id}/characteristics/{cid}/pricelist           # Obtener precios escalonados
PUT    /components/{id}/characteristics/{cid}/pricelist           # Sustituir precios escalonados
POST   /components/{id}/characteristics/{cid}/matrix/upload       # Subir matriz de precios en CSV

Reglas

GET    /components/{id}/rules          # Obtener reglas
POST   /components/{id}/rules          # Crear regla
PUT    /components/{id}/rules/{rid}    # Modificar regla
DELETE /components/{id}/rules/{rid}    # Eliminar regla

Versiones y publicación

GET    /components/{id}/versions                       # Versiones guardadas
POST   /components/{id}/versions/{version}/restore     # Restaurar una versión como borrador
POST   /components/{id}/publish                        # Publicar el borrador — Publicar
GET    /components/{id}/publish/status                 # Progreso de la publicación

La lista completa con todos los campos está en la referencia de la API.

Ejemplo: crear una característica con valores

Crear una característica en el grupo 5 del componente 123:

POST /components/123/groups/5/characteristics
Authorization: Bearer SU_CLAVE_API
Content-Type: application/json

{
  "alt_title": "color",
  "title": { "es_ES": "Color", "de_DE": "Farbe" },
  "type": "select",
  "is_required": "1"
}

La respuesta contiene el ID de la nueva característica (aquí 42). A continuación, defina todos los valores de una vez:

PUT /components/123/characteristics/42/values
Authorization: Bearer SU_CLAVE_API
Content-Type: application/json

{
  "values": [
    { "title": { "es_ES": "Blanco" },            "value": "blanco",     "price": 0 },
    { "title": { "es_ES": "Antracita" },         "value": "antracita",  "price": 15.00 },
    { "title": { "es_ES": "Laca RAL especial" }, "value": "ral",        "price": 45.00 }
  ]
}

alt_title es el nombre interno de la característica (solo letras, cifras y _); las fórmulas se refieren a ella por este nombre. Los textos como title son objetos con una entrada por idioma.

Ejemplo: subir una matriz de precios

POST /components/123/characteristics/77/matrix/upload
Authorization: Bearer SU_CLAVE_API
Content-Type: application/json

{
  "name": "Precios 2026",
  "csv": ";500;1000;1500\n500;89;119;149\n1000;129;169;209",
  "delimiter": ";"
}

La primera fila contiene los valores del eje X y la primera columna los del eje Y. También puede subir el archivo como multipart/form-data en el campo file. Más información: Matrices de precios desde Excel/CSV.

Ejemplo: publicar

POST /components/123/publish
Authorization: Bearer SU_CLAVE_API

La publicación se ejecuta en segundo plano. La respuesta 202 Accepted contiene la dirección donde consultar el progreso (GET /components/123/publish/status). La clave necesita el permiso Publicar.

Códigos de error

Estado	Significado
`401`	Clave de API ausente, no válida, revocada o caducada
`403`	La clave no tiene este permiso, p. ej. «This API key is read-only.» en una solicitud de escritura con una clave de solo lectura, o el endpoint está cerrado a las claves de API
`404`	El componente, la característica o el valor no existe (o pertenece a otro servicio)
`409`	Ya hay una publicación en curso para este componente
`422`	Datos no válidos; la respuesta indica los campos afectados
`429`	Demasiadas solicitudes en poco tiempo; espere un momento y vuelva a intentarlo

Referencia completa de la API

Todos los endpoints con sus campos, ejemplos y la posibilidad de probarlos en el navegador: admin.configento.app/docs/api; también accesible en Configuración → API → Documentación de la API en el backend V3.

Soporte

Para cualquier duda sobre la API: contacte con el soporte mediante el botón de chat del portal de servicio.

Próximos pasos

← Todos los artículos Prueba gratuita 14 días