WebTranslateIt API

This document describes the resources that make up the WebTranslateIt API. If you have any problems or requests, please contact support.

This API is considered stable. No breaking changes will occur.

Schema

All API access is over HTTPS and accessed from:

https://webtranslateit.com/api/

Data may be returned by WebTranslateIt as JSON, YAML and XML, depending on the endpoints.

Authentication

Authentication is made by so-called API tokens. Each project gets 2 unique API tokens you can find in the project settings:

  • the read-write token. A token that allows calls to all API endpoints,
  • the read-only token. A token that allows calls to GET API endpoints (Project API, File API and Statistics API).

Rate Limiting

We rate limit the API endpoints based on IPs to 25 req/sec. Subsequent requests are ignored and get a 429 response.

CORS

All API endpoints are accessible via Cross-origin resource sharing (CORS), which means that all endpoints can be requested from another domain from which the first resource was served.

HTTP Verbs

The WebTranslateIt API uses appropriate HTTP verbs for each action.

  • GET Used for retrieving resources.
  • POST Used for creating resources.
  • PATCH Used for replacing resources (although PUT can also be used).
  • DELETE Used for deleting resources.

Endpoints

11 different resources can be accessed. Their specification is separated into different sections in the documentation:

We made a ruby client that uses these endpoints. Use it or take a look at it as an implementation example.