Reserve un número gratuito

Números gratuitos

Los números de teléfono gratuitos son números de teléfono dentro de los EE.UU. que no tienen costo para la persona que llama.  

 

Nota: Estos números de teléfono por lo general cobran a la persona o empresa a la que se llama.

Reserve un número gratuito

Busque e identifique sus números gratuitos únicos y reténgalos con Reservación de Número Gratuito.  Al igual que un carrito de compras, poder reservar le permitirá pensar en ellos antes de que alguien más los compre.

 

Puntos de conexión y métodos
POST  /_rest/v4/carrier/tf/reservations

 

Parámetros

Encabezados

Aceptar: application/json

Autorización: xxxxxxxxxxxxxxxxx

Tipo de contenido: application/json

Encabezados

Campo

Tipo

Descripción

Accept

 

String

application/json

Authorization

String

Token de autorización (vea Autenticar)

 

Tipo de contenido

String

application/json

 

Parámetro

Campo

Tipo

Descripción

endpoints

E.164[]

Los puntos de conexión a reservarse.

 

reservationID opcional

String

Un Identificador Único Universal (UUID) para asociar con los puntos de conexión reservados. (vea Identificador único universal)

 
{

    "endpoints": [

        "+18887293863",

        "+18887293864"

    ]

}
{

    "endpoints": [

        "+18885551201",

        "+18885551202"

    ],

    "reservationID": "F78793B1-7E84-11E6-B908-52540029234D"

}

Success 200

Campo

Tipo

Descripción

endpoints

 

 

Array

Una lista que contenga los parámetros reservados.

endpoint

Numeric

La representación e.164 del punto de conexión.

 

geo

 

 

Object

Información geográfica sobre el punto de conexión.

city

Null

La ciudad del punto de conexión.

 

country

 

String

El país del punto de conexión.

stateProvince

Null

El estado/provincia del punto de conexión.

 

expirationDate

DateTime

La fecha ISO 8601 en que vencerá la reservación.

 

reservationID

 

 

 

 

 

String

El Identificador Único Universal (UUID) asociado a los puntos de conexión. (vea Identificador único universal)

reservedDate

DateTime

La fecha ISO 8601 en que la reservación fue hecha.

HTTP/1.1 200 OK

[

    {

        "endpoints": [

            {

                "endpoint": "+18887293863",

                "geo": {

                    "city": null,

                    "country": "US",

                    "stateProvince": null

                }

            },

            {

                "endpoint": "+18887293864",

                "geo": {

                    "city": null,

                    "country": "US",

                    "stateProvince": null

                }

            }

        ],

        "expirationDate": "2015-08-16T23:17:01Z",

        "reservationID": "F78793B1-7E84-11E6-B908-52540029234D",

        "reservedDate": "2015-08-16T22:47:01Z"

    }

]

        "expirationDate": "2015-08-16T23:17:01Z",

        "reservationID": "F78793B1-7E84-11E6-B908-52540029234D",

        "reservedDate": "2015-08-16T22:47:01Z"

    }

]

Error 

Nombre

Tipo Descripción
code
Integer

Código de error

 

error
String

Descripción del error

HTTP/1.1 400 Bad Request

{

    "code": 400,

    "error": "Number(s) not available."

}

HTTP/1.1 401 Unauthorized

{

    "code": 401,

    "error": "Unauthorized"

}

HTTP/1.1 401 Unauthorized

{

    "code": 401,

    "error": "Session Expired"

}
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 formatted as a(n) array."

}


HTTP/1.1 422 Unprocessable Entity

{

    "code": 422,

    "error": "The 'endpoints' parameter must be a number(s) in E.164 format."