Help
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 25 req/sec. Subsequent requests are ignored and get a 429 response.
🔗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
6 different resources can be accessed. Their specification is separated into different sections in the documentation:
- Project API
- User API
- File API
- Stats API
- Locale API
- String API
- Translation API
- TermBase API
- TermBase Translation API
We made a ruby client that uses these endpoints. Use it or take a look at it as an implementation example.