Obtener especificación de API de tokens

Implicación envía una solicitud POST HTTP al URI para el servidor de tokens que proporciona como parte de un proceso de envío tokenizado. Esta solicitud contiene una lista de valores, y su servidor de token responde con la lista de valores de token y los tokens asociados.

Si la solicitud se envía sin un token, el JSON de respuesta de la matriz de tokens no contendrá ningún dato. Si solo hay un único valor de token en la solicitud y su servidor de tokens no proporciona un token, la respuesta incluirá una matriz vacía para la propiedad de token de la respuesta JSON.

La API obtiene la representación de token de datos de número de teléfono. El token se almacena en la base de datos en lugar de en el número de teléfono de origen de un mensaje SMS entrante.

Requisitos previos

Active SSL en el extremo. Utilice la autenticación de credenciales de cliente básicas o de OAuth con la lista de admisión de direcciones IP del lado del servidor para autenticar llamadas de clientes.

Formato de cuerpo de solicitud JSON

Marketing Cloud Engagement envía una solicitud utilizando el tipo de contenido application/json con el cuerpo que contiene una matriz obligatoria de valores de token denominada tokenValues. Cada objeto tokenValue de la matriz contiene estas propiedades:

Solicitud de muestra de tokenValues JSON

{
  "tokenValues": [
    {
      "tokenRequestId": "abc123thn567",
      "tokenValue": "13172237777",
      "tokenType": "MobileNumber",
      "privateCode": "46356",
    },
    {
      "tokenRequestId": "abc098thn654",
      "tokenValue": "13175559911",
      "tokenType": "MobileNumber",
      "privateCode": "45356",
    }
  ]
}

Formato de cuerpo de respuesta JSON

La respuesta se devuelve en un bloque de tipo de contenido de aplicación/json con un código de estado HTTP.

Cuerpo y objeto de token

Consideraciones de MobileConnect

Los tokens mantienen una relación de uno a uno con los números de teléfono. Los tokens de número de teléfono utilizan el mismo valor de token incluso si aparece ese número de celular para varios contactos. Si tiene intención de utilizar los Envíos desencadenados (messageContact API), proporcione el país real delante del token móvil. El valor completo no debe superar los 15 caracteres.

Respuesta de ejemplo

{
  "tokens": [
    {
      "tokenRequestId": "abc123thn567",
      "token": "999911112222",
	"subscriberKey": "abc123456xyz”
    },
    {
      "tokenRequestId": "abc098thn654",
      "token": "999911112233",
	"subscriberKey": "123abcxyz456”
    }
  ]
}