# OpenURL 1.0 #

L'API ISTEX permet un accès direct au plein-texte via le protocole OpenURL (plutôt que de passer par une recherche classique afin d'obtenir l'ID ISTEX). Le résolveur OpenURL ISTEX vous redirigera directement vers le plein-texte d'un document identifié unitairement, si vous y avez accès, en suivant le standard ANSI/NISO Z39.88-2004 (R2010).

Implémentation du standard Z39.88-2004

Ce standard est déjà en grande partie implémenté dans l'API, mais il se peut que certains types de métadonnées ne soient pas encore pris en charge. Si cela s'avère utile ou nécessaire, nous ferons évoluer le résolveur pour qu'il respecte de plus en plus le standard tel qu'il est défini officiellement.

Voici la liste des descripteurs d'identification disponibles (rft_id), qui permettent d'identifier une ressource unique :

&rft_id      = info:doi/<value>   Recherche sur un DOI
&rft_pii     = info:pii/<value>   Recherche sur un PII (identifiants spécifiques, utilisés notamment chez Elsevier et IOP)
&rft_pmid    = info:pmid/<value>  Recherche sur un PMID (PubMed ID, utilisés notamment chez BMJ et OUP)

Exemples :

https://api.istex.fr/document/openurl?rft_id=info:doi/10.1136/acupmed-2012-010183

https://api.istex.fr/document/openurl?rft_id=info:pii/S0143-0807(98)90774-7

ATTENTION : Il doit s'agir du DOI d'une ressource unique (article ou chapitre). Le DOI d'un livre ou d'une revue ne fonctionneront pas. Si vous ne possédez que le DOI du livre ou de la revue, utilisez les descripteurs de méta-données jdoi et bdoi comme décrits ci-dessous.

Et les descripteurs de meta-données :

&rft.atitle = <value>   Titre de l'article
&rft.jtitle = <value>   Titre du journal
&rft.btitle = <value>   Titre du Livre
&rft.jdoi   = <value>   DOI du journal
&rft.bdoi   = <value>   DOI du Livre
&rft.issn   = <value>   ISSN
&rft.isbn   = <value>   ISBN
&rft.date   = <value>   Date de publication
&rft.volume = <value>   Numéro de volume du journal 
&rft.issue  = <value>   Numéro de parution du journal
&rft.spage  = <value>   Page de Début
&rft.epage  = <value>   Page de fin
&rft.aulast = <value>   Nom de famille du premier auteur
&rft.aufirst= <value>   Prénom du premier auteur
&rft.auinit = <value>   Initiales de l'auteur
&rft.auinitm= <value>   Initiale du second prénom de l'auteur
&rft.au     = <value>   Nom complet des autres auteurs (ex : "Harry S. Truman"), si plusieurs auteurs secondaires : "&rft.ut=Second,%20A&rft.ua=Third,%20A"

Vos critères doivent être suffisamment précis pour identifier une unique ressource. S'ils ne sont pas suffisamment exhaustifs, le résolveur vous retournera un message de notification et un code HTTP 300. Le DOI d'un article ou d'un chapitre permettra d'identifier quasi-systématiquement une ressource unique, d'autres combinaisons sont possibles, comme "ISSN+Volume+N° Issue+Auteur+Page du début de l'article" qui possèdent également un taux satisfaisant d'identification.

Exemple :

https://api.istex.fr/document/openurl?rft.au=Richard James Clark&rft.issn=0964-5284&rft.volume=30&rft.issue=4&rft.spage=298

Exemple d'un manque d'exhaustivité :

https://api.istex.fr/document/openurl?rft.au=Richard James Clark&rft.issn=0964-5284

Résolveur de liens

L'intégralité du standard n'a pas été utilisée au sein de la plate-forme, pour une raison : Nous ne vous redirigerons pas vers un autre réservoir de données qu'ISTEX, ce que des résolveurs comme celui de CrossRef peuvent faire. Bien entendu, nous sommes ouverts aux suggestions à ce sujet.

Désactiver la redirection automatique vers la ressource

Avec

&noredirect     = <true|false>  "false" désactive la redirection automatique vers la ressource originale (défaut: false)

ou

&directlink     = <true|false>  alias inversé de noredirect (défaut: true)

Suite à la demande de nos utilisateurs, nous vous permettons à travers cette variable, d'empêcher la redirection vers la ressource originale. L'API se contentera alors de vous informer si, oui ou non, nous avons identifié le document et elle vous donnera le lien vers le document plein-texte original le cas échéant.

Exemple :

https://api.istex.fr/document/openurl?rft.au=Richard James Clark&rft.issn=0964-5284&rft.volume=30&rft.issue=4&rft.spage=298&noredirect