Языковые URL статей

Языковые URL позволяют привязать к статье ссылки на источники для разных языков. Когда AI ссылается на статью в разговоре, виджет чата показывает URL, соответствующий определённому языку разговора (most_frequent_language). Это удобно при многоязычном использовании, когда одно содержимое имеет разные URL для разных языков (например, example.com/en/returns и example.com/es/devoluciones).

Получение языкового URL

Права: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}/lang_urls/{language}

Shell

curl https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Ответ 200 OK

{
  "url": "https://example.com/en/return-policy"
}

Создание языкового URL

Права: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}/lang_urls/{language}

Тело запроса

Параметр	Описание
url строка, обязательный	URL версии на нужном языке

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com/en/return-policy"}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"url": "https://example.com/en/return-policy"},
)
data = response.json()

Ответ 200 OK

{
  "url": "https://example.com/en/return-policy"
}

Обновление языкового URL

Права: write_all

PATCH https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}/lang_urls/{language}

Тело запроса

Параметр	Описание
url строка	Обновлённый URL

Ответ 200 OK: возвращает обновлённый объект URL.

Удаление языкового URL

Права: write_all

DELETE https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}/lang_urls/{language}

Shell

curl -X DELETE https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.delete(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)

Ответ 200 OK

---