API 2FA EN PHP

Notre api d'authentification à deux facteurs (2FA verify) est scindée en deux étapes. La première réservé à générer et à envoyer le code de vérification, la deuxième étape est pour vérifier le code généré. Ces étapes sont appelées respectivement par les urls "https://macsmspro.com/api/verification_v2", "https://macsmspro.com/api/verificationCheck_v2"

C'est une séquence de code à exécuter l'une après l'autre.

API n°1

<?php

//Intégration de l'api pour générer le code 

$url = "https://macsmspro.com/api/verification_v2";

$fields = array(
    
    "name" => "AUTH", // name 
    "phone" => "4474213xxxx", // recipient phone
    "token" => "$2yxxxxxxxxxxx", // API token
    "codeLength"  => "6", // code lenght
    "time" => "60", // time

);



  $curl_options = array(
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query( $fields ),
    CURLOPT_HTTP_VERSION => 1.0,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HEADER => false
  );

  $curl = curl_init();
  curl_setopt_array( $curl, $curl_options );
  $result = curl_exec( $curl );

  curl_close( $curl );



$response = json_decode($result);

echo "<pre>";
var_dump($response);
echo "</pre>";

?>

Réponse:

{"success" :
  { 
   "code" : "200",
   "status" : "pending",
   "token" : "VAxxxxxxxxx",
    "expire_in" : "60"
   }
}

Les erreurs repertoriées

TOKEN_IS_REQUIRED

Le champ token est requis. Code erreur 422

NAME_IS_REQUIRED

Nom requis. Code erreur 422

PHONE_NUMBER_IS_REQUIRED

Le numero de téléphone destinataire requis. Code erreur 422

TOKEN_INVALID

Token invalide ou incorrect. Code erreur 401

INVALID_ACCOUNT

Compte invalide. Code erreur 403

SUSPENDED_ACCOUNT

Compte suspendu. Code erreur 403

INSUFFICIENT_CREDIT

Votre crédit est insuffisant pour faire cet opération. Code erreur 400

VERIFICATION_FAILED

Vérification échouée. Code erreur 400

SMS_NOT_SENT

SMS de vérification non envoyé, la raison peut être une erreur réseau ou le numero destinataire est invalide. Code erreur 422

METHOD_NOT_ALLOWED

Accès non autorisé. Code erreur 405

API n°2

<?php

$url = "https://macsmspro.com/api/verificationCheck_v2";

$fields = array(
    
    "code" => "652457", //  code à vérifier
    "phone" => "xxxxxxxx", // le numéro à vérifier
    "token" => "$2yxxxxxxxxxxxxxx", // Token API
    "verification_token"    => "VAxxxxxxxxxxxxxxxx" // token de vérification de l'étape n°1

);

  $curl_options = array(
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query( $fields ),
    CURLOPT_HTTP_VERSION => 1.0,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HEADER => false
  );

  $curl = curl_init();
  curl_setopt_array( $curl, $curl_options );
  $result = curl_exec( $curl );

  curl_close( $curl );



$response = json_decode($result);

echo "<pre>";
var_dump($response);
echo "</pre>";

?>

Réponse

{"success" :
   { 
    "code" : "200",
     "status" : "approved" 
   }
 }

Quelques erreurs

TOKEN_IS_REQUIRED

Le token est requis. Code erreur : 422

TOKEN_INVALID

Votre token est incorrect. Code erreur 401

INVALID_ACCOUNT

Compte invalide. Code erreur 403

SUSPENDED_ACCOUNT

Compte suspendu. Code erreur 403

THE_CODE_IS_REQUIRED

Le code de vérification généré par le système est requis. Code erreur 422

RECIPIENT_PHONE_NUMBER_REQUIRED

Le numero destinataire est requis. Code erreur 422

VERIFICATION_TOKEN_REQUIRED

Le token de vérification générée à la première étape requis. Code erreur 422

VERIFICATION_FAILED

Vérification échouée. Code erreur 400

RECIPIENT_PHONE_INVALID

Le numero de téléphone destinataire est invalide. Code erreur 422

VERIFICATION_CODE_EXPIRED

Le temps de vérification du code est écroulé. Code erreur 404

METHOD_NOT_ALLOWED

Accès non autorisé. Code erreur 405