User Tools

Site Tools


api:porting:order

API : Porting Order

Introduction

This request will order the porting at OCH (Danish central phone numbers database). The ordering will send a request to the donor operator, asking them to release the number(s) on a given date. The donor operator will then confirm the requested date or set a later date if they have a valid reason for doing so, or they may reject the porting.

When ordering a porting there can be a delay between calling the order request and it to be actually carried out. This is because some operator requires a delay between receiving the POA document and the order going through. If this is the case, the property autoStartOrder is set and will contain the date and time the order will be sent.

Request

URL https://api.telecomx.dk/porting/PORTING_ID/order
Method GET
Access level RESELLER_ADMIN with PORTING feature.
Param PORTING_ID Id of the porting (24 hex-char string)

Query example

https://api.telecomx.dk/porting/1234567890ABCDEF12345678/order

Response

Json object
success Boolean True if request was sucessful.

Example

{
  success: true
}

Errors

Error code Message Description
400 bad_request Porting id not found in requested URI
403 stage Porting is not at the right stage to be ordered
409 id An outporting cannot be ordered
500 internal_error Failed to lookup operator 'X'
409 documents Porting cannot be ordered, because no porting documents (POA) exists
409 operator Donor operator updated on porting, POA not valid anymore
404 not_found Porting not found
500 internal_error <Unspecified>
api/porting/order.txt · Last modified: 2023/10/30 14:26 by Per Møller

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki