Recherche dans le Directory of Open Access Journals. kind vaut article (défaut) ou journal. query est un mot-clé ou une URL de recherche DOAJ. Une URL d'article ou de sommaire (/toc/) renvoie 400. Les identifiants d'article et les ISSN de revue sont les clés des endpoints de détail.
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/doaj/search?query=climate"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/doaj/search?query=climate&kind=article&page=2"
curl -sS -H "x-api-key: YOUR_API_KEY" "https://api.piloterr.com/v2/doaj/search?query=physics&kind=journal"
| Name |
Detail |
| query |
Chaîne obligatoire. Mot-clé ou URL de recherche doaj.org. Exemple : climate. |
| kind |
Chaîne facultative. article ou journal. Exemple : journal. Défaut : article. |
| page |
Entier facultatif à partir de 1. Exemple : 2. Défaut : 1. |
| Name |
Detail |
| results[].id |
Chaîne. Id DOAJ. Pour un article, passez-le à l'endpoint article. |
| results[].title |
Chaîne. |
| results[].url |
Chaîne. Page article ou https://doaj.org/toc/{issn}. |
| results[].authors |
Article. Tableau {name, affiliation}. |
| results[].doi |
Article. Chaîne ou null. |
| results[].journal_issn |
Article. Chaîne ou null. Clé pour l'endpoint journal. |
| results[].fulltext_url |
Article. Chaîne ou null. |
| results[].eissn |
Revue. Chaîne ou null. Clé habituelle du détail revue. |
| results[].pissn |
Revue. Chaîne ou null. |
| results[].publisher |
Revue. Chaîne ou null. |
| results[].license |
Revue. Chaîne ou null. |
| results[].has_apc |
Revue. Booléen ou null. |
| pagination.per_page |
Entier. Toujours 10. |
| pagination.next |
Chaîne ou null. URL DOAJ de la page suivante, null sur la dernière page. |
10 notices par page. Pour les articles climate, next vaut https://doaj.org/search/articles/climate?page=2. Les ids ne se répètent pas d'une page à l'autre. next est null seulement sur la dernière page. kind=journal pagine de la même façon sous /search/journals/.
- Un suivi open access pagine
query=climate et garde chaque id pour l'endpoint article.
- Une bibliothèque lance
query=physics&kind=journal puis ouvre chaque eissn pour lire has_apc.
- Un outil de citation lit
journal_issn sur une carte article et vérifie que la revue est indexée.
| Name |
Detail |
| 400 |
Query absente, mauvais hôte, kind invalide, ou URL d'article ou de sommaire envoyée à search. |
| 404 |
Aucun résultat, ou page au-delà de la fin. |
| 401 |
Clé API absente. |
| 500 |
L'appel DOAJ a échoué. |
