Deepglot integrieren

Schnellstart

1. 1.Konto erstellen und im Dashboard ein Projekt mit Quell- und Zielsprachen anlegen.
2. 2.Einen Projekt-API-Key erstellen. Der Klartext wird nur einmal angezeigt und gehört nicht in Browser-Code.
3. 3.Das WordPress-Plugin installieren, API-URL und Key eintragen und den Verbindungstest ausführen.
4. 4.Eine übersetzte URL öffnen und Navigation, hreflang, Cache, dynamische Inhalte und Kontingentstatus prüfen.

API-Referenz

curl https://deepglot.ai/api/translate \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 9b9e42d8-7ef2-4a91-82ff-b5ec71ba5832" \
  -d '{
    "l_from": "de",
    "l_to": "en",
    "words": [{ "w": "Hallo Welt", "t": 1 }],
    "request_url": "https://example.com/",
    "bot": 0
  }'

{
  "l_from": "de",
  "l_to": "en",
  "request_url": "https://example.com/",
  "title": "",
  "bot": 0,
  "from_words": ["Hallo Welt"],
  "to_words": ["Hello world"]
}

HTTP/1.1 200 OK

// Database unavailable: HTTP 503 with a service_unavailable Problem Details body.

[
  {
    "code": "de",
    "local_name": "Deutsch",
    "english_name": "German",
    "sharedAcrossProviders": true
  }
]

{ "is_supported": true }

{
  "exclusions": { "urls": [], "regexes": [], "selectors": [] },
  "urlSlugs": [
    { "originalSlug": "ueber-uns", "translatedSlug": "about-us", "langTo": "en" }
  ],
  "syncedAt": "2026-07-13T10:00:00.000Z"
}

{
  "routingMode": "PATH_PREFIX",
  "siteUrl": "https://example.com",
  "sourceLanguage": "de",
  "targetLanguages": ["en"],
  "autoRedirect": false,
  "translateEmails": false,
  "translateSearch": true,
  "translateAmp": false,
  "domainMappings": []
}

{
  "ok": true,
  "project": {
    "id": "project-id",
    "originalLang": "de",
    "languages": [{ "langCode": "en", "isActive": true }]
  }
}

WordPress

Die Plugin-REST-Routen laufen auf der WordPress-Site und benötigen WordPress-Administratorrechte. Die dynamische Übersetzung verwendet Nonce, kurzlebiges Wortticket, per-IP-Budget und den serverseitigen Organisations-Cap. Fehlende Berechtigung fällt cachebasiert zurück; Bots lösen keine neue Übersetzung aus.

Ein universelles JavaScript-Snippet und ein Reverse Proxy sind derzeit nicht verfügbar. WordPress ist der einzige unterstützte Integrationsweg.

AMP-Seiten durchlaufen die Übersetzung nur bei aktivierter Plugin-Option. Die mehrsprachige Sitemap unter /deepglot-sitemap.xml wird in robots.txt angekündigt und enthält ausschließlich validierte interne Sprachalternativen.

• GET /wp-json/deepglot/v1/settings
• PUT /wp-json/deepglot/v1/settings
• PATCH /wp-json/deepglot/v1/settings
• GET /wp-json/deepglot/v1/status
• POST /wp-json/deepglot/v1/test-connection
• POST /wp-json/deepglot/v1/translate-dynamic

Fehler und Wiederholungen

Öffentliche und Plugin-Routen verwenden einen Problem-Details-artigen JSON-Vertrag. error bleibt als Legacy-Alias für bestehende Plugin-Versionen erhalten. Clients sollen code und status auswerten; detail ist für Menschen.

{
  "type": "https://deepglot.ai/problems/validation-failed",
  "title": "Validation failed",
  "status": 400,
  "detail": "languageFrom and languageTo are required.",
  "code": "validation_failed",
  "instance": "/api/public/languages/is-supported",
  "error": "languageFrom and languageTo are required.",
  "errors": { "languageFrom": ["Required"], "languageTo": ["Required"] }
}

Webhooks

Verwaltende Projektmitglieder konfigurieren öffentliche HTTPS-Ziele. Deepglot prüft Ziele bei Anlage und Versand gegen SSRF, signiert timestamp.payload mit HMAC-SHA256 und sendet X-Deepglot-Event, X-Deepglot-Timestamp und X-Deepglot-Signature. Fehlversuche werden nach 60, 300 und 900 Sekunden wiederholt.

• translation.created
• translation.updated
• translation.manual_updated
• glossary.upserted
• glossary.deleted
• slug.upserted
• import.completed

Projektoberflächen

Diese Routen versorgen das Dashboard und sind nicht als externer stabiler REST-Vertrag freigegeben. API-Keys, Sprachen, Webhooks, Ausschlüsse und das Pro+-Übersetzungsgedächtnis benötigen Verwaltungsrechte. Menschliche Prüfungen und PDF-Übersetzungen sind zusätzlich projekt- und sprachgebunden; nur Verwaltende dürfen zuweisen oder freigeben. Glossar-CRUD verwendet derzeit die schwächere Projektmitgliedschaftsprüfung. Import, Export und Editor-Sitzungen verwenden angemeldete, projektspezifische Zugriffe.

Sprachen, Versionierung und Support