Démarrage rapide

1. Créez un compte sur app.getsms.ma, avec votre e-mail ou Google.

2. Ouvrez Clés API et copiez votre clé de test sk_test_…. Elle simule les envois sans rien payer (voir Sandbox).

3. Envoyez votre premier message :

   cURL

   curl -X POST https://api.getsms.ma/v1/messages/send \
     -H "x-api-key: sk_test_VOTRE_CLE" \
     -H "Content-Type: application/json" \
     -d '{"to": "+212612345678", "content": "Bonjour depuis GetSMS"}'

   Node.js

   const res = await fetch("https://api.getsms.ma/v1/messages/send", {
     method: "POST",
     headers: {
       "x-api-key": process.env.GETSMS_API_KEY,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({ to: "+212612345678", content: "Bonjour depuis GetSMS" }),
   });
   const { data } = await res.json();
   console.log(data.id, data.status); // "pending"

   Python

   import os, requests
   
   res = requests.post(
       "https://api.getsms.ma/v1/messages/send",
       headers={"x-api-key": os.environ["GETSMS_API_KEY"]},
       json={"to": "+212612345678", "content": "Bonjour depuis GetSMS"},
   )
   print(res.json()["data"]["status"])  # "pending"

   PHP

   <?php
   $ch = curl_init("https://api.getsms.ma/v1/messages/send");
   curl_setopt_array($ch, [
       CURLOPT_POST => true,
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_HTTPHEADER => [
           "x-api-key: " . getenv("GETSMS_API_KEY"),
           "Content-Type: application/json",
       ],
       CURLOPT_POSTFIELDS => json_encode([
           "to" => "+212612345678",
           "content" => "Bonjour depuis GetSMS",
       ]),
   ]);
   $response = json_decode(curl_exec($ch), true);

4. La réponse arrive tout de suite avec le statut pending : le message est en file. Suivez la suite avec les webhooks ou en consultant le message.