🗿 API Тестер - Fomin Stones

📋 Получение подробной информации о камне

Введите название камня для получения полной информации: свойства, месторождения, история, интересные факты

🔍 Поиск камней по описанию

Опишите камень или укажите его характеристики для поиска подходящих вариантов

📸 Распознавание камня по фотографии

Загрузите фото камня для получения подробной информации через анализ изображения

📸 Выберите или перетащите изображение камня


💬 Чат с AI-экспертом по камням

Задайте любой вопрос о камнях, минералах, геологии. Эксперт учтет историю разговора

История разговора пуста

📖 API Документация

Полное описание всех эндпоинтов REST API для работы с камнями через OpenAI ChatGPT

🚀 Общая информация

Base URL: https://stone-api.stepamobile.com

Content-Type: application/json

Модель OpenAI: gpt-4o

Максимальный размер запроса: 10MB

🗿 Получение информации о камне

POST /api/stone/info

Получение подробной информации о камне по его названию включая физические свойства, химический состав, месторождения и интересные факты.

Параметры запроса:

{
  "stone_name": "Рубин"
}

Пример ответа:

{
  "id": "chatcmpl-...",
  "choices": [{
    "message": {
      "content": "{
        \"nameStone\": \"Рубин\",
        \"typeStone\": [\"Минерал\", \"Драгоценный камень\"],
        \"crystalSystem\": \"Тригональная\",
        \"mohsHardness\": \"9\",
        \"density\": \"3.97-4.05 г/см³\",
        \"description\": \"Рубин — драгоценный камень...\",
        \"occurrences\": [...],
        \"interestingFacts\": [...]
      }"
    }
  }]
}

🔍 Поиск камней

POST /api/stone/search

Поиск камней по описанию, цвету, свойствам или другим характеристикам.

Параметры запроса:

{
  "search_query": "красный драгоценный камень"
}

Пример ответа:

{
  "choices": [{
    "message": {
      "content": "{
        \"stones\": [
          {\"nameStone\": \"рубин\", \"typeStone\": [\"корунд\"]},
          {\"nameStone\": \"гранат\", \"typeStone\": [\"неосиликаты\"]}
        ]
      }"
    }
  }]
}

📸 Распознавание по изображению

POST /api/stone/image-recognition

Анализ изображения камня с помощью компьютерного зрения OpenAI для определения типа, свойств и характеристик.

Параметры запроса:

{
  "base64_image": "iVBORw0KGgoAAAANSUhEUgAA..."
}

Примечание: Изображение должно быть в формате base64 без префикса data:image/

Поддерживаемые форматы: JPG, PNG, GIF, BMP, WebP

💬 Чат с экспертом

POST /api/chat

Интерактивное общение с AI-экспертом по камням, минералам и геологии с учетом истории разговора.

Параметры запроса:

{
  "message": "Расскажи про изумруды",
  "conversation_history": [
    {"role": "user", "content": "Привет"},
    {"role": "assistant", "content": "Здравствуйте!"}
  ]
}

Примечание: Параметр conversation_history опционален

⚠️ Обработка ошибок

400 Bad Request: Неверные параметры запроса

500 Internal Server Error: Внутренняя ошибка сервера или OpenAI API

Формат ошибки:

{
  "error": "Описание ошибки",
  "details": "Подробная информация"
}

💻 Примеры cURL

Информация о камне:

curl -X POST https://stone-api.stepamobile.com/api/stone/info \
  -H "Content-Type: application/json" \
  -d '{"stone_name": "Рубин"}'

Поиск камней:

curl -X POST https://stone-api.stepamobile.com/api/stone/search \
  -H "Content-Type: application/json" \
  -d '{"search_query": "красный драгоценный камень"}'

Чат с экспертом:

curl -X POST https://stone-api.stepamobile.com/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Что такое изумруд?"}'