Developer API Reference

Developer API V1 — localization over Translation Memory and the commercial usage ledger. OpenAPI spec: openapi/developer-v1.yaml in the repository.

Authentication

• Bearer gos_live_… or gos_test_… secret keys
• Environment: GLOBALIZATIONOS_API_KEY
• Authentication guide

Translate

POST /api/v1/developer/translations
Authorization: Bearer gos_live_…
Content-Type: application/json

{
  "projectId": "YOUR_PROJECT_ID",
  "sourceLocale": "de",
  "targetLocale": "en",
  "text": "Guten Morgen"
}

Endpoints

• POST /api/v1/developer/translations — sync translate
• POST /api/v1/developer/translations/batch — bounded batch
• GET /api/v1/developer/translations/:id — retrieve recent result
• GET /api/v1/developer/usage — meter and usage summary

Errors

Stable { error: { code, message, requestId } } envelope. See error documentation (15 codes).

Rate limits

Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After on 429.

← Quickstart