ما تحصلون عليه
بحث في النصّ الكامل
أكثر من 650.000 صفحة بالفرنسية والعربية، مع تصفية حسب المجموعة واللغة والسنوات، وترتيب حسب التاريخ أو الصلة، ومقتطفات وإحصاءات حسب السنة.
النصّ الكامل
نصّ كلّ عدد، صفحة بصفحة (JSON) أو دفعة واحدة (Markdown)، لقواعدكم الوثائقية وأدوات الامتثال ونماذج الذكاء الاصطناعي.
إشعارات Webhook
طلب HTTPS موقَّع نحو خادمكم عند كلّ عدد جديد، أو فقط عندما يتضمّن طلبكم (مدين، معرّف جبائي، «تصفية»…).
مفاتيح وحصص ومتابعة
مفتاح لكلّ تطبيق، وحصّة يومية حسب حجم استعمالكم، والاستهلاك متاح في كلّ وقت (/v1/usage).
التغطية
| الرائد الرسمي، بالفرنسية | 1957 – 2026 | نصّ كلّ عدد |
| الإعلانات القانونية، بالفرنسية | 2004 – 2026 | الشركات، التصفيات، البيوعات |
| الرائد الرسمي والإعلانات، بالعربية | 2006 – 2026 | نصّ كلّ عدد |
| المحكمة العقارية، بالعربية | 2003 – 2026 | نصّ كلّ عدد |
تُقرأ الأعداد الجديدة يوم صدورها. وتبقى ملفات PDF الرسمية متاحة لكلّ عدد (pdf_url). النصّ العربي الصادر عن المطبعة الرسمية وحده هو المعتمد.
البداية
يحمل كلّ طلب مفتاحكم في ترويسة Authorization. الأجوبة بصيغة JSON (UTF-8).
curl -H "Authorization: Bearer $JORT_API_KEY" \
"https://api.jort.tn/v1/search?q=liquidation&collection=annonces-legales&sort=newest&limit=5" {
"query": "liquidation",
"total": 18342,
"results": [
{
"collection": "annonces-legales",
"language": "fr",
"year": 2026,
"issue": "137",
"page": 12,
"snippet": "... Dissolution anticipée et mise en <mark>liquidation</mark> ...",
"pdf_url": "https://lake.jort.tn/annonces-legales/fr/2026/137.pdf",
"text_url": "https://api.jort.tn/v1/issues/annonces-legales/fr/2026/137",
"jort_url": "https://jort.tn/find/?c=annonces-legales&l=fr&y=2026&i=137&page=12&q=liquidation"
}
],
"facets": { "collection": { ... }, "language": { ... }, "year": { ... } }
} curl -H "Authorization: Bearer $JORT_API_KEY" \
"https://api.jort.tn/v1/issues/journal-officiel/ar/2024/080" # JSON, page by page
curl -H "Authorization: Bearer $JORT_API_KEY" \
"https://api.jort.tn/v1/issues/journal-officiel/fr/1985/012?format=md" # raw text (Markdown) المرجع
العنوان الأساسي: https://api.jort.tn · المجموعات: journal-officiel, annonces-legales, tribunal-immobilier · اللغات: fr, ar
| GET | /v1/search | بحث في النصّ الكامل (فرنسية + عربية). q و collection و lang و year و year_from و year_to و match و sort و group و limit ≤ 100 و offset ≤ 2000. |
| GET | /v1/issues | الأعداد المتوفّرة نصًّا لسنة معيّنة: collection و lang و year. |
| GET | /v1/issues/{collection}/{lang}/{year}/{issue} | النصّ الكامل لعدد، صفحة بصفحة. format=json|md و page=N. |
| GET | /v1/usage | مفتاحك وحدودك وطلباتك خلال 30 يومًا. |
| GET | /v1/webhooks | الـ webhooks الخاصّة بك. |
| POST | /v1/webhooks | إنشاء: {url, query?, match?, collection?, lang?}. دون query: كلّ عدد جديد. |
| GET | /v1/webhooks/{id} | webhook واحد وآخر 20 إرسالًا. |
| POST | /v1/webhooks/{id}/test | إرسال حدث تجريبي. |
| DELETE | /v1/webhooks/{id} | حذف. |
Webhooks
دون طلب بحث، يُرسَل حدث issue.published عند كلّ عدد جديد. ومع طلب بحث، يُرسَل حدث search.match عند العثور عليه في العدد الجديد، مع الصفحات والمقتطفات. السرّ المُسلَّم عند الإنشاء يوقّع كلّ إرسال (HMAC-SHA256). يُعاد الإرسال الفاشل طيلة 24 ساعة.
curl -X POST -H "Authorization: Bearer $JORT_API_KEY" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/jort-hook","query":"0024667T","collection":"annonces-legales"}' \
https://api.jort.tn/v1/webhooks POST https://example.com/jort-hook
X-Jort-Event: search.match
X-Jort-Delivery: evt_5f0c2a9e1b7d4c3a
X-Jort-Signature: t=1795000000,v1=9b1c…
{
"id": "evt_5f0c2a9e1b7d4c3a",
"event": "search.match",
"query": "0024667T",
"issue": { "collection": "annonces-legales", "language": "fr", "year": 2026, "issue": "138",
"pages": 64, "pdf_url": "…", "text_url": "…", "jort_url": "…" },
"matches": [ { "page": 31, "snippet": "… <mark>0024667T</mark> …", "jort_url": "…" } ]
} // Node.js: check that a delivery really comes from jort.tn
import { createHmac, timingSafeEqual } from "node:crypto";
function verify(rawBody, header, secret) {
const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; // replay
const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
return timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
} الحدود والأخطاء
- حصّة يومية لكلّ مفتاح (تُصفَّر على الساعة 00:00 UTC)، مبيَّنة في الترويستين X-RateLimit-Limit و X-RateLimit-Remaining؛ و120 طلبًا في الدقيقة كحدّ أقصى.
- الأخطاء بصيغة
{"error": {"code", "message"}}: 400 معطى غير صالح، 401 مفتاح غائب أو ملغى، 404 عدد دون نصّ، 429 تجاوز الحصّة (انظر Retry-After). - المفاتيح سرّية: استعملوا الواجهة من خوادمكم لا من المتصفّح.
اطلب النفاذ
السعر حسب الطلب، وفق حجم الاستعمال وعدد الإشعارات. أخبرونا بما تريدون إنجازه وسنجيبكم في أجل يومي عمل مع مفتاح تجريبي.