L'API RESTFUL du portail ICP offre un accès en temps réel aux publications d'avis d'appels d'offres et de plans de marchés publics, facilitant ainsi une récupération automatisée et précise des informations. En intégrant cette API dans leurs systèmes, les organisations peuvent centraliser les données, automatiser leur collecte et personnaliser les informations selon leurs besoins spécifiques. Cela réduit le besoin de vérifications manuelles, minimise les erreurs humaines, et améliore l'efficacité des processus internes.
De plus, l'API améliore la réactivité en alertant instantanément les utilisateurs des nouvelles publications, ce qui permet une prise de décision plus rapide et une exploitation optimale des opportunités. L'intégration des données récupérées dans des outils d'analyse et de reporting permet également une meilleure compréhension des tendances du marché et des exigences des appels d'offres, renforçant ainsi la productivité et la capacité stratégique des équipes.
Pour utiliser l'API vous devez nous contacter, un simple courriel vers contact@icp-marchepublic.com peut suffir.
Il faudra juste mentionner "API du Portail ICP" en objet de la demande et laissez des informations pour vous contacter. Après avoir conclu avec l'equipe, vous obtiendrez des identifiants de connexion.
api.icp-marchepublic.com/loginSe connecter afin de récupérer le token pour les requêtes. Notez qu'après 30 minutes d'inactivité vous devrez vous reconnecter.
Arguments de la requête :
{
"username": "Nom d'utilisateur",
"password": "Mot de passe"
}
{
"status": "200",
"message": "Connexion réussie",
"token": "exempledetoken_6bf2ccb05a11633f1cfde1795a372ae22"
}
api.icp-marchepublic.com/change_passwordPermet de modifier votre mot de passe. Vous êtes obligé de changer votre mot de passe si vous vous connectez pour la premiere fois.
Arguments de la requête :
{
"username": "Nom d'utilisateur",
"current_password": "Mot de passe actuel",
"new_password": "Nouveau mot de passe"
}
current_password: Mot de passe actuel (ou par defaut)
new_password: Nouveau mot de passe (assurez-vous de le noter)
{
"status": "200",
"message": "Le mot de passe a été changé"
}
api.icp-marchepublic.com/postsCette route nécessite un token. Pour accéder aux ressources protégées de cette API, vous devez fournir un jeton d'authentification dans l'en-tête Authorization de votre requête.
Authorization: Bearer votre_token
Permet recuperer les publications.
Supporte la pagination, entrez les parametres page et limit pour utiliser la pagination. Les deux parametres sont à utiliser ensemble afin que cela soit fonctionnel.
Exemple:
api.icp-marchepublic.com/posts?page=2&limit=10 (Pour la page 2, de 10 publications par page).
page: pour la page demandée
limit: pour le nombre de publications par page
L'absence de pagination vous ramenera toutes les publications presentent sur le portail.
Retourne dans data les publications.
id: id de la publication
type: type de la publication
pays: pays de la publication en code ALPHA 3
titre: titre de la publication
detail: details de la publication
par: source de la publication
secteurs: categories : secteurs concernés /
date_pub: date de publication
date_limite: date limite
{
"statut": 200,
"data": [
{
"id": "11",
"type": "Avis d'appel d'offre",
"pays": "MLI",
"titre": "Réhabilitation du vieux pont",
"detail": "Réhabilitation complète du vieux pont pour améliorer la sécurité",
"par": "ICP SARL",
"secteurs": "Travaux: bâtiment et construction",
"date_pub": "2023-08-15 00:00:00",
"date_limite": "2024-01-15"
},
{
"id": "12",
"type": "Avis d'appel d'offre",
"pays": "CIV",
"titre": "Audit du système d'information",
"detail": "Détail sur l'audit du système d'information",
"par": "ICP SARL",
"secteurs": "Prestations intellectuelles: bâtiment et construction, ingénierie et architecture",
"date_pub": "2024-07-27 00:00:00",
"date_limite": "2024-08-24"
},
{
"id": "13",
"type": "Plan de passation",
"pays": "MLI",
"titre": "Plan de passation 1",
"detail": "Détails sur le plan de passation 1",
"par": "ICP SARL",
"secteurs": "Travaux: bâtiment et construction, santé et services sociaux / Fourniture: technologies de l'information (ti), énergie et environnement, transport et logistique / Prestations intellectuelles: ingénierie et architecture, administration publique et services",
"date_pub": "2024-07-27 00:00:00",
"date_limite": null
},
{
"id": "14",
"type": "Avis d'appel d'offre",
"pays": "MLI",
"titre": "Clôture de l'exercice 2024",
"detail": "Clôture de l'exercice 2024 (comptabilité)",
"par": "ICP SARL",
"secteurs": "Prestations intellectuelles: commerce et services",
"date_pub": "2024-08-01 00:00:00",
"date_limite": "2024-09-07"
},
{
"id": "15",
"type": "Avis d'appel d'offre",
"pays": "MLI",
"titre": "Amélioration du portail de gestion d'appel d'offres",
"detail": "Amélioration du portail de gestion d'appel d'offres",
"par": "ICP SARL",
"secteurs": "Prestations intellectuelles: arts, culture et loisirs, agriculture et agroalimentaire",
"date_pub": "2024-08-01 00:00:00",
"date_limite": "2024-09-30"
},
{
"id": "16",
"type": "Avis de pré-information",
"pays": "MLI",
"titre": "Construction de la commissariat de Kita",
"detail": "Construction intégrale de la commissariat de Kita",
"par": "ICP SARL",
"secteurs": "Travaux: bâtiment et construction, administration publique et services",
"date_pub": "2024-08-01 00:00:00",
"date_limite": "2024-10-30"
},
{
"id": "17",
"type": "Avis d'appel d'offre",
"pays": "MLI",
"titre": "Développement d'une application pour la gestion des retards et absences",
"detail": "Développement d'une application pour la gestion des retards et absences pour l'ecole Les ELITES",
"par": "ICP SARL",
"secteurs": "Prestations intellectuelles: énergie et environnement, éducation et formation",
"date_pub": "2024-08-06 00:00:00",
"date_limite": "2024-09-22"
},
{
"id": "18",
"type": "Avis d'appel d'offre",
"pays": "MLI",
"titre": "Acquisition de mobiliers de bureau",
"detail": "Acquisition de mobiliers de bureau",
"par": "ICP SARL",
"secteurs": "Fourniture: éducation et formation",
"date_pub": "2024-07-04 00:00:00",
"date_limite": "2024-10-06"
},
{
"id": "19",
"type": "Avis d'appel d'offre",
"pays": "CIV",
"titre": "Consulting en gestion de projets.",
"detail": "Consulting en gestion de projets.",
"par": "ICP SARL",
"secteurs": "Prestations intellectuelles: industrie et fabrication",
"date_pub": "2024-08-03 00:00:00",
"date_limite": "2024-09-15"
},
{
"id": "20",
"type": "Avis d'appel d'offre",
"pays": "SEN",
"titre": "Peinture du palais présidentielle",
"detail": "Peinture du palais présidentielle sénégalais",
"par": "ICP SARL",
"secteurs": "Travaux: bâtiment et construction, ingénierie et architecture, administration publique et services",
"date_pub": "2024-08-07 00:00:00",
"date_limite": "2024-10-20"
}
]
}
api.icp-marchepublic.com/files/file_idCette route nécessite un token. Pour accéder aux ressources protégées de cette API, vous devez fournir un jeton d'authentification dans l'en-tête Authorization de votre requête.
Authorization: Bearer votre_token
Permet recuperer les fichiers d'une publication en format .zip.
file_id: id de la publication dont vous voulez les fichiers
Si les documents existent, retourne : le fichier zip contenant les documents de la publication dont vous avez fourni l'id en parametre.
Si aucun document n'existe pour la publication, retourne :
Exemple : api.icp-marchepublic.com/files/45
{
"status": 404,
"message": "Pas de fichiers disponibles pour id 4"
}
L'API renvoie différents codes de statut HTTP en cas d'erreur :
400 Bad Request : La requête est mal formée ou invalide.
401 Unauthorized : Les informations d'identification fournies sont incorrectes ou le token a expiré.
403 Forbidden : L'accès à la ressource est refusé.
404 Not Found : La ressource demandée n'existe pas.
405 Method Not Allowed : La methode http n'est pas autorisé.
500 Internal Server Error : Une erreur inattendue s'est produite sur le serveur.
Exemple de réponse pour une requête non autorisée :
{
"status": 401,
"message": "Token invalide"
}