Pour commencer
Demandez le Hukamnama du jour. Aucune inscription : tout site ou toute application peut l’appeler, depuis un serveur ou directement depuis un navigateur.
curl https://api.gurbanisoul.com/v1/hukamnama/today « Aujourd’hui » désigne la date à Amritsar (UTC+05:30), d’où que vienne la requête. Le Hukamnama paraît en général après 5 h 30 environ, heure d’Amritsar. D’ici là, la réponse indique "status": "pending" et donne dans latest la dernière date publiée.
Points d’accès
https://api.gurbanisoul.com
GET /v1/hukamnama/today- Le Hukamnama de la date en cours à Amritsar, ou une réponse en attente avant sa publication.
GET /v1/hukamnama/YYYY-MM-DD- Un jour, par sa date à Amritsar. Les archives commencent le
2026-11-01. GET /v1/hukamnama?limit=7- Les derniers jours publiés, du plus récent au plus ancien : de 1 à 30, 7 si
limitest omis. Ajoutezinclude=linespour recevoir chaque ligne de chaque jour. GET /v1/hukamnama/index- Tous les jours publiés, du plus récent au plus ancien, avec la date, l’Ang et l’empreinte, sans le texte. Pour des archives ou un plan de site.
GET /v1/status- Si le Hukamnama du jour est déjà publié, et la dernière date publiée.
La réponse
Un jour publié contient le shabad entier, ligne par ligne. Voici l’enregistrement du 2026-11-11 ; le texte y est remplacé par « … » et seules les deux premières de ses 7 lignes sont montrées.
{
"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- Le jour auquel appartient ce Hukamnama, à Amritsar. Affichez cette date, pas celle de votre visiteur.
statuspublishedoupending. Une réponse en attente n’a aucune ligne.ang,ang_end- L’Ang où commence le shabad et l’Ang où il se termine.
citation- La référence à afficher avec le texte.
lines- Chaque ligne, dans l’ordre.
gurmukhiest la ligne, à la lettre.translitest une translittération établie par règles.is_headingsignale un titre etis_rahaola ligne du Rahao. author,raag- L’auteur et le raag. Quand les lignes d’un jour ont plusieurs auteurs, comme dans un vaar, le champ
authordu jour vautnullet chaque ligne porte le sien. range_sha256,scripture_sha256range_sha256prouve les lignes, comme indiqué plus bas.scripture_sha256identifie l’édition du texte dont elles sont tirées.published_at- Le moment où le jour a été publié ici, en UTC.
lines[].en,translation- Une traduction anglaise du Dr Sant Singh Khalsa, lorsqu’elle est incluse. C’est une couche distincte et signalée : ne la présentez jamais comme le Gurbani.
Vérifier le texte vous-même
Joignez le gurmukhi de chaque ligne par un saut de ligne, calculez le SHA-256 des octets UTF-8 et comparez-le à range_sha256. S’ils diffèrent, n’affichez rien : mieux vaut tard que faux.
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");
} Avant qu’un jour soit publié ici, ses lignes sont lues dans le même texte que la Base de connaissances et prouvées par cette empreinte. La page du SGPC ne sert qu’à repérer le shabad ; aucun caractère n’en est repris.
Si une ligne vous semble fautive, écrivez-nous.
Afficher le Hukamnama
- Affichez le gurmukhi tel qu’il arrive. Ne le corrigez pas, ne l’abrégez pas, ne changez ni ses espaces ni son ordre.
- Affichez le shabad entier. Si la place manque, renvoyez vers la page du jour (
url) plutôt que de le couper. - Nommez-le « Hukamnama · Sri Harmandir Sahib », donnez sa date à Amritsar et affichez la référence.
- Ne dites « du jour » que tant que sa date est encore la date à Amritsar.
- Tenez la translittération et toute traduction à l’écart du gurmukhi, chacune sous son propre intitulé.
- Ne le dites pas officiel. Le SGPC publie le Hukamnama ; cette API repère le shabad par Ang et sert son texte à partir de Sri Guru Granth Sahib Ji.
Mention de la source
Partout où vous affichez le Hukamnama, mentionnez la source avec un lien vers la page du jour :
<a href="https://gurbanisoul.com/en/hukamnama/2026-11-11">Hukamnama · Sri Harmandir Sahib, via Gurbani Soul</a> Chaque enregistrement porte ces mots et ce lien dans attribution. Gurbani Soul n’est pas affilié au SGPC.
L’intégrer sans code
Pour le site d’un gurdwara ou un blog : collez ceci là où le Hukamnama doit apparaître. Aucun script n’est exécuté et aucun cookie n’est déposé.
<iframe src="https://gurbanisoul.com/embed/hukamnama?lang=fr&theme=auto"
title="Hukamnama · Sri Harmandir Sahib" loading="lazy"
style="width:100%;max-width:640px;height:520px;border:0"></iframe> lang peut valoir en, pa, fr, et theme auto, light, dark.
Flux
Les mêmes jours sous forme de flux, pour les lecteurs de flux et les automatisations :
https://gurbanisoul.com/feeds/hukamnama.xmlhttps://gurbanisoul.com/feeds/hukamnama.json
Fiabilité et limites
- L’API est tenue avec soin, mais sans garantie. Un jour qui ne peut pas être prouvé est retenu : en retard plutôt que faux.
- Les réponses sont mises en cache, celle du jour environ une minute et celles des jours passés un jour. Envoyez
If-None-Matchavec l’ETagque vous détenez : une réponse inchangée ne coûte rien. - Une requête par minute suffit à tout le monde. Un trop grand nombre de requêtes reçoit
429et un en-têteRetry-After. - Les erreurs sont en JSON, avec
error,codeetrequest_id. - La version 1 ne fait que s’enrichir. Des champs peuvent s’ajouter ; aucun n’est renommé ni retiré sans un préavis de douze mois.
Conditions
- L’utilisation de l’API est gratuite. Ni clé, ni compte, ni frais.
- Mentionnez la source du Hukamnama comme indiqué plus haut, avec le lien.
- Ne modifiez pas le gurmukhi, et ne le présentez pas comme officiel ni comme provenant du SGPC.
- L’API est fournie en l’état, sans garantie. Un usage qui nuit au service peut être limité ou bloqué.
Une question, ou un projet pour un gurdwara ? Écrivez à support@gurbanisoul.com.