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, JSONP, 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 private token. A read-write token that allows to call all API endpoints,
  • the public token. A read-only token that allows to call read-only API endpoints (Project API, File API and Statistics API).

Rate Limiting

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

HTTP Verbs

The WebTranslateIt API uses appropriate HTTP verbs for each action.

  • GET Used for retrieving resources.
  • POST Used for creating resources.
  • PUT Used for replacing resources.
  • DELETE Used for deleting resources.

Endpoints

6 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.