Docs  /  API  /  API — Introducción

API — Introducción

Última actualización: 01. enero 2026

La API de configento.app permite gestionar los datos del configurador mediante programación: crear, leer y actualizar características, opciones, precios y reglas. Ideal si desea transferir grandes volúmenes de datos desde un sistema PIM o ERP.

Autenticación

Todas las solicitudes a la API se autentican mediante un token de API. Los tokens de API se crean en el backend V3 en Configuración → API. La clave de seguridad de su servicio se encuentra en el portal de servicio en Servicios.

Authorization: Bearer SU_TOKEN_API
Content-Type: application/json

URL base

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

Recursos

Componentes

GET    /components              # Listar todos los componentes
GET    /components/{id}         # Obtener un componente
POST   /components              # Crear un componente
PUT    /components/{id}         # Actualizar un componente
DELETE /components/{id}         # Eliminar un componente

Características

GET    /components/{id}/features           # Todas las características de un componente
POST   /components/{id}/features           # Crear una característica
PUT    /components/{id}/features/{fid}     # Actualizar una característica
DELETE /components/{id}/features/{fid}     # Eliminar una característica

Opciones

GET    /features/{id}/options              # Todas las opciones de una característica
POST   /features/{id}/options              # Crear una opción
PUT    /features/{id}/options/{oid}        # Actualizar una opción
DELETE /features/{id}/options/{oid}        # Eliminar una opción

Listas de precios

GET    /components/{id}/pricelists         # Obtener las listas de precios
POST   /components/{id}/pricelists         # Subir una lista de precios (CSV)
DELETE /components/{id}/pricelists/{plid}  # Eliminar una lista de precios

Ejemplo: crear una característica

POST /components/123/features
Authorization: Bearer SU_TOKEN_API
Content-Type: application/json

{
  "name": "Color",
  "type": "select",
  "required": true,
  "sort_order": 1,
  "options": [
    { "name": "Blanco", "surcharge": 0 },
    { "name": "Antracita", "surcharge": 15.00 },
    { "name": "Laca RAL especial", "surcharge": 45.00 }
  ]
}

Ejemplo: subir una lista de precios

POST /components/123/pricelists
Authorization: Bearer SU_TOKEN_API
Content-Type: multipart/form-data

file: lista-de-precios.csv
row_feature_id: 456
col_feature_id: 457

Límite de peticiones

La API permite 1.000 solicitudes por minuto. Si se supera ese límite, se devuelve el estado 429 Too Many Requests.

Documentación completa de la API

La referencia completa de la API, con todos los endpoints, parámetros y códigos de error, se encuentra 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