Developer guide

URLs & languages

How the domain and language shape every URL, and SEO patterns.

text

https://cms.af/api/public/v1/{domain}/{lang}/{resource}

{domain} – your website's domain, lowercase, without https:// or www.
{lang} – en, fa or ps. If a field is empty in that language, the API returns the site's default language instead.

Multilingual SEO

Mirror the API language in your site URLs: example.com/en/services, /fa/services, /ps/services. On every page add alternates:

html

<html lang="fa" dir="rtl">
<link rel="alternate" hreflang="en" href="https://example.com/en/services" />
<link rel="alternate" hreflang="fa" href="https://example.com/fa/services" />
<link rel="alternate" hreflang="ps" href="https://example.com/ps/services" />
<link rel="alternate" hreflang="x-default" href="https://example.com/en/services" />

Use dir="rtl" for fa and ps. Use the seo object each endpoint returns for <title> and <meta name="description">.