Referencia General de la API

Endpoint

https://api.unimtx.com

Visite Regiones y Endpoint para ver más sobre los puntos de acceso globales.

Parámetros Comunes

Los parámetros comunes son los parámetros que deben pasarse al llamar a la solicitud de la API y se transfieren uniformemente utilizando parámetros de consulta de URL.

NombreTipoRequeridoDescripciónEjemplo
actionstringIdentificación de la interfazsms.message.send
accessKeyIdstringID de AccessKey de solicitudMvMa9eLy3BBpZqTj49vuAB

Autenticación

Unimatrix ofrece los siguientes dos métodos de autenticación para que los desarrolladores elijan, que se pueden configurar en la Consola - Credenciales, siendo el modo Simple el predeterminado.

  • Modo Simple [Predeterminado]: Este modo solo verifica el ID de AccessKey y no verifica los parámetros de la solicitud, facilitando la integración rápida de los desarrolladores.
  • Modo HMAC: Este modo requiere el uso de AccessKey Secret para verificar los parámetros de la solicitud para mejorar la seguridad y autenticidad de la solicitud.

Modo Simple

Para utilizar la autenticación en modo simple, simplemente pase el valor de AccessKey ID de la Consola - Credenciales al parámetro de consulta de URL accessKeyId para completar la autenticación.

Modo HMAC

Para utilizar la autenticación de acceso en modo HMAC, todos los parámetros de consulta de URL deben organizarse en orden alfabético como la cadena de texto a firmar y firmarse según el algoritmo de hash de firma especificado.

Añada los parámetros comunes requeridos a la consulta de la siguiente manera:

NombreTipoRequeridoDescripciónEjemplo
algorithmstringAlgoritmo de hash de firma, actualmente solo se admite hmac-sha256hmac-sha256
timestampnumberMarca de tiempo (ms), tiempo de tolerancia de aceptación 10 minutos1620243278785
noncestringCadena aleatoria, acepta una cadena aleatoria entre 8-64 caracterese1098a414d09d2f6
signaturestringCadena de firmaZlbgmnCqB7Cgb3WI57Q4zrqq50xiQfi/LPbeL2kC

Generar firma

  1. Extraiga todos los pares de parámetros de consulta de URL en la solicitud, ordénelos en orden alfabético (ASC) según la clave del parámetro, conecte los valores clave con = y los pares de parámetros con & para formar la cadena de texto a firmar, por ejemplo, como sigue.

    accessKeyId=MvMa9eLy3BBpZqTj49vuAB&action=sms.message.send&algorithm=hmac-sha256&nonce=e1098a414d09d2f6&timestamp=1620269782258
    
  2. Usando el algoritmo HmacSHA256, el AccessKey Secret correspondiente al AccessKey ID se usa como la clave secreta de firma para generar una firma para la cadena de texto a firmar, y la salida es una cadena en Base64 (o Hex), como en el siguiente ejemplo:

    ZlbgmnCqB7Cgb3WI57Q4zrqq50xiQfi/LPbeL2kC
    
  3. Añadiendo la cadena de firma como el valor de signature al parámetro de consulta de URL de la solicitud envía la solicitud, resultando en el siguiente ejemplo de URL de solicitud completa:

    https://api.unimtx.com/?action=sms.message.send&accessKeyId=MvMa9eLy3BBpZqTj49vuAB&algorithm=hmac-sha256&timestamp=1620269782258&nonce=e1098a414d09d2f6&signature=xvv9UjzOrQFWe7fFS5IUU9iqIZrncvF093SqXsnfcK8%3D