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)
API & intégrations RhinoTenders
Environnement
URL de basehttps://api.rhinotenders.com/api/v1/data

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.

Pas encore d'accès production ? Tout compte au profil complété peut tester l'API immédiatement en sandbox, sans abonnement — voir Sandbox vs Production.

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.

Sandbox vs Production

La sandbox permet de construire et tester une intégration sans toucher à la production : essayer les endpoints, déboguer votre code, ou confier un token jetable à un développeur ou prestataire plutôt que de partager votre token de production.

Générez vous-même un token sandbox depuis votre espace API : ouvert à tout compte dont le profil est complété, sans abonnement ni validation d'un administrateur. Le token est valable 24 heures et chaque compte n'a qu'un seul token sandbox actif : en générer un nouveau invalide immédiatement le précédent.

Les deux environnements exposent exactement les mêmes endpoints, paramètres et formats de réponse : seuls l'URL de base et le token changent. Changer d'environnement est un changement de configuration, pas de code.

CritèreProductionSandbox
URL de basehttps://api.rhinotenders.com/api/v1/datahttps://api.rhinotenders.com/api/v1/sandbox
TokenToken longue durée, valable 1 an (nom : api-client).Token jetable, valable 24 heures (nom : api-sandbox). Un seul token actif par compte.
ObtentionGénéré depuis votre espace API une fois l'accès API activé pour votre compte par un administrateur RhinoTenders. Abonnement actif requis.En libre-service depuis votre espace API, pour tout compte au profil complété, quel que soit l'abonnement.
DonnéesTout le catalogue couvert par votre abonnement.Un nombre limité d'annonces réelles, pour tester votre intégration.
Quota et abonnementSelon le plan d'abonnement : les appels de détail d'annonce consomment du quota.Aucun. Les champs subscription et quota gardent la même forme, avec des valeurs null.
Limite de débit15 requêtes/minute, et par jour 750 requêtes (plan gratuit) ou 2500 requêtes (plan payant).10 requêtes/minute et 250 requêtes/jour (compteurs distincts de la production).
Filtres premiumDisponibles selon votre plan (hasAdvancedFilters).Non disponibles : organism_id, ending_date_start, ending_date_end sont acceptés mais ignorés silencieusement, et hasAdvancedFilters vaut toujours false.
Marqueur d'environnementEn-tête X-Api-Environment: production. GET /status renvoie data.environment = "production".En-tête X-Api-Environment: sandbox. GET /status renvoie data.environment = "sandbox".
Mauvais tokenUn token sandbox envoyé sur cette URL de base renvoie 401 wrong_environment.Un token de production envoyé sur cette URL de base renvoie 401 wrong_environment.

Réponse — token Sandbox envoyé sur l’URL de base Production (401)

{
  "success": false,
  "message": "This is a sandbox token. Use the sandbox base URL (/api/v1/sandbox).",
  "code": "wrong_environment"
}

Statut

GET/api/v1/data/status

Vé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/data/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

GET/api/v1/data/tenders

Retourne 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_idUn seul ID d'annonce — ignore tous les autres filtres.
tender_idsPlusieurs ID séparés par des virgules — ignore tous les autres filtres.
searchRecherche texte (titre, code).
activity_idID(s) d'activité, séparés par des virgules.
location_idID(s) de localisation, séparés par des virgules.
status_idID(s) de statut, séparés par des virgules.
organism_idID(s) d'organisme — filtre avancé, ignoré si non autorisé par votre plan, toujours ignoré en sandbox.
tender_typeNational, International, ou les deux séparés par une virgule.
publish_date_start / publish_date_endPlage de date de publication (AAAA-MM-JJ).
ending_date_start / ending_date_endPlage de date limite — filtre avancé, ignoré si non autorisé par votre plan, toujours ignoré en sandbox.
page / per_pagePagination — per_page par défaut 20, plafond 100.

Requête

curl -H "Authorization: Bearer <your_token>" \
  "https://api.rhinotenders.com/api/v1/data/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

GET/api/v1/data/tenders/filters

Données de référence pour construire vos filtres : activités, statuts, localisations, types. Un seul objet complet (pas de pagination), caché 1 à 2h côté serveur. hasAdvancedFilters reflète votre plan d'abonnement (toujours false en sandbox).

Requête

curl -H "Authorization: Bearer <your_token>" \
  "https://api.rhinotenders.com/api/v1/data/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

GET/api/v1/data/organizations

Recherche 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.

qRecherche par nom, insensible aux accents/casse.
page / per_pagePagination — per_page par défaut 50, plafond 500.

Requête

curl -H "Authorization: Bearer <your_token>" \
  "https://api.rhinotenders.com/api/v1/data/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

GET/api/v1/data/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/data/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

StatutSignification
401Token manquant, invalide, expiré ou révoqué (message générique, jamais de distinction).
401 (wrong_environment)Token utilisé dans le mauvais environnement : token sandbox sur l'URL de base de production (/api/v1/data) ou l'inverse. Le message indique l'URL de base à utiliser.
403 (api_access_disabled)Accès API désactivé pour ce compte par un administrateur, ou token qui n'a pas été généré pour cette API.
403 (token_scope_violation)Token de l'API data (production ou sandbox) utilisé en dehors de l'API data : il ne fonctionne que sur les endpoints documentés ici.
403 (subscription_inactive)Aucun abonnement actif ne donne accès au catalogue. Votre token est révoqué immédiatement : un nouveau ne peut être généré qu'après réactivation de votre abonnement.
403 (quota_exceeded)Quota d'abonnement épuisé pour la consultation d'annonces.
404Annonce introuvable, non accessible, ou route invalide.
422Paramètres de requête invalides (détail dans errors).
429Limite de débit dépassée (15 requêtes/minute et 750 ou 2500 requêtes/jour selon votre plan en production ; 10 requêtes/minute ou 250 requêtes/jour en sandbox).

Limites de débit

En plus du quota de votre abonnement (qui ne s'applique qu'aux appels de détail d'annonce en production), une limite technique protège l'API contre les abus : 15 requêtes par minute en production, avec un plafond de 750 requêtes par jour sur le plan gratuit et 2500 requêtes par jour sur un plan payant, 10 requêtes par minute et 250 requêtes par jour en sandbox.

Chaque limite est partagée entre tous les endpoints d'un même environnement pour votre compte (pas une limite séparée par endpoint), et les compteurs de production (/api/v1/data) et de sandbox (/api/v1/sandbox) sont indépendants. Chaque réponse inclut les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining de la limite la plus proche d'être atteinte (par minute, ou par jour quand le plafond journalier approche) ; une réponse 429 inclut aussi Retry-After (en secondes). Évitez de redemander les mêmes annonces en boucle : interrogez la liste, puis ne demandez le détail que des annonces nouvelles.

Choisissez les catégories de cookies que vous souhaitez activer. Vous pouvez modifier vos choix à tout moment.

Strictement nécessaires

Toujours actif

Indispensables au fonctionnement du site (authentification, sécurité). Ne peuvent pas être désactivés.

Analytiques

Nous aident à comprendre comment vous utilisez le site (statistiques de visite, performances).

Marketing

Permettent d'afficher des publicités pertinentes et de mesurer l'efficacité de nos campagnes.

Préférences

Mémorisent vos choix de langue, région et personnalisation de l'affichage.

Partenaires

Cookies déposés par nos partenaires tiers (réseaux sociaux, intégrations externes).