Entwickler-Dokumentation

Version 1.0.0

Basis-URL: https://listinghelper.kreativschicht.de

OpenAPI-Spezifikation: YAML ansehen | JSON ansehen

Für interaktive Dokumentation importieren Sie die OpenAPI-Spezifikation in Postman oder Insomnia.

Schnellstart

1. Zugangscode erhalten

Option A: Self-Service (Empfohlen) - Erstellen Sie sofort einen KOSTENLOSEN Zugangscode über die Benutzeroberfläche:

Besuchen Sie die Loslegen-Seite:

🚀 KOSTENLOSEN Zugangscode erstellen

Keine Anmeldung erforderlich. Erhalten Sie Ihren Code in <10 Sekunden.

Option B: Admin-Schlüssel (Für selbst gehostete Bereitstellungen)

curl -X POST https://listinghelper.kreativschicht.de/api/admin/keys \
  -H "Content-Type: application/json" \
  -H "x-admin-key: YOUR_ADMIN_KEY" \
  -d '{"name": "My Key", "plan": "FREE"}'

Note: Requires ADMIN_BOOTSTRAP_KEY environment variable. Only for administrators.

2. Analyze a Product

curl -X POST https://listinghelper.kreativschicht.de/api/analyze \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "productDraft": {
      "title": "Handmade Leather Wallet",
      "category": "Accessories",
      "brand": "Artisan Goods"
    },
    "platforms": ["etsy"],
    "flags": {
      "enableTitles": true,
      "enableTags": true,
      "enableImageChecks": false
    }
  }'

API Endpoints

POST /api/analyze

Generieren Sie plattformoptimierte Titel, Tags und Bildanalysen.

Auth: x-api-key

GET /api/me

Informationen über Ihren Zugangscode abrufen.

Auth: x-api-key

GET /api/me/usage

Nutzungsstatistiken für Ihren Zugangscode abrufen.

Auth: x-api-key | Query: ?days=30

POST /api/me/rotate-key

Rotieren Sie Ihren Zugangscode (generiert neuen Schlüssel, macht alten ungültig).

Auth: x-api-key

POST /api/billing/checkout

Erstellen Sie eine Stripe-Checkout-Sitzung, um Ihren Plan zu upgraden.

Auth: x-api-key | Body: {"plan": "PRO"}

POST /api/billing/portal

Erstellen Sie eine Stripe-Kundenportal-Sitzung zur Verwaltung von Abonnements.

Auth: x-api-key

POST /api/admin/keys

Erstellen Sie einen neuen Zugangscode (nur Admin).

Auth: x-admin-key

GET /api/admin/keys

Alle Zugangscodes auflisten (nur Admin).

Auth: x-admin-key

SDKs & Tools

TypeScript SDK

import { createClient } from '@listing-ai/sdk';

const client = createClient({
  baseUrl: 'https://listinghelper.kreativschicht.de',
  apiKey: 'YOUR_API_KEY',
});

const result = await client.analyze({
  productDraft: { title: 'Leather Wallet' },
  platforms: ['etsy'],
  flags: {
    enableTitles: true,
    enableTags: true,
    enableImageChecks: false,
  },
});

See /packages/sdk/README.md for full documentation.

CLI Tool

# Set base URL (optional, defaults to localhost:3000)
export LISTING_AI_BASE_URL="https://listinghelper.kreativschicht.de"
export LISTING_AI_API_KEY="YOUR_API_KEY"

# Analyze a product
listing-ai analyze --platform etsy --name "Leather Wallet" --pretty

# Check account info
listing-ai me --pretty

# View usage stats
listing-ai usage --days 30 --pretty

See /packages/cli/README.md for full documentation.

Authentication

Most API endpoints require authentication via the x-api-key header. Admin endpoints require the x-admin-key header instead.

# User endpoint (with API key)
curl -H "x-api-key: YOUR_API_KEY" https://listinghelper.kreativschicht.de/api/me

# Admin endpoint (with admin key)
curl -H "x-admin-key: YOUR_ADMIN_KEY" https://listinghelper.kreativschicht.de/api/admin/keys

Plan Limits

Plan	Titles/Run	Images/Run	Platforms/Run	Durchläufe/Tag
FREE	5	1	1	20
PRO	15	6	2	200
BUSINESS	30	12	3	2000