Documents et rapports

Pour les webmasters

Nous encourageons les développeurs comme vous à pointer vers notre site. Vous pouvez pour cela copier l’URL à partir de la barre d’adresse, ou bien construire votre propre API/URL (voir ci-dessous). Ce que nous vous demandons, c'est de créer seulement des liens qui renvoient directement à notre site, et de ne pas incorporer la page de la Banque sous la bannière de votre propre site.

Nous avons défini une nouvelle et meilleure façon de créer des liens vers les profils et résultats pour nos documents et rapports. Voyez la documentation et les exemples ci-dessous.

API fixe – Documents et Rapports (D&R)

Notre site Documents et rapports (D&R) supportera les URL simplifiées pour deux types de pages : les pages de résultats, et les pages de profils de documents. Nous veillerons à supporter l’API de type invariant même si les D&R passent sur une nouvelle plateforme à l’avenir, pour que les utilisateurs n’aient pas à changer leurs URL pointant vers nos documents.

Les URL pour ces pages comportent trois parties, qui définissent ensemble les éléments suivants : 1) par quelle application la demande doit être traitée ; 2) le type de page qui doit être généré ; et 3) le document ou la série de documents qui doit apparaître sur la page en question.

L’ensemble de ces trois parties se présente sous la forme suivante :

http:///?

Nom d’hôte

Techniquement parlant, la première partie de l’URL désigne l’hôte. En l’occurrence, le nom d’hôte sera «documents.banquemondiale.org».

Type de demande

La deuxième partie de l’URL, correspondant au type de page devant être généré, est fonction du type de demande. La demande sera du type «record» ou «query». Une demande de «record» produira le profil (ou registre de données) correspondant à un document particulier. Une demande de «query» produira une série de documents correspondant à cette requête.

 

Type de demandeRésultat de la demande
recordProfil complet pour un document particulier, comportant un ou plusieurs liens vers le document proprement dit.
querySérie de documents présentée sous forme de liste ou de tableau.

 

Liste de paramètres

La troisième et dernière partie de l’URL comprend un ou plusieurs paramètres et les valeurs qui s’y rattachent. Ce sont ces paramètres et valeurs qui déterminent le document ou la série de documents qui apparaîtra sur la page. La liste des paramètres et des valeurs correspondantes est séparée du type de demande qui la précède par le caractère « ? ».

Une demande de type «record» a un seul paramètre exigé, «docid», dont la valeur est l’identificateur ImageBank ou D&R pour le document dont le profil doit apparaître sur la page. Le nom de ce paramètre («docid») est séparé de sa valeur par le signe « = ».

En plus du paramètre docid, les demandes de registre peuvent aussi accepter un paramètre optionnel, « pageLanguage ». Ce paramètre détermine la langue de la page sur laquelle apparaîtra le registre, et peut servir aux sites de langue autre que l’anglais pour présenter les documents ImageBank dans la langue du site. À l’heure actuelle, le système supporte deux autres langues, à savoir le français et l’espagnol.

Nom du paramètreUtilisation
docidIdentificateur D&R pour le document dont le profil doit apparaître sur la page.
pageLanguageLangue de la page sur laquelle apparaît le registre. Cette fonction n’est pas encore disponible.

Voici un exemple d’URL et de ses composantes :

documents.banquemondiale.org/record?docid=000160016_20040929135419

Une demande de type «Query» porte sur une série de documents qui apparaîtra sous forme de liste sur la page générée par la demande. Elle peut comporter un ou plusieurs paramètres. Chaque paramètre successif sert à définir ou limiter plus précisément ce qui doit s’afficher sur la page. Les paramètres en question correspondent aux différents attributs figurant dans un registre ou profil de document. Le nom de chacun est séparé de sa valeur par le signe « = ». Si plus d’une paire paramètre/valeur est utilisée, chaque paire successive est séparée de la précédente par le caractère « & », étant entendu que la première paire n’est pas précédée du caractère « & ». Pour effectuer une requête sur plus d’une valeur pour un attribut, il y a lieu soit d’inclure les paires paramètre/valeur supplémentaires pour cet attribut (chacune comportant une seule valeur), soit d’utiliser une fois le nom du paramètre et de le faire suivre des valeurs, séparées les unes des autres par un espace. Une requête effectuée sur de multiples valeurs pour un certain attribut aura pour effet de multiplier le nombre de documents inclus dans le résultat de la demande, puisque les documents correspondant à chaque valeur incluse pourront figurer dans ce résultat.

Like record requests, query requests may also specify the language of the page displaying results. French and Spanish are supported currently.

 

Nom du paramètreValeurUtilisation
texttextun ou plusieurs mots
titletexttitre du document
collectiontexttitre de la collection dont fait partie le document
sourceCitationTextextrait du texte d’origine
authortextl’auteur (ou l’un des auteurs) du document
regiontext or IDrégion à laquelle se rattache le document
countrytext or IDpays auquel se rattache le document
sectortext or IDsecteur auquel se rattache le document
subsectortext or IDsous-secteur auquel se rattache le document
topictext or IDthème sur lequel porte le document
majorDocTypetext or IDprincipale catégorie de documents dont fait partie le document
docTypetext or IDdocument lui-même
languagetext or IDlangue dans laquelle le document a été rédigé ou traduit
dateyyyy/mm/dddate de soumission ou de publication du document
startDateyyyy/mm/dddébut d’une série de dates ; les documents figurant dans le résultat de la demande auront été soumis ou publiés à ou après cette date ; peut s’accompagner d’une « endDate » (fin de série) ou non ; dans ce dernier cas, c’est la date présente qui clôt la série de dates
endDateyyyy/mm/ddfin d’une série de dates ; les documents figurant dans le résultat de la demande auront été soumis ou publiés à ou avant cette date ; peut s’accompagner d’une « startDate » (début de série) ou non ; dans ce dernier cas, la série inclut toutes les dates antérieures à la date présente.
reportIDnuméro de rapport assigné au document
loanIDnuméro du prêt auquel se rattache le document
creditIDnuméro du crédit auquel se rattache le document
projecttext or IDnom ou identificateur du projet auquel auquel se rattache le document
trustFundIDfonds fiduciaire auquel se rapporte le document
pageSizenumbernombre de résultats à afficher par page (jusqu’à 50)
pageLanguageIDlangue de la page sur laquelle apparaît le registre ; à l’heure actuelle, le système supporte le français et l’espagnol.
sortByattribut (« date », « title », « report » ou « docType ») devant servir à trier les résultats de la demande ; le tri se fait par ordre ascendant hormis pour la date, où il se fait par ordre descendant

Quelques exemples explicatifs figurent ci-dessous :

Pour afficher les documents sur un thème donné…

 

documents.banquemondiale.org/query?topic=123090

 

Pour afficher les documents se rapportant à un thème et un pays donnés…

 

documents.banquemondiale.org/query?country=392849& topic=123090

 

Pour afficher tous les documents soumis ou publiés à une certaine date…

 

documents.banquemondiale.org/query?date=2004/2/4

 

Pour afficher tous les documents sur un thème donné soumis ou publiés entre deux dates…

 

documents.banquemondiale.org/query?startDate=2004/1/1&endDate=2004/2/1&topic=909203

Pour afficher tous les documents en arabe…

documents.banquemondiale.org/query?language=Arabic