Obtener contacto

URL de la API

URL a la que se envían las solicitudes HTTP:

https://portal.bulkgate.com/api/1.0/address-book/get

Nota

Si la solicitud no llega a su destino, repítala en el servidor de respaldo backup1.bulkgate.com.

Métodos HTTP admitidos

POST - application/json

POST /api/1.0/address-book/get HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json

Tabla de parámetros

NOMBRE DEL PARÁMETRO	VALOR	OBLIGATORIO	VALOR PREDETERMINADO
application_id	ID de aplicación	Sí	-
application_token	Token de aplicación	Sí	-
phone_number	Número de teléfono que se busca.	Sí	-
category	Agenda de contactos con la que se trabaja. De forma predeterminada, la agenda principal de la cuenta.	No	`main`

Ejemplo de solicitud

POST /api/1.0/address-book/get HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "phone_number": "123456789" }

Respuesta

En caso de éxito:

{ "data": { "phone_mobile": "123456789", "phone": "", "phone_number_iso": null, "email": "", "url": "", "first_name": "Morgan", "last_name": "Yu", "title_before": "", "title_after": "", "gender": "", "type": "", "street1": "", "street2": "", "city": "", "zip": "", "state": "", "country": "", "company_name": "", "company_number": "", "company_vat": "", "custom_field_0": "", "custom_field_1": "", "custom_field_2": "", "custom_field_3": "", "custom_field_4": "", "custom_field_5": "", "custom_field_6": "", "custom_field_7": "", "custom_field_8": "", "custom_field_9": "" } }

En caso de error:

{ "type": "number_not_found", "code": 400, "error": "Number not found", "detail": null }

{ "type": "invalid_phone_number", "code": 400, "error": "Invalid phone number", "detail": null }

Donde:

type y error (descripción del error) se encuentran en la tabla de tipos de error
code representa el código de error HTTP
detail es información adicional sobre el error

¿Le ha resultado útil esta página?

Preguntar a la IA Copiado