Die API ansprechen

Die LinkBoost-API ist eine einfache JSON-Schnittstelle für Lesezeichen, Boards, Kategorien und die Merkliste.

So geht's

Leg einen API-Schlüssel an, siehe API-Schlüssel anlegen.
Schick jede Anfrage an https://api.linkboost.one/api/v1 mit der Kopfzeile Authorization: Bearer lbo_live_….
Ruf zuerst GET /key-info auf. Die Antwort zeigt Konto, Tarif und die Rechte des Schlüssels.
Nutze die Endpunkte unten. Jeder braucht das genannte Recht des Schlüssels.

Adresse: https://api.linkboost.one/api/v1. Alle Antworten sind JSON, Eingaben schickst du als JSON mit Content-Type: application/json.
Anmeldung: Kopfzeile Authorization: Bearer lbo_live_… mit deinem API-Schlüssel, nie in der Adresszeile.
Erster Aufruf: GET /key-info zeigt Konto, Tarif und die Rechte des Schlüssels.
Grenze: 60 Anfragen pro Minute und Schlüssel.

curl "https://api.linkboost.one/api/v1/bookmarks?q=steuer" \
  -H "Authorization: Bearer lbo_live_DEIN_SCHLUESSEL"

GET /bookmarks (bookmarks.read): Suche und Liste. Parameter q, board_id, category_id, tag, url, limit (1 bis 100, Standard 20), offset.
GET /bookmarks/{id} (bookmarks.read): ein Lesezeichen.
POST /bookmarks (bookmarks.write): anlegen. Pflicht url und board_id, optional category_id, title, description, note, tags (Liste), favorite. Ohne Titel holt LinkBoost Titel, Symbol und Vorschau selbst.
PATCH /bookmarks/{id} (bookmarks.write): ändern oder verschieben (category_id: null = ohne Kategorie). tags ersetzt die bisherigen Tags.
DELETE /bookmarks/{id} (bookmarks.delete): löschen.

GET /boards, GET /boards/{id} (boards.read): Boards mit Anzahl und Schreibrecht, ein Board mit seinen Kategorien.
POST /boards, PATCH /boards/{id} (boards.write): anlegen (Pflicht name) und umbenennen.
DELETE /boards/{id} (boards.delete): Board samt Lesezeichen löschen.
POST /boards/{id}/categories, PATCH /categories/{id} (boards.write): Kategorie anlegen (Pflicht name, optional parent_id) und umbenennen.
DELETE /categories/{id} (boards.delete): Kategorie löschen, ihre Lesezeichen bleiben ohne Kategorie erhalten.

GET /inbox (inbox.read): Einträge, neueste zuerst. Parameter category_id (Zahl oder none), limit (1 bis 100, Standard 30).
GET /inbox/categories (inbox.read): Kategorien der Merkliste mit Anzahl.
POST /inbox (inbox.write): Seite merken, Pflicht url, optional title, category_id. Ist die Seite schon gemerkt, rückt sie nach oben.
POST /inbox/categories (inbox.write): Kategorie anlegen (name, 1 bis 40 Zeichen).
POST /inbox/{id}/keep (inbox.write und bookmarks.write): Eintrag als Lesezeichen übernehmen, Pflicht board_id, optional category_id, title, note.
DELETE /inbox/{id} (inbox.delete): Eintrag entfernen.

400 invalid_request: Eingabe fehlt oder ist falsch.
401 invalid_key: Schlüssel fehlt, ist unbekannt, widerrufen oder abgelaufen.
402 plan_required oder plan_limit: Tarif enthält die API nicht oder eine Tarifgrenze ist erreicht.
403 missing_scope (mit required), read_only_board: Recht fehlt oder das Board ist nur zum Ansehen mit dir geteilt.
404 not_found: gibt es nicht oder ist für den Schlüssel nicht sichtbar.
409 contains_locked: betrifft eine Kategorie mit Passwort, das geht nur in der App.
429 rate_limited: zu viele Anfragen, die Kopfzeile Retry-After nennt die Wartezeit in Sekunden.

Ein Schlüssel sieht genau das, was die Person sieht, die ihn angelegt hat. Kategorien mit Passwort nie.
Höchstens 60 Anfragen pro Minute und Schlüssel.
Rechte: bookmarks, boards (gilt auch für Kategorien) und inbox, jeweils read, write und delete. Write schließt read ein.