services/persons/{uid}/services/new (POST)
To create a new service for a person/user.
Note that person-level services are only supported for inhouse users and client users. The latter allow to assign work to users at the client.
URL
(POST) /api/services/persons/{uid}/services/new
PARAMETERS
URL parameters are:
uid | The ID of a user/person. This must be an inhouse user or a user attached to a client. | Integer, Mandatory |
The body must include a JSON object with the properties below.
src | The source language code of the service. The special code "*" is a placeholder for any language: The service can be used for any source language. To discover all languages see settings/languages | string, Mandatory |
trg | The target language code of the service. The special code "*" is a placeholder for any language: The service can be used for any source language. | string, Mandatory |
task | The service task code such as TR for translation or RV for revision. To discover all task types, see settings/tasks/codes | string, Mandatory |
comments | Optional internal comments (never visible to external users or unauthorized internals). | string?, Optional |
rating | Optional rating from 0 (not set) to 6 (best). Default if not specified: 3 | int, Optional |
unit | The unit that will be costed. Such as WD (words) or CH (characters). See this API to obtain a list of all units: Price units | string, Mandatory |
unitsCount | Indicates the number of units (unit) that the service amount includes. In most cases this will be 1, but not in all: Examples: "20 cents per 1 word", "20 cents per 15 characters", etc. Default if not specified: 1 | int, Optional |
currency | The currency. A three letter code such as EUR or USD. See this method to get all currencies: settings/currencies/codes | string, Mandatory |
amount | Optional service amount. Services can be defined without an amount (null value). Default if not specified: null | decimal?, Optional |
leadHours | Used for deadline calculation. Defines the number of hours upon transmission of a request until the time in hours the work typically starts. Default if not specified: 0 (no lead time) | int, Optional |
unitsPerDay | Used for deadline calculation. Defines the number of units the service provider can do in a work day. Default if not specified: 0 (not specified) | int, Optional |
RESULTS
The method returns the updated service.
The properties are the same as described here: services/persons/{uid}/services/{svcid}
ACCESS RIGHTS
See Services.
Copyright Wordbee - Buzzin' Outside the Box since 2008