API : Special destination Create
Introduction
This request will create a new special destination: a Danish service number with its own connection fee and pr. minute rate.
Request
| URL | https://api.telecomx.dk/destination/special |
| Method | POST |
| Access level | RESELLER_ADMIN with FINANCE feature, or ADMIN. |
| Body | _id | String | Prefix of the Danish special number: +45 followed by digits, e.g. +4590123456. |
| name | String | Name of the service offered. |
| fee | Number | Connection fee, 0-100000. |
| rate | Number | Pr. minute rate, 0-100000. |
| vatExemption | Boolean | [optional] True if the call is VAT free, default false. |
Request body example
{
"_id": "+4590123456",
"name": "Example fundraising show",
"fee": 1.5,
"rate": 0.5,
"vatExemption": true
}
Response
The created special destination is returned.
| JSON object |
| _id | String | Prefix of the Danish special number. |
| name | String | Name of the service offered. |
| fee | Number | Connection fee. |
| rate | Number | Pr. minute rate. |
| vatExemption | Boolean | True if the call is VAT free. |
Example
{
"_id": "+4590123456",
"name": "Example fundraising show",
"fee": 1.5,
"rate": 0.5,
"vatExemption": true
}
Errors
| Error code | Message | Description |
| 404 | _id | Prefix is missing |
| 404 | name | Name is missing |
| 404 | fee | Fee is missing |
| 404 | rate | Rate is missing |
| 422 | _id | Prefix is not valid |
| 422 | name | Name is not valid |
| 422 | fee | Fee is not valid |
| 422 | rate | Rate is not valid |
| 409 | _id | The prefix already exists |
| 403 | access_denied | Insufficient access level |
| 500 | internal_error | <Unspecified> |