Comprar números gratuitos

Después de encontrar, o al encontrar y reservar, sus números gratuitos únicos, use Comprar Números Gratuitos para adquirirlos.   

Puntos de conexión y métodos
POST /_rest/v3/my/tf/orders

Parámetros

Encabezados

Accept: application/json

Authorization: xxxxxxxxxxxxxxxxx

Content-Type: application/json

 

Campo

Tipo

Descripción

Accept
String

application/json

 

Authorization


String

Token de autorización (vea Autenticar)

 

Content-Type
String

application/json

 
Ruta

Campo

Tipo

Descripción

Email optional
String

Una dirección de correo electrónico para notificar sobre los cambios en este estado de la solicitud.

 

  • Debe ser escalar

 

myRespOrg optional
Boolean

¿Los números deberían ser proporcionados a los RespOrg de los clientes en vez de los operadores RespOrg?

 

  • Por defecto falso.

 

Notes optional
String

Notas sobre el cumplimiento de esta solicitud.

 

  • Debe ser escalar

 

numbers

Array

Una serie de números reservados por solicitar

 

  • Mutuamente excluyente con cantidad y reservas
  • Cada elemento se encuentra de la siguiente manera:

 

{

    "countryCode": "1",
    "number": "8882223456"
}

packageID
Integer

El packageID target para el cual solicitar los números.

 

  • Debe ser escalar

 

quantity
Integer

La cantidad de números a solicitar.

 

  • Debe ser escalar
  • Mutuamente excluyente con números y reservas

 

reservations
String

Uno o más reservationIDs que indiquen los números a solicitar

 

  • Mutuamente excluyente con cantidad y reservas

 

referenceIDoptional
String

Una cadena de caracteres no vacía que indica su ID o código de referencia.

 

  • Debe ser escalar

 

serviceArea
Integer

El área de servicios para números deseados (ver Búsquedas– Área de Servicios).

 

  • Debe ser escalar

 

{

    "reservationID": [

        "BD929A2A-7F48-11E6-B908-52540029234D",

        "0F85813F-7E8B-11E6-B908-52540029234D"

    ],

    "packageID": 1234567,

    "serviceArea": 4

}
{

    "quantity": 1,

    "packageID": 1234567,

    "serviceArea": 4

}

Campo

Tipo

Descripción

Order ID

Integer  
HTTP/1.1 200 OK

{

    "orderID": 287225,

    "batches": [

        { "batchID": 31458 },

        { "batchID": 31460 },

        { "batchID": 31462 }

    ]

}

Error

Nombre

Tipo

Descripción

code

Integer

Código de error

 

error

String

Descripción del error

HTTP/1.1 401 Unauthorized

{

    "code": 401,

    "error": "Unauthorized"

}



HTTP/1.1 401 Unauthorized

{

    "code": 401,

    "error": "Session Expired"

}
HTTP/1.1 402 Payment Required

{

    "code": 402,

    "error": "Order blocked; trial limit realized.  Limit: %d seats."

}


HTTP/1.1 402 Payment Required

{

    "code": 402,

    "error": "Order too large; trial limit exceeded.  Available: %d seats."

}
HTTP/1.1 406 Not Acceptable

{

    "code": 406,

    "error": "Not Acceptable"

}
HTTP/1.1 422 Unprocessable Entity

{

    "code": 422,

    "error": "The '%s' parameter is required."

}


HTTP/1.1 422 Unprocessable Entity

{

    "code": 422,

    "error": "The '%s' parameter must be scalar."

}


HTTP/1.1 422 Unprocessable Entity

{

    "code": 422,

    "error": "The '%s' parameter must be formatted as a(n) integer."

}


HTTP/1.1 422 Unprocessable Entity

{

    "code": 422,

    "error": "The '%s' parameter must be formatted as a(n) string."

}


HTTP/1.1 422 Unprocessable Entity

{

    "code": 422,

    "error": "The '%' parameter is required for each Number object."

}


HTTP/1.1 422 Unprocessable Entity

{

    "code": 422,

    "error": "The 'countryCode' parameter must match one of the following values: 1"

}


HTTP/1.1 422 Unprocessable Entity

{

    "code": 422,

    "error": "The 'serviceArea' parameter must match one of the following values: 1, 2, 3, 4, 5"

}