API Reference

curl -X GET "https://api.unlingo.com/v1/translations?release=1.0.0&namespace=common&lang=en" \
  -H "x-api-key: your_api_key_here"

https://api.unlingo.com

{
  "translations": {
    "greeting": "Hello",
    "farewell": "Goodbye",
    "welcome": "Welcome to our app"
  },
  "release": {
    "tag": "1.0.0"
  },
  "build": {
    "tag": "v1.0.0",
    "namespace": "common"
  }
}

{
  "error": "Missing required parameters: release, namespace, and lang are required",
  "example": "/v1/translations?release=1.0.0&namespace=common&lang=en"
}

{
  "error": "Invalid API key"
}

{
  "error": "Release tag '1.0.0' not found"
}

{
  "error": "Request limit exceeded. Please upgrade your plan or wait for the monthly reset.",
  "currentUsage": 10500,
  "limit": 10000,
  "resetPeriod": "monthly"
}

{
  "key": "greeting.hello",
  "value": "Hello, World!",
  "namespace": "common",
  "language": "en"
}

{
  "error": "Missing required parameters: namespace, key, and lang are required",
  "example": "/v1/keys?namespace=common&key=greeting.hello&lang=en"
}

{
  "error": "Key 'greeting.hello' not found in namespace 'common'"
}

{
  "error": "Request limit exceeded. Please upgrade your plan or wait for the monthly reset.",
  "currentUsage": 10500,
  "limit": 10000,
  "resetPeriod": "monthly"
}

{
  "build": "v1.0.0",
  "namespace": "common",
  "language": "en",
  "url": "https://storage.example.com/signed-url...",
  "expiresIn": 600
}

{
  "build": "v1.0.0",
  "namespace": "common",
  "languages": {
    "en": {
      "url": "https://storage.example.com/signed-url-en...",
      "fileSize": 2048
    },
    "fr": {
      "url": "https://storage.example.com/signed-url-fr...",
      "fileSize": 2156
    },
    "de": {
      "url": "https://storage.example.com/signed-url-de...",
      "fileSize": 2234
    }
  },
  "expiresIn": 600
}

{
  "error": "Build 'v1.0.0' is not ready yet: Processing languages"
}

{
  "error": "Missing required parameter: build is required",
  "example": "/v1/builds?build=v1.0.0 or /v1/builds?build=v1.0.0&lang=en"
}

{
  "error": "Build 'v1.0.0' not found"
}

{
  "namespace": "common",
  "build": "v1.0.0"
}

{
  "success": true,
  "buildId": "abc123xyz",
  "build": "v1.0.0",
  "namespace": "common",
  "status": "building",
  "message": "Build creation started. Use GET /v1/builds?build=v1.0.0 to check status."
}

{
  "error": "Missing required fields: namespace and build are required",
  "example": "{ \"namespace\": \"common\", \"build\": \"v1.0.0\" }"
}

{
  "error": "Namespace 'common' not found"
}

{
  "error": "Build tag 'v1.0.0' already exists"
}

{
  "error": "Request limit exceeded. Please upgrade your plan or wait for the monthly reset.",
  "currentUsage": 10500,
  "limit": 10000,
  "resetPeriod": "monthly"
}