📱 Fake SMS Service

Простой in-memory SMS-сервис для локального тестирования

Base URL: http://fake-sms-service.cloud124.ru

API Endpoints

POST /sms Отправить SMS

Создает новое SMS сообщение для указанного номера телефона.

Request Body:
{
  "phone": "+79990001122",
  "text": "Текст сообщения"
}
Response (201):
{
  "ok": true,
  "phone": "+79990001122",
  "message": {
    "text": "Текст сообщения",
    "at": "2024-11-23T10:00:00.000Z"
  }
}
Example (curl):
curl -X POST "http://fake-sms-service.cloud124.ru/sms" \
  -H 'Content-Type: application/json' \
  -d '{"phone":"+79990001122","text":"Привет из curl"}'
GET /sms/:phone Получить все сообщения

Возвращает все сообщения для указанного номера телефона в виде массива текстов.

Response (200):
["Первое сообщение", "Второе сообщение", "Третье сообщение"]
Example (curl):
curl "http://fake-sms-service.cloud124.ru/sms/+79990001122"

💡 Примечание: В URL номер телефона должен быть закодирован (например, +%2B)

GET /sms/:phone/recent Получить сообщения (новые первые)

Возвращает все сообщения для указанного номера, отсортированные от новых к старым.

Query Parameters:
  • format=html - вернуть HTML страницу вместо JSON
Response (200, JSON):
["Третье сообщение", "Второе сообщение", "Первое сообщение"]
Example (curl):
# JSON формат
curl "http://fake-sms-service.cloud124.ru/sms/+79990001122/recent"

# HTML формат (откройте в браузере)
curl "http://fake-sms-service.cloud124.ru/sms/+79990001122/recent?format=html"
GET /sms/:phone/last Получить последнее сообщение

Возвращает текст последнего сообщения для указанного номера в виде plain text.

Response (200, text/plain):
Текст последнего сообщения
Response (404, если сообщений нет):
{"error": "no messages for this phone"}
Example (curl):
curl "http://fake-sms-service.cloud124.ru/sms/+79990001122/last"
GET /sms/healthcheck Health Check

Проверка работоспособности сервиса. Используется для Kubernetes health probes.

Response (200):
{"status": "ok", "service": "fake-sms-service"}

📝 Примеры использования

1. Отправить сообщение:
curl -X POST "http://fake-sms-service.cloud124.ru/sms" \
  -H 'Content-Type: application/json' \
  -d '{"phone":"+79990001122","text":"Тестовое сообщение"}'
2. Получить все сообщения:
curl "http://fake-sms-service.cloud124.ru/sms/+79990001122"
3. Получить последнее сообщение:
curl "http://fake-sms-service.cloud124.ru/sms/+79990001122/last"
4. Просмотр в браузере (HTML):
http://fake-sms-service.cloud124.ru/sms/+79990001122/recent?format=html