Developers

WOORI API

Программный интерфейс WOORI для интеграций: чат-ассистент, карта сайта и сервисные эндпоинты. Все запросы — по HTTPS, ответы — JSON или потоковые SSE.

Базовый URL

https://<your-domain>

Аутентификация для публичных эндпоинтов не требуется. Соблюдайте разумные лимиты — не более 60 запросов в минуту с одного клиента.

Эндпоинты

POST/api/chat

Чат-ассистент WOORI

Стриминговый эндпоинт ассистента магазина. Принимает историю сообщений в формате AI SDK UIMessage[] и возвращает поток ответа (Server-Sent Events) с подбором товаров, советами по уходу и информацией о доставке/оплате.

Тело запроса

{
  "messages": [
    {
      "id": "1",
      "role": "user",
      "parts": [
        { "type": "text", "text": "Подбери крем для сухой кожи" }
      ]
    }
  ]
}

Ответ

// Content-Type: text/event-stream
// AI SDK UI Message Stream — последовательность чанков с частями ответа.
data: {"type":"text-delta","textDelta":"Рекомендую "}
data: {"type":"text-delta","textDelta":"Cutem Cerabomb Cream..."}
data: [DONE]

Пример cURL

curl -N -X POST https://<your-domain>/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "id": "1", "role": "user", "parts": [{ "type": "text", "text": "Что подойдёт для чувствительной кожи?" }] }
    ]
  }'

GET/sitemap.xml

Карта сайта

XML-карта сайта со всеми публичными страницами WOORI. Используйте для поисковых систем и сторонних краулеров.

Ответ

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url><loc>https://your-domain/</loc></url>
  <url><loc>https://your-domain/shop</loc></url>
</urlset>

Пример cURL

curl https://<your-domain>/sitemap.xml

Коды ответов

200 — успех, данные в теле ответа или потоке.
400 — некорректное тело запроса (например, отсутствует поле messages).
429 — превышен лимит запросов, повторите позже.
500 — внутренняя ошибка сервера или AI-шлюза.

Поддержка

Нужен расширенный доступ, вебхуки или партнёрский API? Напишите нам — выдадим ключи и документацию под ваш сценарий.