Revision 60402
Added by Katerina Iatropoulou about 3 years ago
api.html | ||
---|---|---|
59 | 59 |
|
60 | 60 |
</li> |
61 | 61 |
<li class="uk-nav-header uk-parent"> |
62 |
Authentication |
|
63 |
<ul class="uk-nav-sub"> |
|
64 |
<li><a routerLinkActive="uk-link" href="./authentication.html" >General Information</a></li> |
|
65 |
<li><a routerLinkActive="uk-link" href="./personalToken.html" >Personal Token</a></li> |
|
66 |
<li><a routerLinkActive="uk-link" href="./registeredService.html">Registered Services</a> |
|
67 |
<ul class="uk-nav-sub"> |
|
68 |
<li><a routerLinkActive="uk-link" href="./basic.html">Basic</a></li> |
|
69 |
<li><a routerLinkActive="uk-link" href="./advanced.html">Advanced</a></li> |
|
70 |
</ul> |
|
71 |
</li> |
|
72 |
</ul> |
|
73 |
</li> |
|
74 |
<li class="uk-nav-header uk-parent"> |
|
62 | 75 |
Bulk access |
63 | 76 |
<ul class="uk-nav-sub"> |
64 | 77 |
<li><a routerLinkActive="uk-link" href="./graph-dumps.html" >OpenAIRE Research Graph Dumps</a></li> |
... | ... | |
119 | 132 |
<li class="uk-parent"> |
120 | 133 |
<a href="overview.html" class="" aria-expanded="false">Overview</a> |
121 | 134 |
</li> |
135 |
|
|
136 |
<li class="uk-parent"> |
|
137 |
<a href="#" class="" aria-expanded="false">Authentication</a> |
|
138 |
<div class="uk-navbar-dropdown uk-navbar-dropdown-bottom-left" style="left: 116px; top: 80px;"> |
|
139 |
<div class="uk-navbar-dropdown-grid uk-child-width-1-1 uk-grid uk-grid-stack" uk-grid=""> |
|
140 |
<div class="uk-first-column"> |
|
141 |
<ul class="uk-nav uk-navbar-dropdown-nav"> |
|
142 |
<li><a routerLinkActive="uk-link" href="./authentication.html" >General Information</a></li> |
|
143 |
<li><a routerLinkActive="uk-link" href="./personalToken.html" >Personal Token</a></li> |
|
144 |
<li><a routerLinkActive="uk-link" href="./registeredService.html">Registered Services</a></li> |
|
145 |
</ul> |
|
146 |
</div> |
|
147 |
</div> |
|
148 |
</div> |
|
149 |
</li> |
|
122 | 150 |
<li class="uk-parent"> |
123 | 151 |
<a href="#" class="" aria-expanded="false">Bulk access</a> |
124 | 152 |
<div class="uk-navbar-dropdown uk-navbar-dropdown-bottom-left" style="left: 116px; top: 80px;"> |
... | ... | |
203 | 231 |
<h4>TERMS OF USE AND SLA</h4> |
204 | 232 |
<p><strong>OpenAIRE HTTP API</strong>: the APIs are free-to-use (no sign-up needed) by any third-party service. Note that:</p> |
205 | 233 |
<ul> |
206 |
<li>The HTTP API limits each query to 10,000 paged results; for unlimited access to the APIs please contact <a href="mailto:paolo.manghi@isti.cnr.it">the service administrators</a>. |
|
234 |
<li>The OpenAIRE APIs can be accessed over HTTPS both by authenticated and unauthenticated requests. To achieve better rate limits you need to make authenticated requests. |
|
235 |
For more information check the documentation <a href="./authentication.html">here</a> |
|
236 |
</li> |
|
237 |
<li>For accessing the whole content of the OpenAIRE Research Graph check the <a href="graph-dumps.html">OpenAIRE Research Graph Dumps</a>. |
|
207 | 238 |
</li> |
208 | 239 |
<li>Since 2015 an <a href="https://zenodo.org/record/51077#.WsdCFdNubOR">RDF dump of the LOD is made available in Zenodo.org</a></li> |
209 | 240 |
</ul> |
... | ... | |
212 | 243 |
<p><strong>Quality of Service</strong>: all API services are running in production 24/7 within the OpenAIRE infrastructure premises deployed at the <a href="http://icm.edu.pl/en/centre-of-technology/">data center</a> facilities of the <a href="http://icm.edu.pl/en/">Interdisciplinary Centre for Mathematical and Computational Modelling</a> (ICM). |
213 | 244 |
</p> |
214 | 245 |
<p><strong>APIs rate limits</strong> |
246 |
For more details on the rate limits please check <a href="./authentication.html">here.</a> |
|
247 |
</p> |
|
248 |
<!--p><strong>APIs rate limits</strong> |
|
215 | 249 |
<ul> |
216 | 250 |
<li>no more than 30 concurrent connections from single IP to any APIs</li> |
217 | 251 |
<li>no more than 67 concurrent requests in total</li> |
218 | 252 |
<li>no more then 37 concurrent request in total (max 30 per single IP) to the HTTP API for selective access</li> |
219 | 253 |
<li>no more than 15 requests/second to the HTTP API for selective access (in total, not per IP. If this limit is reached, requests will be delayed).</li> |
220 | 254 |
</ul> |
221 |
</p> |
|
255 |
</p-->
|
|
222 | 256 |
</div> |
223 | 257 |
|
224 | 258 |
|
... | ... | |
226 | 260 |
|
227 | 261 |
<p> Parameters included in this section can always be specified, regardless the type of <strong>entities</strong> (metadata about <strong>publications</strong>, |
228 | 262 |
<strong>research data</strong>, <strong>software</strong>, <strong>other research products</strong>, or <strong>projects</strong>) you want to retrieve. <br> |
263 |
<!-- ATTENTION change back |
|
229 | 264 |
To query for publications metadata: <strong>http://api.openaire.eu/search/publications</strong> <br> |
230 | 265 |
To query for research data metadata: <strong>http://api.openaire.eu/search/datasets</strong> <br> |
231 | 266 |
To query for software metadata: <strong>http://api.openaire.eu/search/software</strong> <br> |
232 | 267 |
To query for other research products metadata: <strong>http://api.openaire.eu/search/other</strong> <br> |
233 | 268 |
To query for projects metadata: <strong>http://api.openaire.eu/search/projects</strong> <br> |
269 |
--> |
|
270 |
To query for publications metadata: <strong>https://api-test.openaire.eu/search/api/publications</strong> <br> |
|
271 |
To query for research data metadata: <strong>https://api-test.openaire.eu/search/api/datasets</strong> <br> |
|
272 |
To query for software metadata: <strong>https://api-test.openaire.eu/search/api/software</strong> <br> |
|
273 |
To query for other research products metadata: <strong>https://api-test.openaire.eu/search/api/other</strong> <br> |
|
274 |
To query for projects metadata: <strong>https://api-test.openaire.eu/search/api/projects</strong> <br> |
|
234 | 275 |
</p> |
235 | 276 |
|
236 | 277 |
<table class="uk-table uk-table-striped uk-table-hover uk-table-small"> |
... | ... | |
301 | 342 |
</table> |
302 | 343 |
|
303 | 344 |
<h2 id="pubs">Publication specific parameters</h2> |
345 |
<!-- ATTENTION change back |
|
304 | 346 |
<p>Endpoint: <strong>http://api.openaire.eu/search/publications</strong></p> |
347 |
--> |
|
348 |
<p>Endpoint: <strong>http://api-test.openaire.eu/search/api/publications</strong></p> |
|
305 | 349 |
|
306 | 350 |
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify"> |
307 | 351 |
<thead> |
... | ... | |
392 | 436 |
</table> |
393 | 437 |
|
394 | 438 |
<h2 id="datasets">Research Data specific parameters</h2> |
439 |
<!-- Attention change back |
|
395 | 440 |
<p>Endpoint: <strong>http://api.openaire.eu/search/datasets</strong></p> |
441 |
--> |
|
442 |
<p>Endpoint: <strong>https://api-test.openaire.eu/search/api/datasets</strong></p> |
|
396 | 443 |
|
397 | 444 |
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify"> |
398 | 445 |
<thead> |
... | ... | |
482 | 529 |
</table> |
483 | 530 |
|
484 | 531 |
<h2 id="software">Software specific parameters</h2> |
532 |
<!-- ATTENTION change back |
|
485 | 533 |
<p>Endpoint: <strong>http://api.openaire.eu/search/software</strong></p> |
534 |
--> |
|
486 | 535 |
|
536 |
<p>Endpoint: <strong>http://api-test.openaire.eu/search/api/software</strong></p> |
|
537 |
|
|
487 | 538 |
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify"> |
488 | 539 |
<thead> |
489 | 540 |
<tr> |
... | ... | |
572 | 623 |
</table> |
573 | 624 |
|
574 | 625 |
<h2 id="other">Other Research Products specific parameters</h2> |
626 |
<!-- ATTENTION change back |
|
575 | 627 |
<p>Endpoint: <strong>http://api.openaire.eu/search/other</strong></p> |
628 |
--> |
|
576 | 629 |
|
630 |
<p>Endpoint: <strong>http://api-test.openaire.eu/search/api/other</strong></p> |
|
631 |
|
|
577 | 632 |
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify"> |
578 | 633 |
<thead> |
579 | 634 |
<tr> |
... | ... | |
662 | 717 |
</table> |
663 | 718 |
|
664 | 719 |
<h2 id="projects">Project specific parameters</h2> |
720 |
<!-- ATTENTION change back |
|
665 | 721 |
<p>Endpoint: <strong>http://api.openaire.eu/search/projects</strong></p> |
722 |
--> |
|
723 |
<p>Endpoint: <strong>http://api-test.openaire.eu/search/api/projects</strong></p> |
|
666 | 724 |
|
667 | 725 |
<table class="uk-table uk-table-striped uk-table-hover uk-table-small uk-table-justify"> |
668 | 726 |
<thead> |
Also available in: Unified diff
Authentication documentation added + broker card + broker dummy page