🔑

Developer API

REST API für Entwickler. Integrieren Sie Übersetzungen direkt in Ihren Workflow.

🚀 Schnellstart

Base URL: https://translateshop.ch/api/v1

Auth: Bearer Token im Authorization Header

Format: JSON

🔐 API-Key erstellen

1. Öffnen Sie Ihr TranslateShop Dashboard
2. Klicken Sie auf 🔑 API
3. Klicken Sie auf + Neuen API-Key erstellen
4. Kopieren Sie den Key (beginnt mit ts_)

⚠️ Wichtig

Der API-Key wird nur einmal angezeigt. Speichern Sie ihn sicher!

🔒 Authentifizierung

Fügen Sie den API-Key im Authorization Header hinzu:

Authorization: Bearer ts_IhrApiKey...

Alternativ: X-API-Key: ts_IhrApiKey...

📡 Endpoints

POST/translate

Übersetzt einen Text oder ein Produkt in die gewünschten Sprachen.

Request Body

Parameter	Typ	Beschreibung
`title` *	string	Produkttitel oder Text zum Übersetzen
`description`	string	Optionale Produktbeschreibung
`sourceLanguage`	string	Ausgangssprache: de, fr, it, en (Default: de)
`targetLanguages`	string[]	Zielsprachen: ["fr", "it", "en"]
`industry`	string	Branche: fashion, electronics, food, furniture, beauty, sports, toys, jewelry, automotive, health, garden, pet, office, general
`tone`	string	Tonalität: formal, informal, neutral

Beispiel Request

curl -X POST https://translateshop.ch/api/v1/translate \
  -H "Authorization: Bearer ts_IhrApiKey..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Schwarzes T-Shirt aus Bio-Baumwolle",
    "description": "Bequemes T-Shirt, 100% biologische Baumwolle, Fair Trade zertifiziert.",
    "sourceLanguage": "de",
    "targetLanguages": ["fr", "it", "en"],
    "industry": "fashion",
    "tone": "informal"
  }'

Beispiel Response

{
  "success": true,
  "source": {
    "language": "de",
    "text": "Schwarzes T-Shirt aus Bio-Baumwolle",
    "description": "Bequemes T-Shirt, 100% biologische Baumwolle..."
  },
  "translations": {
    "fr": {
      "title": "T-shirt noir en coton bio",
      "description": "T-shirt confortable, 100% coton biologique..."
    },
    "it": {
      "title": "Maglietta nera in cotone biologico",
      "description": "Maglietta comoda, 100% cotone biologico..."
    },
    "en": {
      "title": "Black organic cotton T-shirt",
      "description": "Comfortable T-shirt, 100% organic cotton..."
    }
  },
  "credits": {
    "used": 3,
    "remaining": 47,
    "is_unlimited": false
  }
}

GET/credits

Gibt das aktuelle Credit-Guthaben zurück.

Beispiel Request

curl https://translateshop.ch/api/v1/credits \
  -H "Authorization: Bearer ts_IhrApiKey..."

Beispiel Response

{
  "credits": 47,
  "is_unlimited": false,
  "email": "ihr@email.ch"
}

💳 Credit-Verbrauch

1 Credit = 1 Sprache pro Übersetzung

Beispiel:

1 Produkt in 3 Sprachen (FR, IT, EN) = 3 Credits

Credits werden nur bei erfolgreicher Übersetzung abgezogen.

⚠️ Fehlercodes

Code	Beschreibung
`401`	Ungültiger oder fehlender API-Key
`400`	Ungültige Parameter (z.B. fehlender title)
`402`	Nicht genügend Credits
`500`	Server-Fehler

⏱️ Rate Limits

• 10 Requests/Sekunde pro API-Key

• Für höhere Limits: Kontaktieren Sie uns

Jetzt API-Key erstellen →