Мовні 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 string, обов’язковий	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 string, обов’язковий	Оновлений 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

---