Ahora contamos con una forma nueva y mejor de establecer enlaces con las páginas de resultados y las páginas que contienen los detalles de los documentos. Vea la documentación y los ejemplos que se brindan más adelante.

 Documentos e informes: API invariable
 
La sección “Documentos e informes” admite URL simplificadas para dos tipos de páginas: páginas de resultados y páginas con los detalles de los documentos. Nos cercioraremos de que se admita la API invariable aun cuando la sección “Documentos e informes” se traslade a una nueva plataforma en el futuro. De este modo, no hará falta que los usuarios modifiquen las URL que conducen a nuestros documentos.
 
Las URL correspondientes a estas páginas constan de tres partes, que en conjunto determinan: 1) con qué aplicación se abordará la solicitud, 2) qué tipo de página se obtendrá y 3) qué documento o conjunto de documentos se presentará en dicha página.
 
Estas tres partes juntas adoptan la siguiente forma:
 
http:///?
 
Nombre del host
En términos técnicos, la primera parte de la URL contiene el nombre del host. Éste será “www-wds.worldbank.org”.
 
Tipo de solicitud
La segunda parte de la URL, es decir, el tipo de página que se obtendrá, está determinada por el tipo de solicitud, que puede ser de “registro” o “pregunta”. Con una solicitud de “registro”, se obtendrán los detalles (o el registro de datos) relativos a un documento en particular. Con una solicitud en forma de “pregunta”, se obtendrá un conjunto de documentos que se corresponden con dicha pregunta.

Lista de parámetros
La tercera y última parte de la URL consiste en uno o más parámetros y sus respectivos valores. Éstos especifican el documento o conjunto de documentos que se presentarán en la página. La lista de parámetros y sus valores está separada del tipo de solicitud que la precede mediante el signo “?”.
 
Para las solicitudes de “registro” se exige un solo parámetro, el “docid” (identificación del proyecto), cuyo valor es el número de identificación que se le da en ImageBank o en la sección “Documentos e informes” al documento que se mostrará en la página. El nombre del parámetro, “docid”, se separa de su valor mediante el signo “=”.
 
Además del docid, las solicitudes de registro también admiten un parámetro opcional, el pageLanguage. Este parámetro determina el idioma de la página en la que se muestra el registro y permite a los sitios cuya lengua no sea el inglés presentar documentos del ImageBank en su mismo idioma. En la actualidad, se admiten solicitudes de francés y español.

Aquí presentamos un ejemplo:
 
www-wds.worldbank.org/record?docid=000160016_20040929135419
 
 
Con las solicitudes en forma de “preguntas” se obtiene un conjunto de documentos que se presentan en la página en forma de lista. Las solicitudes en forma de “preguntas” pueden tener uno o más parámetros. Cada parámetro adicional especifica o restringe con más precisión los resultados que se obtendrán y corresponde a un atributo del registro o de los detalles de un documento. El nombre del parámetro se separa de su valor mediante el signo “=”. Cuando se utiliza más de una combinación parámetro / valor, se separan entre sí con el signo “&”. No se utiliza este signo antes de la primera combinación. Para “preguntar” acerca de más de un valor correspondiente a un atributo, incluya combinaciones adicionales de parámetro / valor para dicho atributo (cada una con un solo valor) o bien utilice una vez el nombre del parámetro e incluya la lista de los valores correspondientes, separados por un espacio. Al preguntar acerca de varios valores para un atributo se incrementa el número de documentos que se obtienen, puesto que en los resultados se pueden incluir documentos relativos a cada valor especificado.
 
Al igual que las solicitudes de registro, las “preguntas” también pueden especificar el idioma de la página en la que se mostrarán los resultados. En la actualidad se admiten el francés y el español.