REST API basisprincipes
Dezelfde bewerkingen als de MCP-tools, als JSON via HTTP. De vormen die het waard zijn om te kennen en waar de volledige referentie zich bevindt.
De REST API is voor CI-scripts en clients zonder MCP. Dezelfde bewerkingen, dezelfde validatie, dezelfde foutvorm als de tools.
Basisprincipes
- Basis-URL:
https://app.tileset.com. - Auth:
Authorization: Bearer <API key>bij elke aanroep. Zie API-sleutels. - Body's zijn JSON. Een foute waarde retourneert een fout met
field,receivedenallowed, zodat een script zichzelf kan corrigeren. Het maken van een widget en het wijzigen van een weigert een foute waarde op dezelfde manier.
De aanroepen die je gaat gebruiken
| Aanroep | Doet |
|---|---|
POST /v1/sources | Koppel een bron: type, "mode": "live", plus een van: query (Google), channelHandle (YouTube), pinterestUrl (een Pinterest profiel- of bordlink), xHandle (een X @handle of profiellink), twitchChannel (een Twitch kanaalnaam of twitch.tv-link), kickChannel (een Kick kanaalnaam of kick.com-link). label is optioneel: laat het weg en de bron krijgt de naam van het account of bedrijf (een testimonialbron accepteert alleen type en label). Zonder "mode": "live" krijg je een demobron met voorbeeldinhoud; met deze parameter geeft een verzoek waarin het veld van het type ontbreekt een 400 terug met de naam van het veld. |
GET /v1/sources, GET/PATCH/DELETE /v1/sources/:id | Lijst, lees, wijzig of verwijder bronnen. PATCH neemt label (hernoemen), updateEvery, manualOnly en schedule. Een PATCH met verschillende delen slaat ze allemaal op of geen van allen |
POST /v1/sources/:id/testimonials, GET /v1/sources/:id/testimonials | Voeg tot 20 testimonials toe (ze wachten op goedkeuring in het dashboard), of tel de wachtende, goedgekeurde en gefilterde (alleen testimonials die via de link zijn verzonden, worden gecontroleerd, nooit wat een sleutel toevoegt). Een sleutel leest de inzendingen nooit terug. Goedkeuren, weigeren (één voor één of meerdere tegelijk), bewerken, verwijderen, de volgorde en het pauzeren of hervatten van de link antwoorden een API-sleutel met 403: een persoon doet dit in het dashboard |
GET /v1/sources/:id/content | Aantallen voor het kiezen van een ontwerp: hoeveel items, hun datums en tempo, sterbeoordelingen, foto's en video's, afbeeldingsvormen, tekstlengtes, schrijfsystemen en reacties van eigenaren. Nooit de items. |
GET/POST /v1/bio, GET/PATCH/DELETE /v1/bio/:id | Pagina's “Link in bio” weergeven of maken (name, de velden van de pagina, en slug op Starter en hoger; zonder een adres wordt de pagina toegewezen), en één lezen, wijzigen (blocks vervangt de lijst, style wijzigt alleen de sleutels die je verzendt) of verwijderen. POST /v1/bio/:id/blocks voegt blokken toe, GET /v1/bio/slug?slug=<slug> controleert of een adres vrij is, en GET /v1/bio/:id/analytics?days=7|30|90 retourneert weergaven en linkklikken (afgelopen 7 dagen vereist een hoger abonnement). Een bezet adres antwoordt 409; een pagina die de limiet van het abonnement overschrijdt of een afgeschermd veld antwoordt 403 |
POST /v1/widgets | Maak een widget van een bron (sourceId, type, plus opties), of van maximaal vier met sourceIds voor een gemengde feed |
GET /v1/widgets, GET/PATCH/DELETE /v1/widgets/:id | Widgets weergeven, lezen, wijzigen of verwijderen |
POST /v1/widgets/:id/check-page | Controleer een pagina voor deze widget (url): dezelfde controle als het verify_install-hulpprogramma. Antwoordt verified, wat het vond in lines, en hints met een oplossing voor elke veelvoorkomende fout. Een lokaal of privéadres wordt geweigerd met 400; 30 controles per uur |
GET /v1/credits, PATCH /v1/credits | Saldo en projectie; stel de maandelijkse limiet in |
GET /v1/prices | Openbaar, geen sleutel: wat een update kost per bron type |
GET /v1/widgets/:id/content | Openbaar, met CORS: de eigen leesfunctie van de embed, alleen voor weergave via de widget (geen data-API) |
POST /v1/hooks/:secret | Een webhook van een bron (geen sleutel; het geheim is de inloggegevens) |
Een account kan maximaal 200 widgets bevatten.
Aantallen, nooit inhoud
Een sleutel leest nooit je inhoud: geen enkele aanroep beantwoordt deze met een post of een recensie. Om het resultaat te zien, opent je https://app.tileset.com/preview/<widgetId>, de widget zoals bezoekers deze zien. De fout van een mislukte bron wordt gelezen als een vaste zin.
Redelijk gebruik
De limieten voor redelijk gebruik antwoorden 429 met reason, why, limit en retryAt, plus een Retry-After-header: wacht tot dan, probeer niet eerder opnieuw. Een zoekopdracht naar bedrijfsnamen die de dagelijkse limiet overschrijdt, antwoordt ook 429. Een nieuwe Google-bron die het gedeelde aantal van de dag overschrijdt, verbindt met queued en toont met firstFetchQueued true totdat de recensies na 00:00 UTC arriveren.
Volledige referentie
De complete, huidige referentie is llms.txt. Deze is gebouwd uit dezelfde bron als de MCP-tools, dus de twee komen altijd overeen. Je pagina zelf roept de API nooit aan: deze laadt alleen het widgetscript.