Entwickler & Claude Code

Produkte automatisiert hochladen – per REST-API oder direkt aus Claude Code. Ideal, wenn du viele Produkte erzeugst oder pflegst.

So bleibt der Shop sauber: Alles, was über die API kommt, startet im Status in_review. Unser Team prüft und gibt frei – erst dann ist ein Produkt im Katalog sichtbar und kaufbar. Selbst freischalten ist über die API nicht möglich.

1. Einmal einrichten, dann Schlüssel erstellen

Vor dem ersten Produkt richtest du dein Creator-Konto einmal ein (Name/Firma, Anschrift, Telefon, Steuerstatus, Creator-Bedingungen): Creator-Konto einrichten. Ohne Einrichtung antwortet die API mit 403 creator_setup_required.

Im Creator-Dashboard unter „API & Claude Code“ einen Schlüssel anlegen. Er beginnt mit ip24_ und wird nur einmal angezeigt – wie ein Passwort behandeln. Verlorene Schlüssel einfach widerrufen und neu erstellen.

2. Mit Claude Code verbinden

Im Terminal (einmalig):

claude mcp add --transport http infopoint24 https://infopoint24.com/api/mcp \
  --header "Authorization: Bearer ip24_DEIN_SCHLÜSSEL"

Danach kannst du Claude Code in normaler Sprache beauftragen, zum Beispiel:

Lege für die PDF ./ausgabe/steuer-ordner.pdf ein Produkt bei InfoPoint24 an:
Titel „Steuerordner für Selbstständige“, 9,90 €, passende Kategorie,
Beschreibung und 5 Stichpunkte aus dem PDF-Inhalt. Lade danach die Datei hoch.

Claude nutzt dafür die Werkzeuge list_categories, create_product und get_upload_url (liefert einen fertigen curl-Befehl – die Datei geht direkt an uns, nicht durch das Sprachmodell). Für viele fertige Produktordner gibt es get_import_upload_url.

3. REST-API

Jede Anfrage mit Header Authorization: Bearer ip24_…. Antworten sind JSON; Fehler haben die Form { "error": { "code", "message", "details"? } } – bei 422 stehen in details alle fehlerhaften Felder auf einmal.

GET	/api/v1/me	Verbindungstest: zu wem gehört der Schlüssel?
GET	/api/v1/categories	Gültige Kategorien (categorySlug)
GET	/api/v1/products	Eigene Produkte mit Status
POST	/api/v1/products	Produkt anlegen (JSON) → Status in_review
GET	/api/v1/products/{slug}	Ein eigenes Produkt
PATCH	/api/v1/products/{slug}	Felder ändern (nur gesendete)
PUT	/api/v1/products/{slug}/file	Produktdatei hochladen (roher Body, Header X-Filename)
POST	/api/v1/import[?dryRun=1]	Viele Produkte als ZIP (Format unten)
PUT	/api/v1/uploads/{token}	Einmal-Upload-Adresse (aus dem MCP-Werkzeug, ohne Schlüssel)
POST	/api/mcp	MCP-Server für Claude Code und andere MCP-Clients

Produkt anlegen und Datei hochladen:

curl -X POST https://infopoint24.com/api/v1/products \
  -H "Authorization: Bearer $IP24_KEY" -H "Content-Type: application/json" \
  -d '{"title":"Steuerordner für Selbstständige","categorySlug":"business",
       "priceCents":990,"description":"Belege, Fristen und Unterlagen an einem Ort …",
       "highlights":["Fristenkalender","Belegliste"],
       "aiAssisted":true,"rightsConfirmed":true}'

curl -X PUT https://infopoint24.com/api/v1/products/steuerordner-fuer-selbststaendige/file \
  -H "Authorization: Bearer $IP24_KEY" -H "X-Filename: steuerordner.pdf" \
  --data-binary @steuerordner.pdf

Felder: title (3–200), description (20–5000, Markdown), categorySlug, priceCents (Cent, 990 = 9,90 €, 0 = kostenlos), optional subtitle, fileType (Standard PDF), language (Standard DE), highlights (max. 12), affiliatePercent (Partnerprovision), aiAssisted (KI-Kennzeichnung). Pflicht beim Anlegen: rightsConfirmed: true – damit bestätigst du wie mit dem Häkchen im Web, dass du alle Rechte am Produkt hast, die Angaben stimmen und KI-Nutzung gekennzeichnet ist. Dateien: PDF, ZIP, EPUB, PNG, JPG bis 25 MB – Endung und Inhalt müssen passen.

4. Viele Produkte auf einmal (ZIP)

Je Produkt ein Ordner mit listing.md (Zeilen **Titel:** und **Preis:** 9 €, Abschnitt „Verkaufstext“), Kapiteldateien 00-….md, der fertigen PDF und optional cover-1280x720.jpg. Erst mit ?dryRun=1 prüfen – die Antwort listet je Ordner neu, geändert, unverändert oder Fehler mit Begründung. Der echte Import braucht ?rightsConfirmed=1 (gilt für alle Produkte im ZIP). Max. 200 Ordner bzw. 200 MB je ZIP.

curl -X POST "https://infopoint24.com/api/v1/import?dryRun=1" \
  -H "Authorization: Bearer $IP24_KEY" --data-binary @produkte.zip

5. Grenzen & Regeln

60 Anfragen pro Minute und Schlüssel, höchstens 10 aktive Schlüssel.
Einmal-Upload-Adressen gelten 30 Minuten und genau einen erfolgreichen Upload.
Nur eigene Produkte sind sichtbar und änderbar; gesperrte Produkte nur über das Team.
Keine erfundenen Bewertungen, Verkaufszahlen oder Versprechen; Inhalte müssen dir gehören oder lizenziert sein. Es gelten die AGB.