PililMail API - Полная документация

API для отправки писем пользователям системы PililMail

🔐 Авторизация

Все запросы защищены через API-токен.

Передаётся в заголовке Authorization: Bearer YOUR_TOKEN
from_email определяется автоматически по токену

📤 POST /api/send

Отправляет письмо пользователю PililMail.

Параметры:

Параметр	Тип	Обязательный	Описание
to_email	string	✅	Получатель
teme	string	✅	Тема письма
text	string	✅	Текст письма

Пример запроса (cURL):

curl -X POST https://pililmail.rf.gd/api \
  -H "Authorization: Bearer 123321TOKEN" \
  -d "to_email=pilil@pilil" \
  -d "teme=Привет" \
  -d "text=Тестовое письмо"

Ответ:

{
  "status": "success",
  "message_id": "123",
  "sent_at": "2025-07-04 12:00:00",
  "from_email": "noreply@site.com"
}

💡 Пример на PHP

<?php
$token = "123321TOKEN";
$data = http_build_query([
  "to_email" => "pilil@pilil",
  "teme" => "Привет",
  "text" => "Добро пожаловать!"
]);

$options = [
  "http" => [
    "method" => "POST",
    "header" => "Authorization: Bearer $token\r\n" .
                 "Content-type: application/x-www-form-urlencoded",
    "content" => $data
  ]
];

$context = stream_context_create($options);
$response = file_get_contents("https://pililmail.rf.gd/api", false, $context);
echo $response;
?>

🖱 Форма с кнопкой

<form method="POST">
  <button type="submit">Отправить письмо</button>
</form>

Внутри PHP-файла на сервере по POST будет происходить отправка письма.

⚠️ Ошибки

Код	Сообщение	Причина
401	Missing token	Нет заголовка авторизации
403	Invalid token	Неверный или несуществующий токен
400	Missing fields	Не переданы нужные параметры
500	Database error	Ошибка базы данных

🔗 Привязка токенов

Токен заранее связан с email отправителя. Пример:

abc123TOKEN → noreply@site.com
xyz987TOKEN → alerts@company.kz

📡 Интеграция на сайт

Создай токен в панели PililMail
Привяжи токен к email
На своём сайте отправляй через https://pililmail.rf.gd/api
Сохраняй ID письма для логов

🧩 PHP + JavaScript (AJAX)

Вы можете отправлять письма без перезагрузки страницы с помощью JavaScript + PHP. Пример ниже:

1. HTML + JS (send.html)

<!DOCTYPE html>
<html lang="ru">
<head>
  <meta charset="UTF-8">
  <title>AJAX PililMail Отправка</title>
</head>
<body>

<button onclick="sendEmail()">📨 Отправить письмо</button>

<div id="result"></div>

<script>
function sendEmail() {
  fetch("send_handler.php", {
    method: "POST"
  })
  .then(res => res.json())
  .then(data => {
    document.getElementById("result").innerText =
      data.status === "success"
        ? "✅ Письмо отправлено! ID: " + data.message_id
        : "❌ Ошибка: " + data.message;
  });
}
</script>

</body>
</html>

2. PHP обработчик (send_handler.php)

<?php
$token = "123321TOKEN";

$data = http_build_query([
  "to_email" => "pilil@pilil",
  "teme" => "AJAX письмо",
  "text" => "Это сообщение отправлено через JS+PHP"
]);

$options = [
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer $token\r\n" .
                 "Content-type: application/x-www-form-urlencoded",
    "content" => $data
  ]
];

$context = stream_context_create($options);
$response = file_get_contents("https://pililmail.rf.gd/api", false, $context);
header("Content-Type: application/json");
echo $response;
?>

🌐 Как запустить:

Создай два файла: send.html и send_handler.php
Запусти PHP-сервер: php -S localhost:8000
Открой http://localhost:8000/send.html
Нажми кнопку — письмо отправится через JS

📬 PililMail API