للمؤسسات

الرائد الرسمي داخل أنظمتكم

واجهة برمجة للبحث في كامل الرائد الرسمي، واسترجاع النصّ الكامل لكلّ عدد بالفرنسية والعربية، وتلقّي إشعار فور صدور عدد جديد يذكر اسمًا أو معرّفًا جبائيًا أو كلمة مفتاحية.

ما تحصلون عليه

بحث في النصّ الكامل

أكثر من 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).
  • المفاتيح سرّية: استعملوا الواجهة من خوادمكم لا من المتصفّح.

اطلب النفاذ

السعر حسب الطلب، وفق حجم الاستعمال وعدد الإشعارات. أخبرونا بما تريدون إنجازه وسنجيبكم في أجل يومي عمل مع مفتاح تجريبي.

أو راسلونا على contact@jort.tn. تُستعمل بياناتكم للردّ عليكم فقط.