문서 언어별 URL

언어별 URL은 문서에 언어별 소스 링크를 연결합니다. AI가 대화 중 문서를 참조하면 채팅 Widget은 감지된 대화 언어(most_frequent_language)에 맞는 URL을 표시합니다. example.com/en/returns와 example.com/es/devoluciones처럼 같은 콘텐츠가 언어마다 다른 URL을 갖는 다국어 배포에 유용합니다.

언어별 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

---