Manual programisty: send_email_api.php

1. Endpoint

2. Autoryzacja

Klucz API należy przekazać w nagłówku Authorization jako Bearer token:

Authorization: Bearer TWÓJ_KLUCZ_API

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

Brak nagłówka lub błędny token zwraca HTTP 401.

3. Parametry wejściowe (JSON body)

Przykładowe body

{
  "to": "jan.kowalski@example.com",
    "title": "Przypomnienie",
    "body": "Wydarzenie odbędzie się jutro o 10:00."
}

4. Przykład request (cURL)

curl -X POST "https://api.softspm.pl/send_email_api.php" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TWÓJ_KLUCZ_API" \
  -d '{
    "to":"jan.kowalski@example.com",
        "tytul":"Test API mail",
        "tresc":"To jest test wiadomości e-mail"
  }'

5. Przykład request (JavaScript / fetch)

const response = await fetch("https://api.softspm.pl/send_email_api.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer TWÓJ_KLUCZ_API"
  },
  body: JSON.stringify({
    to: "jan.kowalski@example.com",
        title: "Powiadomienie",
        content: "Treść wiadomości"
  })
});

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

6. Odpowiedzi API

6.1 Sukces (HTTP 200)

{
  "success": "Message has been sent"
}

6.2 Błędy

7. Uwagi implementacyjne

• Endpoint ustawia nagłówki CORS: Access-Control-Allow-Origin: *, Allow-Methods: POST, OPTIONS, Allow-Headers: Content-Type, Authorization.
• Wiadomość jest wysyłana jako HTML oraz alternatywnie jako plain text (AltBody).
• Tytuł i treść są sanityzowane przed osadzeniem w szablonie HTML.
• Szczegóły błędów SMTP są logowane po stronie serwera (nie są zwracane klientowi).

8. Checklista testów integracyjnych

• Poprawny request z Bearer tokenem zwraca HTTP 200.
• Brak Authorization zwraca HTTP 401.
• Błędny token zwraca HTTP 401.
• Brak pola to, tytułu (subject/title/tytul) lub treści (message/body/content/tresc) zwraca HTTP 400.
• Niepoprawny e-mail odbiorcy zwraca HTTP 400.
• Za długie subject/message zwracają HTTP 400.
• Żądanie metodą GET zwraca HTTP 405.
• Żądanie OPTIONS zwraca HTTP 204.