Para quienes miran un catálogo y piensan «API»

Tu colección puede salir de la app. Con educación.

KolleK tiene una API JSON documentada para quienes quieren conectar su colección a un script, un panel, su propio proceso de importación o algo maravillosamente específico.

Primeros pasos

Introducción

Autenticación

Paginación

Límites de tasa

Recursos

GET Listar artículos
GET Obtener artículo
POST Crear artículo
GET Listar colecciones
GET Listar ubicaciones
GET Listar tipos de colección
GET /api/items GENERADO DESDE EL CÓDIGO

Listar artículos

Recupera artículos de todas las colecciones, o limita la lista a una colección con el parámetro de consulta collection. Devuelve una lista paginada de objetos item.

Parámetros de consulta

collection string opcional
per_page integer opcional
page integer opcional

Claves API personales

El mismo catálogo, disponible para tus herramientas.

Usa una clave API personal para leer y gestionar la colección mediante sencillas peticiones HTTP. Colecciones, artículos, copias, historial, ubicaciones y lo demás no están atrapados tras la interfaz.

collections items copies history locations item-types
Crear clave API Ajustes · Desarrollador

Nombre

Sincronización del panel del hogar
Tu nueva clave Copiar

14|aB3cD4eF5gH6iJ7kL8mN9oP0qR1sT2uV3wX4yZ5aK

Cópiala ahora. Esta es la única vez que se mostrará la clave completa.

Referencia

Documentación que viene del producto.

La referencia de la API se genera desde el código. Eso significa que la documentación de los endpoints está hecha para mantenerse cerca de lo que la app realmente admite, en vez de derivar hacia una ficción arqueológica.

cURL JavaScript PHP Solicitud
curl https://kollek.example/api/items \
-H "Authorization: Bearer $KOLLEK_KEY" \
-G --data-urlencode "collection=17" \
--data-urlencode "per_page=2"
200 OK Respuesta · application/json
{
"data": [
{ "id": 512,
"name": "Kind of Blue",
"location": "Shelf B2" }
],
"links": { "next": "…?page=2" },
"meta": { "current_page": 1, "total": 128 }
}
Paginación por página (links + meta) 60 solicitudes / min por usuario Autenticación por token Bearer

Interoperabilidad

Una vía de escape, a propósito.

¿Necesitas analizar tu catálogo en otro sitio? ¿Crear un informe privado? ¿Llevar la información a otro flujo de trabajo? La API te da una salida limpia sin hacer que el producto sea menos útil por dentro.

API de KolleK

kollek.app/api

Tu catálogo

Un script privado

Lee el catálogo de forma programada y haz algo concreto con él.

Tu propio panel

Trae artículos y ubicaciones a una vista que construiste tú mismo.

Una hoja de cálculo

Exporta una parte de la colección cuando otra herramienta necesite los datos.

Webhooks

Webhooks: informe de estado honesto.

Hoy puedes registrar endpoints de webhook firmados. Los eventos del producto todavía no disparan entregas. No vamos a llamar a eso «próximamente» y confiar en que deduzcas el resto.

Endpoints de webhook 1 registrado
https://hooks.mydash.io/kollek Inactivo
Secreto de firma whsec_••••••8d2f
Esquema de firma HMAC-SHA256
Entregas 0
El registro de endpoints y la firma ya funcionan. Ningún evento del producto dispara todavía una entrega, así que este endpoint seguirá inactivo hasta que lo haga.

Lee la referencia. Construye eso que de verdad querías.

Endpoints, autenticación, paginación y límites de tasa, generados desde el código y listos para tu clave.

Explora la referencia de la API

KolleK puede que (todavía) no sea para ti si…

Necesitas integraciones llave en mano con todos los servicios habidos y por haber.

Necesitas webhooks orientados a eventos hoy mismo. Los endpoints y la firma existen, pero todavía ningún evento del producto los dispara.

Elige KolleK cuando…

Quieres una API JSON documentada para tus propias herramientas y scripts.

Necesitas acceso directo y autenticado por token al catálogo ahora.

Actualizaremos esta página cuando el producto cambie. La página de estado de las funciones tiene los detalles aburridos pero importantes.