Pour ceux qui regardent un catalogue et pensent « API »

Votre collection peut quitter l'application. Poliment.

KolleK dispose d'une API JSON documentée pour ceux qui veulent connecter leur collection à un script, un tableau de bord, leur propre processus d'import, ou quelque chose de merveilleusement spécifique.

Premiers pas

Introduction

Authentification

Pagination

Limites de débit

Ressources

GET Lister les objets
GET Obtenir un objet
POST Créer un objet
GET Lister les collections
GET Lister les emplacements
GET Lister les types de collection
GET /api/items GÉNÉRÉ DEPUIS LE CODE

Lister les objets

Récupérez les objets de toutes les collections, ou limitez la liste à une collection avec le paramètre de requête collection. Renvoie une liste paginée d'objets item.

Paramètres de requête

collection string facultatif
per_page integer facultatif
page integer facultatif

Clés API personnelles

Le même catalogue, à disposition de vos outils.

Utilisez une clé API personnelle pour lire et gérer la collection via de simples requêtes HTTP. Collections, objets, exemplaires, historique, emplacements et le reste ne sont pas prisonniers de l'interface.

collections items copies history locations item-types
Créer une clé API Paramètres · Développeur

Nom

Synchro tableau de bord du foyer
Votre nouvelle clé Copier

14|aB3cD4eF5gH6iJ7kL8mN9oP0qR1sT2uV3wX4yZ5aK

Copiez-la maintenant. C'est la seule fois où la clé complète sera affichée.

Référence

Une documentation issue du produit.

La référence de l'API est générée depuis le code. La documentation des points de terminaison est donc conçue pour coller à ce que l'application prend réellement en charge, plutôt que de dériver vers une fiction archéologique.

cURL JavaScript PHP Requête
curl https://kollek.example/api/items \
-H "Authorization: Bearer $KOLLEK_KEY" \
-G --data-urlencode "collection=17" \
--data-urlencode "per_page=2"
200 OK Réponse · application/json
{
"data": [
{ "id": 512,
"name": "Kind of Blue",
"location": "Shelf B2" }
],
"links": { "next": "…?page=2" },
"meta": { "current_page": 1, "total": 128 }
}
Pagination par page (links + meta) 60 requêtes / min par utilisateur Authentification par jeton Bearer

Interopérabilité

Une porte de sortie, volontairement.

Besoin d'analyser votre catalogue ailleurs ? De créer un rapport privé ? De déplacer des informations vers un autre flux ? L'API vous offre une sortie propre sans rendre le produit moins utile à l'intérieur.

API KolleK

kollek.app/api

Votre catalogue

Un script privé

Lisez le catalogue selon un calendrier et faites-en quelque chose de précis.

Votre propre tableau de bord

Récupérez objets et emplacements dans une vue que vous avez créée vous-même.

Un tableur

Exportez une partie de la collection quand un autre outil a besoin des données.

Webhooks

Webhooks : état des lieux honnête.

Vous pouvez enregistrer dès aujourd'hui des points de terminaison webhook signés. Les événements produit ne déclenchent pas encore de livraisons. On ne va pas appeler ça « bientôt disponible » en espérant que vous devinerez le reste.

Points de terminaison webhook 1 enregistré
https://hooks.mydash.io/kollek Inactif
Secret de signature whsec_••••••8d2f
Schéma de signature HMAC-SHA256
Livraisons 0
L'enregistrement des points de terminaison et la signature fonctionnent dès maintenant. Aucun événement produit ne déclenche encore de livraison, donc ce point de terminaison restera inactif jusque-là.

Lisez la référence. Construisez ce que vous vouliez vraiment.

Points de terminaison, authentification, pagination et limites de débit, générés depuis le code et prêts pour votre clé.

Explorer la référence de l'API

KolleK n'est peut-être pas (encore) fait pour vous si…

Vous avez besoin d'intégrations clés en main avec tous les services possibles.

Vous avez besoin de webhooks événementiels dès aujourd'hui. Les points de terminaison et la signature existent, mais aucun événement produit ne les déclenche encore.

Choisissez KolleK quand…

Vous voulez une API JSON documentée pour vos propres outils et scripts.

Vous avez besoin d'un accès direct au catalogue, authentifié par jeton, dès maintenant.

Nous mettrons cette page à jour quand le produit évoluera. La page d'état des fonctionnalités contient les détails ennuyeux mais importants.