Er zijn twee manieren waarop iets anders dan jijzelf kan handelen in je creativehub-account: een gekoppelde app (connected app), een AI-app zoals Claude of Gemini waarbij je inlogt en toestemming geeft, en een API-token dat je voor je eigen scripts maakt. Beide verschijnen in de tokentabel op het tabblad API / MCP van Settings, en voor beide moet API / MCP-toegang voor het account zijn ingeschakeld.
Wat een gekoppelde app is
Als je het verbindingsadres van creativehub in een AI-app plakt, registreert de app zichzelf bij creativehub en stuurt hij je naar de toestemmingspagina. Je logt in met je eigen creativehub-login, ziet waar de app om vraagt en klikt op Allow. De app krijgt dan een kortlevend toegangstoken voor je account en verlengt dat zelf; je ziet of plakt nooit een sleutel, en je wachtwoord wordt nooit aan de app gegeven.
De toestemmingspagina noemt de app, toont het account waarmee je bent ingelogd, zegt dat je de koppeling op elk moment kunt verbreken via Settings › API / MCP, en noemt de site waarnaar je wordt teruggestuurd.
Wat de app mag doen
De toestemmingspagina toont de rechten als twee scopes:
- See your drops, products, orders, styles and insights (lezen).
- Create and change drops, products and styles, and place orders on your behalf (schrijven).
Een app met alleen leesrechten wordt bij elke wijziging die hij probeert te maken geweigerd (de foutmelding zegt dat de verbinding alleen-lezen is), dus een alleen-lezenverbinding kan kijken maar nooit iets aanmaken, bewerken, publiceren of bestellen. Binnen wat is toegestaan kan een gekoppelde app precies doen wat jij in Sell kunt doen, alleen op jouw account: elk verzoek is beperkt tot jouw gebruiker, dus hij kan geen ander account zien. Bestellingen die hij plaatst worden op dezelfde manier afgerekend als bestellingen die je zelf plaatst.
Verbinding verbreken
Trek de app in via de tokentabel (Revoke). Hij stopt binnen een minuut met werken, en de enige weg terug is opnieuw koppelen: inloggen en Allow. Het intrekken van een gekoppelde app raakt je API-tokens niet, en het intrekken van een token raakt je gekoppelde apps niet.
Wanneer je in plaats daarvan een API-token gebruikt
Een token (esch_live_…) is bedoeld voor software die je zelf draait: een script, een CI-taak, een website-integratie. Het is een volledig inlogbewijs: iedereen die het bezit kan als jou handelen, dus het wordt één keer getoond en moet geheim blijven. Een gekoppelde app is voor een AI-assistent die je interactief gebruikt, waarbij inloggen veiliger is dan een sleutel hanteren. Zie API-tokens maken voor het publieke /v1-oppervlak.
Hoe je ook koppelt, op de pagina Print Drops zie je wat voor release je app of assistent je kan helpen opzetten.