Integrate Deepglot

Quickstart

1. 1.Create an account and a dashboard project with source and target languages.
2. 2.Create a project API key. Its plaintext is shown once and must not be embedded in browser code.
3. 3.Install the WordPress plugin, enter the API URL and key, and run the connection test.
4. 4.Open a translated URL and verify navigation, hreflang, cache, dynamic content, and quota status.

API reference

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

Plugin REST routes run on the WordPress site and require WordPress administrator permissions. Dynamic translation uses a nonce, short-lived word ticket, per-IP budget, and the server-side organization cap. Missing authorization degrades to cache-only behavior; bots never trigger fresh translation.

A Universal JavaScript snippet and reverse proxy are not currently available. WordPress is the only supported integration path.

AMP pages enter the translation pipeline only when the plugin option is enabled. The multilingual sitemap at /deepglot-sitemap.xml is advertised in robots.txt and contains only validated internal language alternatives.

• 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

Errors and retries

Public and plugin routes use a Problem Details-style JSON contract. error remains as a legacy alias for existing plugin versions. Clients should branch on code and status; detail is human-readable.

{
  "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

Project managers configure public HTTPS targets. Deepglot checks targets for SSRF at creation and dispatch, signs timestamp.payload with HMAC-SHA256, and sends X-Deepglot-Event, X-Deepglot-Timestamp, and X-Deepglot-Signature. Failed deliveries retry after 60, 300, and 900 seconds.

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

Project surfaces

These routes power the dashboard and are not a stable external REST contract. API keys, languages, webhooks, exclusions, and the Pro+ translation-memory setting require management access. Human review and PDF translation are additionally project- and language-scoped; only managers may assign or approve. Glossary CRUD currently uses the weaker project-membership gate. Import, export, and editor sessions use signed-in, project-specific access.

Languages, versioning, and support