ਸ਼ੁਰੂਆਤ
ਅੱਜ ਦਾ ਹੁਕਮਨਾਮਾ ਮੰਗੋ। ਕਿਤੇ ਰਜਿਸਟਰ ਹੋਣ ਦੀ ਲੋੜ ਨਹੀਂ; ਕੋਈ ਵੀ ਵੈੱਬਸਾਈਟ ਜਾਂ ਐਪ ਇਸ ਨੂੰ ਸਰਵਰ ਤੋਂ ਜਾਂ ਸਿੱਧਾ ਬ੍ਰਾਊਜ਼ਰ ਤੋਂ ਵਰਤ ਸਕਦੀ ਹੈ।
curl https://api.gurbanisoul.com/v1/hukamnama/today “ਅੱਜ” ਤੋਂ ਭਾਵ ਅੰਮ੍ਰਿਤਸਰ ਦੀ ਤਾਰੀਖ਼ (UTC+05:30) ਹੈ, ਬੇਨਤੀ ਭਾਵੇਂ ਕਿਤੋਂ ਵੀ ਆਵੇ। ਹੁਕਮਨਾਮਾ ਆਮ ਤੌਰ ’ਤੇ ਉੱਥੋਂ ਦੇ ਸਮੇਂ ਅਨੁਸਾਰ ਸਵੇਰੇ ਲਗਭਗ 05:30 ਤੋਂ ਬਾਅਦ ਆਉਂਦਾ ਹੈ। ਉਦੋਂ ਤਕ ਉੱਤਰ ਵਿਚ "status": "pending" ਹੁੰਦਾ ਹੈ ਅਤੇ latest ਵਿਚ ਸਭ ਤੋਂ ਤਾਜ਼ਾ ਪ੍ਰਕਾਸ਼ਿਤ ਤਾਰੀਖ਼ ਦੱਸੀ ਜਾਂਦੀ ਹੈ।
ਐਂਡਪੁਆਇੰਟ
https://api.gurbanisoul.com
GET /v1/hukamnama/today- ਅੰਮ੍ਰਿਤਸਰ ਦੀ ਮੌਜੂਦਾ ਤਾਰੀਖ਼ ਦਾ ਹੁਕਮਨਾਮਾ, ਜਾਂ ਪ੍ਰਕਾਸ਼ਿਤ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਉਡੀਕ ਵਾਲਾ (pending) ਉੱਤਰ।
GET /v1/hukamnama/YYYY-MM-DD- ਇਕ ਦਿਨ, ਉਸ ਦੀ ਅੰਮ੍ਰਿਤਸਰ ਦੀ ਤਾਰੀਖ਼ ਅਨੁਸਾਰ। ਪੁਰਾਲੇਖ
2026-11-01ਤੋਂ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ। GET /v1/hukamnama?limit=7- ਸਭ ਤੋਂ ਤਾਜ਼ਾ ਪ੍ਰਕਾਸ਼ਿਤ ਦਿਨ, ਨਵੇਂ ਤੋਂ ਪੁਰਾਣੇ ਵੱਲ: 1 ਤੋਂ 30 ਤਕ;
limitਨਾ ਦਿੱਤਾ ਜਾਵੇ ਤਾਂ 7। ਹਰ ਦਿਨ ਦੀ ਹਰ ਪੰਕਤੀ ਲੈਣ ਲਈinclude=linesਜੋੜੋ। GET /v1/hukamnama/index- ਹਰ ਪ੍ਰਕਾਸ਼ਿਤ ਦਿਨ, ਨਵੇਂ ਤੋਂ ਪੁਰਾਣੇ ਵੱਲ: ਤਾਰੀਖ਼, ਅੰਗ ਅਤੇ ਹੈਸ਼, ਪਾਠ ਤੋਂ ਬਿਨਾਂ। ਪੁਰਾਲੇਖ ਜਾਂ ਸਾਈਟਮੈਪ ਲਈ।
GET /v1/status- ਅੱਜ ਦਾ ਹੁਕਮਨਾਮਾ ਪ੍ਰਕਾਸ਼ਿਤ ਹੋਇਆ ਹੈ ਜਾਂ ਨਹੀਂ, ਅਤੇ ਸਭ ਤੋਂ ਤਾਜ਼ਾ ਪ੍ਰਕਾਸ਼ਿਤ ਤਾਰੀਖ਼।
ਉੱਤਰ
ਪ੍ਰਕਾਸ਼ਿਤ ਦਿਨ ਵਿਚ ਪੂਰਾ ਸ਼ਬਦ ਹੁੰਦਾ ਹੈ, ਪੰਕਤੀ-ਦਰ-ਪੰਕਤੀ। ਇਹ 2026-11-11 ਦਾ ਰਿਕਾਰਡ ਹੈ; ਇੱਥੇ ਪਾਠ ਦੀ ਥਾਂ “…” ਰੱਖਿਆ ਗਿਆ ਹੈ ਅਤੇ ਇਸ ਦੀਆਂ 7 ਪੰਕਤੀਆਂ ਵਿੱਚੋਂ ਸਿਰਫ਼ ਪਹਿਲੀਆਂ ਦੋ ਦਿਖਾਈਆਂ ਗਈਆਂ ਹਨ।
{
"amritsar_date": "2026-11-11",
"status": "published",
"ang": 680,
"first_line_id": 29497,
"last_line_id": 29503,
"comp_id": 2699,
"opening_line_id": 29498,
"opening_gurmukhi": "…",
"opening_translit": "…",
"line_count": 7,
"range_sha256": "61975a8dea4d5174e173a5c6d1f3b761653f19ba7029b4386d03a475ed7689f4",
"scripture_sha256": "0eff4bae60cfcf1c63ae4ac14c2ecf255a9457edc0bebaf627aa28dedb89c84f",
"citation": "Sri Guru Granth Sahib Ji · Ang 680",
"published_at": "2026-11-11T00:25:03+00:00",
"credit": "Located by Ang from the Hukamnama published by SGPC (hs.sgpc.net); text from Sri Guru Granth Sahib Ji.",
"ang_end": 680,
"raag": "ਧਨਾਸਰੀ",
"author": "Guru Arjan Dev Ji (M5)",
"url": "https://gurbanisoul.com/en/hukamnama/2026-11-11",
"attribution": {
"text": "Hukamnama · Sri Harmandir Sahib, via Gurbani Soul",
"url": "https://gurbanisoul.com/en/hukamnama/2026-11-11"
},
"terms_url": "https://gurbanisoul.com/en/developers#terms",
"lines": [
{
"id": 29497,
"ang": 680,
"gurmukhi": "…",
"translit": "…",
"is_heading": true,
"is_rahao": false,
"author": "Guru Arjan Dev Ji (M5)"
},
{
"id": 29498,
"ang": 680,
"gurmukhi": "…",
"translit": "…",
"is_heading": false,
"is_rahao": false,
"author": "Guru Arjan Dev Ji (M5)"
}
]
} amritsar_date- ਉਹ ਦਿਨ ਜਿਸ ਦਾ ਇਹ ਹੁਕਮਨਾਮਾ ਹੈ, ਅੰਮ੍ਰਿਤਸਰ ਅਨੁਸਾਰ। ਇਹੀ ਤਾਰੀਖ਼ ਦਿਖਾਓ, ਆਪਣੇ ਪਾਠਕ ਦੀ ਨਹੀਂ।
statuspublishedਜਾਂpending। ਉਡੀਕ ਵਾਲੇ ਉੱਤਰ ਵਿਚ ਕੋਈ ਪੰਕਤੀ ਨਹੀਂ ਹੁੰਦੀ।ang,ang_end- ਜਿਸ ਅੰਗ ਤੋਂ ਸ਼ਬਦ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ ਅਤੇ ਜਿਸ ਅੰਗ ’ਤੇ ਮੁੱਕਦਾ ਹੈ।
citation- ਪਾਠ ਦੇ ਨਾਲ ਦਿਖਾਉਣ ਵਾਲਾ ਹਵਾਲਾ।
lines- ਹਰ ਪੰਕਤੀ, ਤਰਤੀਬ ਅਨੁਸਾਰ।
gurmukhiਪੰਕਤੀ ਹੈ, ਅੱਖਰ-ਅੱਖਰ।translitਨਿਯਮਾਂ ਅਨੁਸਾਰ ਬਣਿਆ ਲਿਪੀਅੰਤਰ ਹੈ।is_headingਸਿਰਲੇਖ ਦੱਸਦਾ ਹੈ ਅਤੇis_rahaoਰਹਾਉ ਵਾਲੀ ਪੰਕਤੀ। author,raag- ਬਾਣੀਕਾਰ ਅਤੇ ਰਾਗ। ਜਦੋਂ ਕਿਸੇ ਦਿਨ ਦੀਆਂ ਪੰਕਤੀਆਂ ਇਕ ਤੋਂ ਵੱਧ ਬਾਣੀਕਾਰਾਂ ਦੀਆਂ ਹੋਣ, ਜਿਵੇਂ ਵਾਰ ਵਿਚ, ਤਾਂ ਦਿਨ ਦਾ
authornullਹੁੰਦਾ ਹੈ ਅਤੇ ਹਰ ਪੰਕਤੀ ਆਪਣਾ ਬਾਣੀਕਾਰ ਦੱਸਦੀ ਹੈ। range_sha256,scripture_sha256range_sha256ਪੰਕਤੀਆਂ ਦੀ ਤਸਦੀਕ ਕਰਦਾ ਹੈ, ਜਿਵੇਂ ਹੇਠਾਂ ਦੱਸਿਆ ਹੈ।scripture_sha256ਪਾਠ ਦੀ ਉਹ ਛਾਪ ਦੱਸਦਾ ਹੈ ਜਿਸ ਵਿੱਚੋਂ ਇਹ ਪੜ੍ਹੀਆਂ ਗਈਆਂ।published_at- ਇੱਥੇ ਇਹ ਦਿਨ ਕਦੋਂ ਪ੍ਰਕਾਸ਼ਿਤ ਹੋਇਆ, UTC ਵਿਚ।
lines[].en,translation- ਡਾ. ਸੰਤ ਸਿੰਘ ਖ਼ਾਲਸਾ ਦਾ ਅੰਗਰੇਜ਼ੀ ਅਨੁਵਾਦ, ਜਿੱਥੇ ਇਹ ਸ਼ਾਮਲ ਹੋਵੇ। ਇਹ ਵੱਖਰੀ, ਨਾਂ ਵਾਲੀ ਪਰਤ ਹੈ: ਇਸ ਨੂੰ ਕਦੇ ਗੁਰਬਾਣੀ ਵਜੋਂ ਪੇਸ਼ ਨਾ ਕਰੋ।
ਪਾਠ ਆਪ ਪਰਖੋ
ਹਰ ਪੰਕਤੀ ਦਾ gurmukhi ਨਵੀਂ ਲਾਈਨ (newline) ਨਾਲ ਜੋੜੋ, UTF-8 ਬਾਈਟਾਂ ਦਾ SHA-256 ਕੱਢੋ, ਅਤੇ range_sha256 ਨਾਲ ਮਿਲਾਓ। ਜੇ ਦੋਵੇਂ ਨਾ ਮਿਲਣ ਤਾਂ ਕੁਝ ਨਾ ਦਿਖਾਓ: ਗ਼ਲਤ ਨਾਲੋਂ ਦੇਰ ਚੰਗੀ।
const res = await fetch("https://api.gurbanisoul.com/v1/hukamnama/today");
const day = await res.json();
if (day.status === "published") {
const text = day.lines.map((line) => line.gurmukhi).join("\n");
const bytes = new TextEncoder().encode(text);
const digest = await crypto.subtle.digest("SHA-256", bytes);
const hex = [...new Uint8Array(digest)]
.map((b) => b.toString(16).padStart(2, "0"))
.join("");
if (hex !== day.range_sha256) throw new Error("lines do not match range_sha256");
} ਇੱਥੇ ਕੋਈ ਦਿਨ ਪ੍ਰਕਾਸ਼ਿਤ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਉਸ ਦੀਆਂ ਪੰਕਤੀਆਂ ਗਿਆਨ ਕੋਸ਼ ਵਾਲੇ ਪਾਠ ਵਿੱਚੋਂ ਹੀ ਪੜ੍ਹੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਅਤੇ ਇਸ ਹੈਸ਼ ਨਾਲ ਪਰਖੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। SGPC ਦਾ ਪੰਨਾ ਸਿਰਫ਼ ਸ਼ਬਦ ਲੱਭਣ ਲਈ ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ; ਉੱਥੋਂ ਕੋਈ ਅੱਖਰ ਨਹੀਂ ਲਿਆ ਜਾਂਦਾ।
ਜੇ ਕਦੇ ਕੋਈ ਪੰਕਤੀ ਗ਼ਲਤ ਜਾਪੇ ਤਾਂ ਸਾਨੂੰ ਦੱਸੋ।
ਹੁਕਮਨਾਮਾ ਦਿਖਾਉਣ ਬਾਰੇ
- ਗੁਰਮੁਖੀ ਉਵੇਂ ਹੀ ਦਿਖਾਓ ਜਿਵੇਂ ਮਿਲਦੀ ਹੈ। ਇਸ ਨੂੰ ਨਾ ਸੋਧੋ, ਨਾ ਛੋਟਾ ਕਰੋ, ਨਾ ਇਸ ਦੀਆਂ ਵਿੱਥਾਂ ਜਾਂ ਤਰਤੀਬ ਬਦਲੋ।
- ਪੂਰਾ ਸ਼ਬਦ ਦਿਖਾਓ। ਜਿੱਥੇ ਥਾਂ ਨਾ ਹੋਵੇ, ਉੱਥੇ ਇਸ ਨੂੰ ਕੱਟਣ ਦੀ ਥਾਂ ਉਸ ਦਿਨ ਦੇ ਪੰਨੇ (
url) ਦਾ ਲਿੰਕ ਦਿਓ। - ਇਸ ਦਾ ਨਾਂ “ਹੁਕਮਨਾਮਾ · ਸ੍ਰੀ ਹਰਿਮੰਦਰ ਸਾਹਿਬ” ਲਿਖੋ, ਅੰਮ੍ਰਿਤਸਰ ਦੀ ਤਾਰੀਖ਼ ਦਿਓ ਅਤੇ ਹਵਾਲਾ ਦਿਖਾਓ।
- ਇਸ ਨੂੰ “ਅੱਜ ਦਾ” ਸਿਰਫ਼ ਉਦੋਂ ਤਕ ਕਹੋ ਜਦੋਂ ਤਕ ਇਸ ਦੀ ਤਾਰੀਖ਼ ਅੰਮ੍ਰਿਤਸਰ ਦੀ ਤਾਰੀਖ਼ ਹੈ।
- ਲਿਪੀਅੰਤਰ ਅਤੇ ਕੋਈ ਵੀ ਅਨੁਵਾਦ ਗੁਰਮੁਖੀ ਤੋਂ ਵੱਖ ਰੱਖੋ, ਹਰ ਇਕ ਆਪਣੇ ਨਾਂ ਹੇਠ।
- ਇਸ ਨੂੰ ਅਧਿਕਾਰਤ ਨਾ ਕਹੋ। ਹੁਕਮਨਾਮਾ SGPC ਪ੍ਰਕਾਸ਼ਿਤ ਕਰਦੀ ਹੈ; ਇਹ API ਅੰਗ ਅਨੁਸਾਰ ਸ਼ਬਦ ਲੱਭਦਾ ਹੈ ਅਤੇ ਉਸ ਦਾ ਪਾਠ ਸ੍ਰੀ ਗੁਰੂ ਗ੍ਰੰਥ ਸਾਹਿਬ ਜੀ ਵਿੱਚੋਂ ਦਿੰਦਾ ਹੈ।
ਸ੍ਰੋਤ ਦਾ ਜ਼ਿਕਰ
ਜਿੱਥੇ ਵੀ ਹੁਕਮਨਾਮਾ ਦਿਖਾਓ, ਉਸ ਦਿਨ ਦੇ ਪੰਨੇ ਦੇ ਲਿੰਕ ਨਾਲ ਸ੍ਰੋਤ ਦਾ ਜ਼ਿਕਰ ਕਰੋ:
<a href="https://gurbanisoul.com/en/hukamnama/2026-11-11">Hukamnama · Sri Harmandir Sahib, via Gurbani Soul</a> ਹਰ ਰਿਕਾਰਡ ਦੇ attribution ਵਿਚ ਇਹੀ ਲਿਖਤ ਅਤੇ ਲਿੰਕ ਹੁੰਦੇ ਹਨ। ਗੁਰਬਾਣੀ ਸੋਲ ਦਾ SGPC ਨਾਲ ਕੋਈ ਸੰਬੰਧ ਨਹੀਂ ਹੈ।
ਬਿਨਾਂ ਕੋਡ ਦੇ ਆਪਣੀ ਸਾਈਟ ’ਤੇ ਲਾਓ
ਗੁਰਦੁਆਰੇ ਦੀ ਵੈੱਬਸਾਈਟ ਜਾਂ ਬਲੌਗ ਲਈ: ਜਿੱਥੇ ਹੁਕਮਨਾਮਾ ਦਿਖਾਉਣਾ ਹੋਵੇ, ਉੱਥੇ ਇਹ ਪੇਸਟ ਕਰੋ। ਇਹ ਕੋਈ ਸਕ੍ਰਿਪਟ ਨਹੀਂ ਚਲਾਉਂਦਾ ਅਤੇ ਕੋਈ ਕੁਕੀ ਨਹੀਂ ਰੱਖਦਾ।
<iframe src="https://gurbanisoul.com/embed/hukamnama?lang=pa&theme=auto"
title="Hukamnama · Sri Harmandir Sahib" loading="lazy"
style="width:100%;max-width:640px;height:520px;border:0"></iframe> lang en, pa, fr ਹੋ ਸਕਦਾ ਹੈ, ਅਤੇ theme auto, light, dark।
ਫੀਡ
ਇਹੀ ਦਿਨ ਫੀਡ ਦੇ ਰੂਪ ਵਿਚ, ਫੀਡ ਰੀਡਰਾਂ ਅਤੇ ਆਟੋਮੇਸ਼ਨ ਲਈ:
https://gurbanisoul.com/feeds/hukamnama.xmlhttps://gurbanisoul.com/feeds/hukamnama.json
ਭਰੋਸੇਯੋਗਤਾ ਅਤੇ ਹੱਦਾਂ
- API ਧਿਆਨ ਨਾਲ ਚਲਾਇਆ ਜਾਂਦਾ ਹੈ, ਪਰ ਕੋਈ ਗਾਰੰਟੀ ਨਹੀਂ ਹੈ। ਜਿਸ ਦਿਨ ਦੀ ਤਸਦੀਕ ਨਾ ਹੋ ਸਕੇ ਉਹ ਰੋਕ ਲਿਆ ਜਾਂਦਾ ਹੈ: ਗ਼ਲਤ ਨਾਲੋਂ ਦੇਰ ਚੰਗੀ।
- ਉੱਤਰ ਕੈਸ਼ ਹੁੰਦੇ ਹਨ: ਅੱਜ ਦਾ ਲਗਭਗ ਇਕ ਮਿੰਟ ਲਈ ਅਤੇ ਪਿਛਲੇ ਦਿਨਾਂ ਦੇ ਇਕ ਦਿਨ ਲਈ। ਆਪਣੇ ਕੋਲ ਪਏ
ETagਨਾਲIf-None-Matchਭੇਜੋ ਤਾਂ ਨਾ ਬਦਲਿਆ ਉੱਤਰ ਦੁਬਾਰਾ ਡਾਊਨਲੋਡ ਨਹੀਂ ਹੁੰਦਾ। - ਮਿੰਟ ਵਿਚ ਇਕ ਵਾਰ ਤੋਂ ਵੱਧ ਪੁੱਛਣ ਦੀ ਕਿਸੇ ਨੂੰ ਲੋੜ ਨਹੀਂ। ਬਹੁਤ ਜ਼ਿਆਦਾ ਬੇਨਤੀਆਂ ਦਾ ਉੱਤਰ
429ਅਤੇRetry-Afterਹੈਡਰ ਨਾਲ ਮਿਲਦਾ ਹੈ। - ਗ਼ਲਤੀਆਂ JSON ਵਿਚ ਆਉਂਦੀਆਂ ਹਨ:
error,codeਅਤੇrequest_id। - ਵਰਜਨ 1 ਵਿਚ ਸਿਰਫ਼ ਵਾਧਾ ਹੁੰਦਾ ਹੈ। ਨਵੇਂ ਖੇਤਰ ਜੁੜ ਸਕਦੇ ਹਨ; ਬਾਰਾਂ ਮਹੀਨਿਆਂ ਦੇ ਨੋਟਿਸ ਤੋਂ ਬਿਨਾਂ ਕੋਈ ਖੇਤਰ ਨਾ ਬਦਲਿਆ ਜਾਂਦਾ ਹੈ ਨਾ ਹਟਾਇਆ।
ਸ਼ਰਤਾਂ
- API ਦੀ ਵਰਤੋਂ ਮੁਫ਼ਤ ਹੈ। ਨਾ ਕੋਈ ਕੁੰਜੀ, ਨਾ ਖਾਤਾ, ਨਾ ਕੋਈ ਫ਼ੀਸ।
- ਹੁਕਮਨਾਮੇ ਦੇ ਸ੍ਰੋਤ ਦਾ ਜ਼ਿਕਰ ਉੱਪਰ ਦੱਸੇ ਅਨੁਸਾਰ, ਲਿੰਕ ਸਮੇਤ ਕਰੋ।
- ਗੁਰਮੁਖੀ ਨੂੰ ਨਾ ਬਦਲੋ, ਅਤੇ ਇਸ ਨੂੰ ਅਧਿਕਾਰਤ ਜਾਂ SGPC ਵੱਲੋਂ ਆਇਆ ਨਾ ਦੱਸੋ।
- API ਜਿਵੇਂ ਹੈ ਉਵੇਂ ਹੀ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ, ਬਿਨਾਂ ਕਿਸੇ ਵਾਰੰਟੀ ਦੇ। ਸੇਵਾ ਨੂੰ ਨੁਕਸਾਨ ਪਹੁੰਚਾਉਣ ਵਾਲੀ ਵਰਤੋਂ ਸੀਮਿਤ ਜਾਂ ਬੰਦ ਕੀਤੀ ਜਾ ਸਕਦੀ ਹੈ।
ਕੋਈ ਸਵਾਲ ਹੈ, ਜਾਂ ਕਿਸੇ ਗੁਰਦੁਆਰੇ ਲਈ ਕੁਝ ਬਣਾ ਰਹੇ ਹੋ? support@gurbanisoul.com ’ਤੇ ਲਿਖੋ।