sms/{api_id}

Authorization: MAC id="su ID de usuario", ts="1455281539", nonce="caracteres_aleatorios", mac="hash-codificado-base64"

¿Cómo calcular la firma(hash) mac?

La firma se genera como resultado de aplicar el algoritmo SHA-256 a una serie de datos concatenados relacionados con la solicitud que son:

      Timestamp
      Nonce
      HTTP request method
      HTTP request URI
      HTTP host
      HTTP port
      Optional extra data
    

Cada línea de la cadena debe estar separada por el caracter de avance de línea (\n o 0x0A; No es válido usar \r o \r\n). La cadena también deberá finalizar con el caracter avance de línea. A continuación se muestra un ejemplo de una solicitud POST.

      1455281539\n
      ec120228fa6fd17e2545703b4cd3eba2\n
      POST\n
      /sms/demouser\n
      restapi.marketext.com\n
      80\n
      \n
    

Tenga en cuenta que el campo Optional extra data se encuentra en blanco. Nuestra API no usa ese campo, pero debe incluirse en la firma tal como lo indica la especificación OAuth 2. Una vez que se tiene la cadena de datos se debe calcular la firma usando el método HMAC utilizando el md5 de la contraseña del usuario como llave.

Nuestra API utiliza el algoritmo SHA-256 para calcular la firma. Se recomienda que utilice librerías nativas ya que el cálculo debe ser exacto.

Asegúrese que el resultado del hash sea en binario y no en hexadecimal. Finalmente codifique el hash calculado utilizando base 64.

Ejemplo en PHP para realizar el cálculo de la firma

      // Obtener la marca de hora (timestamp)
      $timestamp = time();

      // Obtener la cadena aleatoria
      $nonce = md5(function_exists("openssl_random_pseudo_bytes") ? openssl_random_pseudo_bytes(10) :
                  (function_exists("random_bytes") ? random_bytes(10) : mt_rand()) );

      // Definir el método de la solicitud
      $method = "POST";

      // Especificar la URI
      $URI = "/sms/democompany";

      // Especificar el host
      $host = "restapi.marketext.com";

      // Especificar el puerto
      $port = 80;

      // Definir una variable en blanco para los parámetros extra
      $extra = "";

      // Preoparar la cadena base
      $mac = $timestamp . "\n" .
          $nonce . "\n" .
          $method . "\n" .
          $URI . "\n" .
          $host . "\n" .
          $port . "\n" .
          $extra . "\n";

      // Calcular la firma usando el algoritmo SHA-256 y el md5 de la contraseña del usuario como llave
      $hmac = hash_hmac ( "sha256", $mac, md5("clave123456"), TRUE);
      // el parámetro final puesto a TRUE garantiza que el resultado sea devuelto en binario

      // Codificar la firma en base64
      $base64Data = base64_encode( $hmac );

      // Finalmente armar la cadena que se enviará en los encabezados
      $headers = array("Authorization: MAC id=\"demouser\",ts=\"{$timestamp}\", nonce=\"{$nonce}\", mac=\"{$base64Data}\"");
      Importante: el encabezado debe enviarse siempre con comillas dobles, no se puede usar comilla simple.
    

Resultado

    Tomando como ejemplo la siguiente cadena:
    

    1455281539\n
    ec120228fa6fd17e2545703b4cd3eba2\n
    POST\n
    /sms/democompany\n
    restapi.marketext.com\n
    80\n
    \n
    
    y utilizando la contraseña: clave123456 para generar el hash SHA-256 obtenermos la siguiente firma después de codificar en base64:
      
gGYlFChF2R2k0ecCS2HluJpjRuonl8LsdBhO9Ne96j8=
    La cadena de encabezado quedaría así:
      
Authorization: MAC id="demouser", ts="1455281539", nonce="ec120228fa6fd17e2545703b4cd3eba2", mac="gGYlFChF2R2k0ecCS2HluJpjRuonl8LsdBhO9Ne96j8="
    

Respuesta esperada	Parámetro a enviar
JSON	application/json
XML	application/xml
CSV	text/csv
Form URL Encoded	application/x-www-form-url-encoded

 
  
JSON
    {
      "Number" => "573001234567",
      "MsgID" => "a2f5adbf76124fdcfc31f5acd6e9463f"
    }

  
XML
    <?xml version="1.0"?>
    <respuesta><Number>573001234567</Number><MsgID>a2f5adbf76124fdcfc31f5acd6e9463f</MsgID></respuesta>

  
CSV
    573001234567,a2f5adbf76124fdcfc31f5acd6e9463f

  
URLEncoded
    Number=573001234567&MsgID=a2f5adbf76124fdcfc31f5acd6e9463f