API RhinoTendersBETA
Consommez le catalogue d'annonces de façon programmatique, dans les limites de votre propre plan d'abonnement.
Documentation pour agents IA (.txt)https://api.rhinotenders.com /api/v1/sandboxتستهدف المسارات وأمثلة الشيفرة الآن بيئة الاختبار: استخدم رمز اختبار (صالح لمدة 24 ساعة). عدد محدود من المناقصات الحقيقية، دون حصة. راجع بيئة الاختبار مقابل الإنتاج.
Introduction
L'API de données RhinoTenders permet à vos propres intégrations de récupérer le catalogue d'annonces auquel vous avez déjà accès via votre abonnement : vérification de statut, liste, filtres, organismes et détail d'une annonce.
C'est une API REST en lecture seule (tous les endpoints sont en GET). L'accès doit être activé par un administrateur RhinoTenders pour votre compte, puis vous générez vous-même votre token depuis votre espace API.
لا تملك بعد وصولاً إلى بيئة الإنتاج؟ يمكن لأي حساب مكتمل الملف الشخصي تجربة الواجهة البرمجية فوراً في بيئة الاختبار (Sandbox)، دون اشتراك — راجع بيئة الاختبار مقابل الإنتاج.
Authentification
Chaque requête doit inclure votre token en Bearer dans l'en-tête Authorization :
Authorization: Bearer <your_token>Votre token n'est affiché qu'une seule fois, à sa génération (ou régénération) depuis le dashboard — conservez-le en lieu sûr, il ne peut plus être récupéré ensuite.
بيئة الاختبار مقابل الإنتاج
تتيح لك بيئة الاختبار بناء تكاملك واختباره دون المساس ببيئة الإنتاج: جرّب نقاط النهاية، وصحّح شيفرتك، أو امنح مطوّراً أو مقدّم خدمة رمزاً مؤقتاً بدلاً من مشاركة رمز الإنتاج الخاص بك.
أنشئ رمز الاختبار بنفسك من فضاء الواجهة البرمجية: الخدمة متاحة لأي حساب مكتمل الملف الشخصي، دون اشتراك ودون موافقة مسؤول. الرمز صالح لمدة 24 ساعة، ولكل حساب رمز اختبار نشط واحد فقط: إنشاء رمز جديد يُبطل الرمز السابق فوراً.
تعرض البيئتان نفس نقاط النهاية والمعاملات وبنية الاستجابات تماماً: لا يتغير سوى عنوان URL الأساسي والرمز. الانتقال من بيئة إلى أخرى تغيير في الإعدادات وليس في الشيفرة.
| المعيار | الإنتاج | الاختبار (Sandbox) |
|---|---|---|
| عنوان URL الأساسي | https://api.rhinotenders.com | https://api.rhinotenders.com |
| الرمز (Token) | رمز طويل الأمد، صالح لمدة سنة واحدة (الاسم: api-client). | رمز مؤقت، صالح لمدة 24 ساعة (الاسم: api-sandbox). رمز نشط واحد لكل حساب. |
| طريقة الحصول عليه | يُنشأ من فضاء الواجهة البرمجية بعد أن يفعّل مسؤول RhinoTenders الوصول إلى الواجهة البرمجية لحسابك. يتطلب اشتراكاً نشطاً. | خدمة ذاتية من فضاء الواجهة البرمجية، لأي حساب مكتمل الملف الشخصي، بغض النظر عن الاشتراك. |
| البيانات | كامل الكتالوج الذي يتيحه اشتراكك. | عدد محدود من المناقصات الحقيقية، لاختبار تكاملك. |
| الحصة والاشتراك | حسب خطة الاشتراك: طلبات تفاصيل المناقصة تستهلك من الحصة. | لا شيء. تحتفظ الحقول subscription وquota بالبنية نفسها، بقيم null. |
| حد المعدل | 15 طلباً في الدقيقة، وفي اليوم 750 طلباً (الباقة المجانية) أو 2500 طلباً (الباقة المدفوعة). | 10 طلبات في الدقيقة و250 طلباً في اليوم (عدّادات منفصلة عن الإنتاج). |
| المرشحات المتقدمة | متاحة حسب خطتك (hasAdvancedFilters). | غير متاحة: تُقبل المعاملات organism_id, ending_date_start, ending_date_end لكنها تُتجاهل دون أي خطأ، وتكون قيمة hasAdvancedFilters دائماً false. |
| مؤشر البيئة | الترويسة X-Api-Environment: production. ويعيد GET /status الحقل data.environment = "production". | الترويسة X-Api-Environment: sandbox. ويعيد GET /status الحقل data.environment = "sandbox". |
| رمز خاطئ | رمز اختبار يُرسَل إلى هذا العنوان الأساسي يعيد الخطأ 401 wrong_environment. | رمز إنتاج يُرسَل إلى هذا العنوان الأساسي يعيد الخطأ 401 wrong_environment. |
الاستجابة — رمز الإنتاج مُرسَل إلى العنوان الأساسي لبيئة الاختبار (Sandbox) (401)
{
"success": false,
"message": "This is a production token. Use the production base URL (/api/v1/data).",
"code": "wrong_environment"
}Statut
/api/v1/sandbox/statusVérifie que votre token est valide et retourne en un seul appel l'environnement (data.environment : production ou sandbox) et l'état de votre accès API, de votre abonnement et de votre quota. Utile pour vérifier votre intégration. Appel libre, ne consomme aucun quota.
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/sandbox/status"Réponse
{
"success": true,
"data": {
"environment": "production",
"token": { "name": "api-client", "created_at": "2026-08-01T10:00:00Z", "expires_at": "2027-08-01T10:00:00Z" },
"api_access": { "active": true },
"subscription": { "plan": "Standard", "status": "active" },
"quota": {
"daily": { "limit": 100, "used": 7, "remaining": 93, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}
}Liste des annonces
/api/v1/sandbox/tendersRetourne les annonces correspondant aux filtres donnés. Mêmes paramètres que la recherche du site (recherche texte, activité, localisation, statut, type, organisme, dates). Les filtres avancés (organisme, date de fin) sont ignorés silencieusement si votre plan n'y donne pas accès, et toujours en sandbox — jamais d'erreur. Appel libre, ne consomme aucun quota, mais bloqué en production (403) si votre abonnement n'est pas actif ou si votre quota de consultation est déjà épuisé.
| tender_id | Un seul ID d'annonce — ignore tous les autres filtres. |
| tender_ids | Plusieurs ID séparés par des virgules — ignore tous les autres filtres. |
| search | Recherche texte (titre, code). |
| activity_id | ID(s) d'activité, séparés par des virgules. |
| location_id | ID(s) de localisation, séparés par des virgules. |
| status_id | ID(s) de statut, séparés par des virgules. |
| organism_id | ID(s) d'organisme — filtre avancé, ignoré si non autorisé par votre plan, toujours ignoré en sandbox. |
| tender_type | National, International, ou les deux séparés par une virgule. |
| publish_date_start / publish_date_end | Plage de date de publication (AAAA-MM-JJ). |
| ending_date_start / ending_date_end | Plage de date limite — filtre avancé, ignoré si non autorisé par votre plan, toujours ignoré en sandbox. |
| page / per_page | Pagination — per_page par défaut 20, plafond 100. |
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/sandbox/tenders?page=1&per_page=20&activity_id=12000000"Réponse
{
"success": true,
"data": [
{
"id": 1490301,
"title": "Etude et suivi realisation de 4 classes en extention",
"organism": { "id": 3358, "name": "APC - Commune d'El Milia Wilaya de Jijel" },
"location": { "id": 20, "name": "Jijel" },
"status": { "id": 4, "name": "Résultats" },
"publish_date": "2026-09-09",
"ending_date": "2026-09-20T08:00:00Z"
}
],
"meta": { "current_page": 1, "per_page": 20, "total": 187 }
}Données de filtre
/api/v1/sandbox/tenders/filtersبيانات مرجعية لبناء عوامل التصفية: الأنشطة والحالات والمواقع والأنواع. كائن واحد كامل (دون ترقيم صفحات)، مخزّن مؤقتاً لمدة ساعة إلى ساعتين على الخادم. يعكس hasAdvancedFilters خطة اشتراكك (دائماً false في بيئة الاختبار).
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/sandbox/tenders/filters"Réponse
{
"success": true,
"data": {
"locations": [{ "id": 20, "name": "Jijel", "type": "wilaya", "flag": null, "country_name": "Algérie" }],
"statuses": [{ "id": 4, "name": "Résultats" }],
"activities": [{ "id": 7233, "name": "[72110000] - Travaux de bâtiment" }],
"types": [
{ "value": "National", "label": "National" },
{ "value": "International", "label": "International" }
],
"hasAdvancedFilters": true
}
}Organismes
/api/v1/sandbox/organizationsRecherche d'organismes par nom (q, insensible aux accents/casse) pour résoudre un organism_id à utiliser dans le filtre de la liste, ou pagination complète pour synchroniser l'annuaire. Uniquement les organismes ayant déjà publié au moins une annonce — jamais l'intégralité de l'annuaire interne.
| q | Recherche par nom, insensible aux accents/casse. |
| page / per_page | Pagination — per_page par défaut 50, plafond 500. |
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/sandbox/organizations?q=education&per_page=50"Réponse
{
"success": true,
"data": [
{ "id": 42, "name": "Ministère de l'Éducation" }
],
"meta": { "current_page": 1, "per_page": 50, "total": 3 }
}Détail d'une annonce
/api/v1/sandbox/tenders/{id}Détail complet d'une annonce. En production, consomme une unité du quota de votre abonnement — exactement le même quota que la consultation sur le site (une annonce déjà vue, via l'API ou le site, n'est pas recomptée dans les 12 mois). Les annonces de type "Consultation en ligne" et les annonces expirées depuis plus de 10 jours ne consomment pas de quota, mais restent soumises aux mêmes règles d'accès : aucune exception si votre abonnement n'est pas actif ou si votre quota est déjà épuisé. La forme de la réponse dépend du statut de l'annonce (voir les deux exemples ci-dessous). En sandbox, aucun quota n'est consommé et les champs de quota valent null. Les annonces standard incluent sources : la liste des sources de publication de l'annonce officielle (nom de la source et image_url, lien direct vers l'image scannée, accessible sans token). Le champ description contient le texte complet de l'annonce en deux versions : html (structure seule, déjà nettoyé côté serveur : ni script, ni lien, ni image, ni style) et text (texte brut). Affichez text avec une insertion de texte (textContent), jamais comme du HTML ; si vous affichez html dans une page, nettoyez-le aussi de votre côté (ex. DOMPurify). generated vaut true quand le texte d'origine est trop volumineux et a été remplacé par un résumé généré à partir des champs de l'annonce (les détails restent dans lots et sources). description vaut null si l'annonce n'a pas de texte.
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/sandbox/tenders/1490301"Réponse — Annonce standard
{
"success": true,
"data": {
"id": 1490301,
"slug": "etude-et-suivi-realisation-de-4-classes-en-extention",
"title": "Etude et suivi realisation de 4 classes en extention",
"code": "07/2026",
"publish_date": "2026-09-09",
"ending_date": "2026-09-20T08:00:00Z",
"is_expired": true,
"status": { "id": 4, "name": "Résultats" },
"tender_type": "National",
"qualification": null,
"address_cdc": "Étude de Maître Belhadj Ali, huissier de justice, Boumerdès",
"cdc_price": { "amount": "16000000.00", "currency": "DZD" },
"organism": { "id": 3358, "name": "APC - Commune d'El Milia Wilaya de Jijel" },
"location": { "id": 20, "name": "Jijel", "type": "wilaya", "country_id": 2 },
"activities": [
{ "id": 7233, "name": "[72110000] - Travaux de bâtiment" }
],
"lots": [
{
"id": 536288,
"name": "Etude et suivi realisation de 4 classes en extention",
"entreprise": "Entreprise travaux batiment Beldjoudi Samir",
"nif": null,
"montant": "22730697.89",
"devise": "DZD",
"delai": 5,
"delai_unit": "m",
"order": 0
}
],
"description": {
"html": "<p><strong>AVIS D'ATTRIBUTION PROVISOIRE DE MARCHÉ</strong></p><p>APC d'El Milia</p><table><tr><th>Lot</th><th>Attributaire</th></tr><tr><td>1</td><td>Entreprise Beldjoudi Samir</td></tr></table>",
"text": "AVIS D'ATTRIBUTION PROVISOIRE DE MARCHÉ\n\nAPC d'El Milia\n\nLot | Attributaire\n1 | Entreprise Beldjoudi Samir",
"generated": false
},
"sources": [
{
"name": "BAOSEM",
"image_url": "https://storage.rhinotenders.com/tenders/sources/rh-ai-xorGHcEaL5sOUlpX1791965524.webp"
}
]
},
"subscription": {
"daily": { "limit": 100, "used": 8, "remaining": 92, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}Réponse — Consultation en ligne (statut 9)
{
"success": true,
"data": {
"id": 1487429,
"slug": "invitation-to-competitive-bidding-projet-ao-202677-058",
"title": "Invitation to Competitive Bidding | Projet AO_2026/77_058",
"publish_date": "2026-09-07",
"ending_date": "2026-09-30T23:45:00Z",
"is_expired": false,
"organism": { "id": 19321, "name": "General Electric Algeria Turbines (« GEAT »)" },
"location": { "id": 2, "name": "Algérie" },
"status": { "id": 9, "name": "Consultation en ligne" },
"activities": [
{ "id": 7182, "name": "[40180000] - Tubes et raccords" }
],
"description": {
"html": "<p>Fourniture de tubes et raccords selon le cahier des charges joint.</p>",
"text": "Fourniture de tubes et raccords selon le cahier des charges joint.",
"generated": false
}
},
"subscription": {
"daily": { "limit": 100, "used": 8, "remaining": 92, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}Codes d'erreur
| Statut | Signification |
|---|---|
| 401 | رمز مفقود أو غير صالح أو منتهي الصلاحية أو ملغى (رسالة عامة، دون أي تمييز). |
| 401 (wrong_environment) | رمز مستخدم في البيئة الخاطئة: رمز اختبار على العنوان الأساسي للإنتاج (/api/v1/data) أو العكس. تشير الرسالة إلى العنوان الأساسي الواجب استخدامه. |
| 403 (api_access_disabled) | وصول API معطّل لهذا الحساب من قِبل المسؤول، أو رمز لم يُنشأ لهذه الواجهة. |
| 403 (token_scope_violation) | رمز واجهة البيانات (الإنتاج أو الاختبار) مستخدم خارج واجهة البيانات: لا يعمل إلا على المسارات الموثقة هنا. |
| 403 (subscription_inactive) | لا يوجد اشتراك نشط يمنح الوصول إلى الكتالوج. يُلغى رمزك فوراً: لا يمكن إنشاء رمز جديد إلا بعد إعادة تفعيل اشتراكك. |
| 403 (quota_exceeded) | نفاد حصة الاشتراك الخاصة بالاطلاع على المناقصات. |
| 404 | مناقصة غير موجودة أو غير متاحة، أو مسار غير صالح. |
| 422 | معاملات الطلب غير صالحة (التفاصيل في errors). |
| 429 | تم تجاوز حد المعدل (15 طلباً في الدقيقة و750 أو 2500 طلباً في اليوم حسب باقتك في الإنتاج؛ 10 طلبات في الدقيقة أو 250 طلباً في اليوم في بيئة الاختبار). |
Limites de débit
إضافة إلى حصة اشتراكك (التي لا تنطبق إلا على طلبات تفاصيل المناقصة في الإنتاج)، يحمي حدٌّ تقني للمعدل الواجهةَ البرمجية من الاستخدام المفرط: 15 طلباً في الدقيقة في الإنتاج، مع سقف يومي قدره 750 طلباً للباقة المجانية و2500 طلباً للباقة المدفوعة، و10 طلبات في الدقيقة و250 طلباً في اليوم في بيئة الاختبار.
كل حد مشترك بين جميع نقاط النهاية في البيئة نفسها لحسابك (وليس حداً منفصلاً لكل نقطة نهاية)، وعدّادات الإنتاج (/api/v1/data) والاختبار (/api/v1/sandbox) مستقلة. تتضمن كل استجابة الترويستين X-RateLimit-Limit وX-RateLimit-Remaining الخاصتين بالحد الأقرب إلى النفاد (في الدقيقة، أو في اليوم عند اقتراب السقف اليومي)؛ وتتضمن الاستجابة 429 أيضاً Retry-After (بالثواني). تجنّب إعادة طلب المناقصات نفسها بشكل متكرر: استعلم عن القائمة، ثم اطلب تفاصيل المناقصات الجديدة فقط.
