Taalgebonden artikel-URL's

Met taalgebonden URL’s koppel je bronlinks voor specifieke talen aan artikelen. Wanneer de AI tijdens een gesprek naar een artikel verwijst, toont de chatwidget de URL die past bij de gedetecteerde gesprekstaal (most_frequent_language). Dit is handig bij meertalige implementaties waarbij dezelfde inhoud per taal een andere URL heeft (bijvoorbeeld example.com/en/returns tegenover example.com/es/devoluciones).

Taalgebonden URL ophalen

Bereik: 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()

Antwoord 200 OK

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

Taalgebonden URL aanmaken

Bereik: write_all

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

Requestbody

Parameter	Beschrijving
url string, verplicht	URL voor de versie in de betreffende taal

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()

Antwoord 200 OK

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

Taalgebonden URL bijwerken

Bereik: write_all

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

Requestbody

Parameter	Beschrijving
url string, verplicht	Bijgewerkte URL

Antwoord 200 OK: retourneert het bijgewerkte URL-object.

Taalgebonden URL verwijderen

Bereik: 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>"},
)

Antwoord 200 OK

---