{"id":8431,"date":"2026-10-08T10:16:01","date_gmt":"2026-10-08T08:16:01","guid":{"rendered":"https:\/\/helpdesk.kontainer.com\/article\/integracion-con-la-api-de-kontainer\/"},"modified":"2026-10-08T10:16:01","modified_gmt":"2026-10-08T08:16:01","slug":"integracion-con-la-api-de-kontainer","status":"publish","type":"article","link":"https:\/\/helpdesk.kontainer.com\/es\/article\/integracion-con-la-api-de-kontainer\/","title":{"rendered":"Integraci\u00f3n con la API de Kontainer"},"content":{"rendered":"

\"Cabecera<\/picture><\/p>\n

La API de Kontainer facilita integrar tu software actual en la plataforma de Kontainer. Esta interfaz entre programas permite que tus aplicaciones intercambien datos con Kontainer y se puede usar para automatizar muchos procesos distintos.<\/p>\n

A continuaci\u00f3n repasamos los fundamentos de la configuraci\u00f3n de la API.<\/p>\n

La informaci\u00f3n de este art\u00edculo es t\u00e9cnica y est\u00e1 dirigida a los desarrolladores encargados de configurar la API. Si tienes cualquier duda, no dudes en escribirnos.<\/p>\n

Visita la p\u00e1gina de integraci\u00f3n de Kontainer<\/strong> <\/a>para saber m\u00e1s sobre nuestra API. Encontrar\u00e1s m\u00e1s informaci\u00f3n sobre casos de uso, ventajas, etc.<\/p>\n

\n

C\u00f3digo de la API<\/h2>\n

Ve directamente al c\u00f3digo para la integraci\u00f3n con la API AQU\u00cd<\/strong><\/a> (en ingl\u00e9s).<\/span> <\/span><\/p>\n

NOTA:<\/strong> debes usar tu URL de Kontainer \u00fanica en lugar de la que aparece en el ejemplo de los enlaces anteriores (\u00abapp.kontainer.com\u00bb).<\/em><\/p>\n<\/blockquote>\n

\n

Primeros pasos<\/h2>\n

Para usar la API de Kontainer necesitas una cuenta de Kontainer y un token de acceso a la API.<\/p>\n

Ponte en contacto con tu administrador local o con el soporte de Kontainer<\/a> para obtener m\u00e1s informaci\u00f3n sobre c\u00f3mo acceder a la API de Kontainer.<\/p>\n

Autenticaci\u00f3n<\/h3>\n

La API de Kontainer usa OAuth<\/em> para la autenticaci\u00f3n. Cuando te den un token de acceso a la API, debes enviarlo en cada solicitud, en la cabecera Authorization, como valor \u00abBearer\u00bb.<\/p>\n

Todas las solicitudes deben incluir tu token de acceso a la API en la cabecera Authorization: Authorization: Bearer {{access-token}}<\/code><\/mark><\/p>\n

Negociaci\u00f3n de contenido<\/h3>\n

Todas las solicitudes deben<\/strong> incluir la cabecera: Accept: application\/vnd.api+json <\/code><\/mark>.
Las solicitudes que env\u00eden datos JSON deben<\/strong> incluir la cabecera: Content-Type: application\/vnd.api+json <\/code><\/mark><\/p>\n

Est\u00e1ndar JSON:API<\/h3>\n

La API de Kontainer es una API RESTful<\/em> que sigue el est\u00e1ndar JSON API<\/a>. Puedes consultar este est\u00e1ndar para m\u00e1s informaci\u00f3n sobre c\u00f3mo se estructuran los documentos de solicitud y de respuesta.<\/p>\n

Tipos de recurso<\/h2>\n

La API expone estos tipos de recurso: files<\/code>, folders<\/code>, users<\/code>, tags<\/code>, channels<\/code>, elements<\/code>, element-options<\/code>, categories<\/code>, custom-fields<\/code>, download-templates<\/code>, video-download-templates<\/code>, cdn<\/code>, user-groups<\/code>, permisos de carpetas (folder permissions), consent wards, consent agreements, consent parties, statistics<\/code> y registros de tareas (job logs).<\/p>\n

Operaciones de escritura<\/h2>\n

La API admite operaciones de escritura en todos los recursos: POST<\/strong> para crear, PATCH<\/strong> para actualizar y DELETE<\/strong> para eliminar. No es de solo lectura.<\/p>\n

L\u00edmites de frecuencia<\/h3>\n

Los l\u00edmites de frecuencia est\u00e1ndar de la API se aplican a todos los endpoints que ofrecemos, y el l\u00edmite es de 500<\/code><\/mark> solicitudes por minuto. Si se supera el l\u00edmite definido, la API responde con el mensaje: 429: Too Many Attempts<\/code><\/mark>.<\/p>\n

C\u00f3digos de respuesta<\/h3>\n

La API de Kontainer responde con c\u00f3digos de estado HTTP y con c\u00f3digos y mensajes de error basados en JSON.<\/p>\n

C\u00f3digos de estado HTTP<\/h3>\n

La tabla siguiente ofrece un resumen de los c\u00f3digos de estado HTTP que se devuelven.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
C\u00f3digo de estado HTTP<\/strong><\/th>\nTexto<\/strong><\/th>\nDescripci\u00f3n<\/strong><\/th>\n<\/tr>\n<\/thead>\n
200<\/td>\nOK<\/td>\nCorrecto.<\/td>\n<\/tr>\n
201<\/td>\nCreated<\/td>\nObjeto creado.<\/td>\n<\/tr>\n
204<\/td>\nNo Content<\/td>\nNo se devuelve contenido.<\/td>\n<\/tr>\n
401<\/td>\nUnauthorized<\/td>\nFalta el token o no es v\u00e1lido.<\/td>\n<\/tr>\n
403<\/td>\nForbidden<\/td>\nRecurso o solicitud no admitidos.<\/td>\n<\/tr>\n
404<\/td>\nNot Found<\/td>\nObjeto no encontrado.<\/td>\n<\/tr>\n
406<\/td>\nNot Acceptable<\/td>\nSolicitud no aceptable.<\/td>\n<\/tr>\n
409<\/td>\nConflict<\/td>\nConflicto con el estado de la aplicaci\u00f3n o del recurso.<\/td>\n<\/tr>\n
422<\/td>\nValidation Error<\/td>\nSe ha producido un error de validaci\u00f3n.<\/td>\n<\/tr>\n
429<\/td>\nToo Many Requests<\/td>\nSe ha superado el l\u00edmite de frecuencia.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Mensajes de error<\/h3>\n

El ejemplo siguiente muestra el aspecto que tiene un mensaje de error para el c\u00f3digo de estado HTTP 401 - Unauthorized<\/code><\/mark>.<\/p>\n

\"Ejemplo<\/picture><\/p>\n

Filtros<\/h2>\n

Se pueden aplicar filtros a los endpoints compatibles para limitar los resultados que se devuelven. Los filtros se aplican con el par\u00e1metro de consulta filter<\/code><\/mark>. Los campos de filtro admitidos aparecen en la secci\u00f3n Filter Attributes<\/strong> de cada endpoint.<\/p>\n

Ejemplos:<\/strong><\/p>\n

Obtener una lista de elementos o productos de una categor\u00eda:<\/p>\n

filter[description][like]<\/code><\/mark> : Shoes<\/code><\/mark><\/p>\n

Encontrar elementos por EAN exacto:<\/p>\n

filter[ean][eq]<\/code><\/mark> : 4194382028137<\/code><\/mark><\/p>\n

Encontrar elementos posteriores a una fecha:<\/p>\n

filter[released_on][gt]<\/code><\/mark> : 2020-01-01<\/code><\/mark><\/p>\n

Encontrar elementos con un coste unitario mayor o igual que 22,50 y menor que 50,00:<\/p>\n

filter[unit_cost][gte]<\/code><\/mark> : 22.50<\/code><\/mark><\/p>\n

filter[unit_cost][lt]<\/code><\/mark> : 50.00<\/code><\/mark><\/p>\n

Comprobar si hay archivos a los que se hace referencia en un campo de datos del PIM:<\/p>\n

filter[asset][exists]<\/code><\/mark> : 1<\/code><\/mark><\/p>\n

filter[asset][exists]<\/code><\/mark> : 0<\/code><\/mark><\/p>\n

Calificadores de filtro<\/strong><\/p>\n