Overview
Welcome to the documentation of the Wordbee Translator API, version 2. It is a web-based API to retrieve and update information in Wordbee Translator.
A key difference compared to version 1 of the API is that API credentials can be created individually per user. Credentials inherit the access rights (or profile) of the users. You can create dedicated API users to allow different people or systems to interact with the API and within a defined framework of rights.
This API is work in progress and new methods are added every month. You can find the change history here.
The API 2 endpoint is your Wordbee Translator URL + /api
Please make sure to use the endpoint that applies to your platform throughout this documentation. Read more
Chapters:
- Overview
- Endpoints
- Error handling and code
- Authentication — API methods currently use a token based mechanism.
- Projects — Provides methods to work with projects, their documents, word counts and other.
- Jobs — Provides methods to enumerate and manage jobs.
- Workflows
- Resources — This namespace provides API methods to retrieve and manipulate data related to segments, documents, document sets, source/target files and attachments and other related data.
- resources/segments/rights
- resources/items
- Search and filter segments
- resources/segments/view
- resources/segments/io
- Export to TMX, EXCEL, CSV, ODS, TBX
- Copy / Consolidate resources
- resources/segments/actions
- resources/segments/finder
- resources/segments/reports
- resources/segments/sampling
- resources/documents
- resources/comments
- resources/timeline
- resources/files
- resources/qa
- Statistics
- resources/team
- resources/list
- Text edits
- Objects - resources
- Persons — API methods to retrieve or update information related to persons (users).
- Companies — API methods to retrieve or update information related to companies: my company, supplier companies, client companies.
- Invoices — This section describes invoice related methods: Find invoices. View details, update details, delete invoices.
- Services
- Orders
- Business Reports
- Business Analytics — Provides methods to access global or specific business analytics (BA) reports and information.
- Administration — Provides administrative tools.
- Media — Provides methods to enumerate, get and manage medias: Download and upload files, retrieve images etc.
- Urls — Urls to open different objects in Wordbee such as the translation editor.
- Settings — Provides methods to retrieve and update platform settings such as languages and task codes.
- Languages and codes
- Document formats
- Document format profiles
- Word count profiles
- settings/tbx
- Machine translation
- Custom field configuration
- Segmentation settings (SRX)
- Workflow Templates
- User profiles
- settings/tasks/codes
- settings/currencies/codes
- settings/domains/codes
- settings/countries/codes
- settings/timezones/codes
- Applications — Various product tools and applications with their APIs such as MT Hive.
- Asynchronous operations — Operations that take more time to execute are most often executed "asynchronously" i.e. in the background. With such operations your API call either immediately returns the final result (if the operation was very quick) or it returns the ID of the operation if executing in the background. The status can then be polled in regular intervals.
- Common — This chapter discusses general concepts or mechanisms linked from other pages.
- Types
- Objects
- Lists — GETTING STARTED
- Auto-completion and pagination — Many API methods implement optional auto-completion and pagination functionality:
- API Best Practices
- Change history — The API is evolving fast and new methods or features are added every month.
Copyright Wordbee - Buzzin' Outside the Box since 2008