Tools API v1

Зачем нужен этот API

Tools API v1 отдаёт JSON по инструментам и страницам salamyx.com, чтобы скрипты и ассистенты вели на нужные URL без парсинга HTML.

• Получать единый каталог инструментов и краткие описания.
• Забирать поля страницы: summary, приватность, ограничения, FAQ.
• Строить интеграции в n8n, MCP-обёртках и внутренних скриптах.

Базовый URL API

Используйте production-хост и вызывайте endpoints под /api/v1.

https://salamyx.com/api/v1

Быстрый старт

Откройте URL в браузере или вызовите из скрипта — сразу получите JSON.

• https://salamyx.com/api/v1/health
• https://salamyx.com/api/v1/tools
• https://salamyx.com/api/v1/tools?id=sha256
• https://salamyx.com/api/v1/pages/sha256

Доступные endpoints

Формат ответа

Все endpoints возвращают JSON с полем status. Ошибки возвращают failed, сообщение и корректный HTTP-код.

{
  "status": "ok",
  "count": 2,
  "tools": [
    {
      "id": "sha256",
      "route": "/crypto/sha256/",
      "category": "crypto",
      "runtime": "browser",
      "riskLevel": "low"
    }
  ]
}

Как использовать на практике

• Используйте /api/v1/tools как основной каталог для automation и MCP.
• Используйте /api/v1/tools?id={toolId}, когда нужен один конкретный инструмент.
• Используйте /api/v1/pages/{pageId}, когда нужны полные metadata: FAQ, ограничения и privacy notes.
• Инструменты в браузере считаем клиентскими; серверные execute endpoints добавляем только когда это реально нужно.

Примеры запросов

curl "https://salamyx.com/api/v1/tools?category=crypto"
curl "https://salamyx.com/api/v1/tools?id=sha256"
curl "https://salamyx.com/api/v1/pages/sha256"

Пример workflow в n8n

• Добавьте ноду HTTP Request.
• Поставьте метод GET и URL https://salamyx.com/api/v1/tools?category=crypto.
• Добавьте IF-ноду для фильтрации по riskLevel или status.
• Отправьте результат в Telegram, Slack, email или другую систему.

FAQ