Manual programisty: send_sms_api.php

1. Endpoint

2. Autoryzacja

Klucz API należy wysłać w polu api_key w treści JSON.

Uwaga: klucz musi znajdować się na liście API_KEYS['send_sms_api.php'] po stronie serwera.

{
  "api_key": "TWÓJ_KLUCZ_API",
    "to": "+48XXXYYYZZZ",
  "message": "Treść SMS",
  "creator": "CRM"
}

3. Parametry wejściowe

4. Przykład request (cURL)

curl -X POST "https://api.softspm.pl/send_sms_api.php" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key":"TWÓJ_KLUCZ_API",
        "to":"+48XXXYYYZZZ",
    "message":"Przypomnienie o wydarzeniu jutro o 10:00",
    "creator":"HydroNexis"
  }'

5. Przykład request (JavaScript / fetch)

const response = await fetch("https://api.softspm.pl/send_sms_api.php", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    api_key: "TWÓJ_KLUCZ_API",
        to: "+48XXXYYYZZZ",
    message: "Test API SMS",
    creator: "Panel"
  })
});

const data = await response.json();
console.log(response.status, data);

6. Odpowiedzi API

6.1 Sukces (HTTP 200)

{
  "status": "success",
  "message": "SMS dodany do kolejki."
}

6.2 Błędy

7. Dobre praktyki po stronie klienta

• Wysyłaj requesty wyłącznie przez HTTPS.
• Maskuj api_key w logach aplikacyjnych.
• Waliduj numer telefonu przed wysłaniem żądania.
• Przy błędach HTTP 400 nie ponawiaj automatycznie bez korekty danych.
• Przy błędach HTTP 500 wdroż retry z limitem i backoff.

8. Checklista testów integracyjnych

• Poprawny request zwraca HTTP 200 i status success.
• Brak pola to lub message zwraca HTTP 400.
• Niepoprawny numer to zwraca HTTP 400.
• Za długi message zwraca HTTP 400.
• Niepoprawny api_key zwraca HTTP 401.
• Żądanie metodą GET zwraca HTTP 405.