Project

General

Profile

1

    
2

    
3
<!DOCTYPE html>
4
<html lang="en-gb">
5
	<head>
6
		<meta charset="utf-8">
7
		<meta http-equiv="X-UA-Compatible" content="IE=edge">
8
		<meta name="viewport" content="width=device-width, initial-scale=1">
9
		<meta http-equiv="content-type" content="text/html; charset=utf-8" />
10
		<meta name="description" content="OpenAIRE API documentation - Authentication, authenticated requests, better rate limits"/>
11
		<link href="assets/common-assets/logo-small-graph.png">
12
		<link rel="apple-touch-icon" sizes="57x57" href="assets/common-assets/logo/apple-icon-57x57.png">
13
		<link rel="apple-touch-icon" sizes="60x60" href="assets/common-assets/logo/apple-icon-60x60.png">
14
		<link rel="apple-touch-icon" sizes="72x72" href="assets/common-assets/logo/apple-icon-72x72.png">
15
		<link rel="apple-touch-icon" sizes="76x76" href="assets/common-assets/logo/apple-icon-76x76.png">
16
		<link rel="apple-touch-icon" sizes="114x114" href="assets/common-assets/logo/apple-icon-114x114.png">
17
		<link rel="apple-touch-icon" sizes="120x120" href="assets/common-assets/logo/apple-icon-120x120.png">
18
		<link rel="apple-touch-icon" sizes="144x144" href="assets/common-assets/logo/apple-icon-144x144.png">
19
		<link rel="apple-touch-icon" sizes="152x152" href="assets/common-assets/logo/apple-icon-152x152.png">
20
		<link rel="apple-touch-icon" sizes="180x180" href="assets/common-assets/logo/apple-icon-180x180.png">
21
		<link rel="icon" type="image/png" sizes="192x192" href="assets/common-assets/logo/android-icon-192x192.png">
22
		<link rel="icon" type="image/png" sizes="32x32" href="assets/common-assets/logo/favicon-32x32.png">
23
		<link rel="icon" type="image/png" sizes="96x96" href="assets/common-assets/logo/favicon-96x96.png">
24
		<link rel="icon" type="image/png" sizes="16x16" href="assets/common-assets/logo/favicon-16x16.png">
25
		<link href="assets/common-assets/logo/favicon.ico" rel="shortcut icon" type="image/vnd.microsoft.icon"/>
26
		<title>OpenAIRE API documentation - Authentication</title>
27
		<script  src="./assets/common-assets/jquery/jquery.js"></script>
28
		<script  src="./assets/uikit.js"></script>
29
		<script src="./assets/uikit-icon-max.js"></script>
30
		<!-- Include header and footer files -->
31
		<script>
32
			$(function(){
33
				$("#headerMobile").load("headerMobile.html");
34
				$('#header').load("header.html");
35
			});
36
		</script>
37
		<!-- Matomo -->
38
		<script type="text/javascript">
39
			var _paq = window._paq || [];
40
			/* tracker methods like "setCustomDimension" should be called before "trackPageView" */
41
			_paq.push(['trackPageView']);
42
			_paq.push(['enableLinkTracking']);
43
			(function() {
44
			var u="//analytics.openaire.eu/";
45
			_paq.push(['setTrackerUrl', u+'matomo.php']);
46
			_paq.push(['setSiteId', '470']);
47
			var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
48
			g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
49
			})();
50
		</script>
51
		<link rel="stylesheet" type="text/css" href="./assets/common-assets/common/theme.css">
52
		<link rel="stylesheet" type="text/css" href="./assets/common-assets/common/custom.css">
53
		<link rel="stylesheet" type="text/css" href="./assets/common-assets/library.css">
54
		<link rel="stylesheet" type="text/css" href="./assets/develop-custom.css">
55
	</head>
56
	<body class="graphApp">
57
		<div class="uk-offcanvas-content uk-height-viewport">
58

    
59
			<!-- MENU STARTS HERE-->
60
			<div id="headerMobile" class="tm-header-mobile uk-hidden@m"></div>
61
			<div id="header" class="tm-header uk-visible@m tm-header-transparent" uk-header=""></div>
62
			<!-- MENU ENDS HERE-->
63

    
64
			<div class=" first_page_section uk-section-default uk-section uk-padding-remove-vertical">
65
					<div class="first_page_banner_headline uk-grid-collapse uk-flex-middle uk-margin-remove-vertical uk-grid" uk-grid="">
66
					</div>
67
			</div>
68

    
69
			<!-- Page content STARTS here -->
70
				<div class="uk-section tm-middle custom-main-content" id="tm-main">
71
					<div class="uk-margin-large-left uk-margin-medium-bottom">
72
						<ul class="uk-breadcrumb">
73
							<li>
74
								<a href="/">Home</a>
75
							</li>
76
							<li>
77
								<a href="overview.html">Resources</a>
78
							</li>
79
							<li>
80
								<a style="cursor: default;">APIs</a>
81
							</li>
82
							<li>
83
								<span>Authentication</span>
84
							</li>
85
						</ul>
86
					</div>
87
					<div class="uk-container">
88
						<div class="uk-grid">
89
							<!-- Side menu & content -->
90
							<div class="uk-width-1-3@s uk-width-1-4@m uk-width-1-4@l uk-visible@m" >
91
								<ul class="uk-nav-default uk-nav-parent-icon" uk-nav="multiple: false" uk-sticky="offset: 115; media:@s" >
92
										<li class="uk-parent uk-open">
93
												<a href="#">Authentication</a>
94
												<ul class="uk-nav-sub">
95
														<li><b><a href="./authentication.html">General Information</a></b></li>
96
														<li><a href="./personalToken.html">Personal Token</a></li>
97
														<li><a href="./registeredService.html">Registered Services</a></li>
98
												</ul>
99
										</li>
100
								</ul>
101
							</div>
102

    
103
							<div class="tm-main uk-width-expand uk-row-first uk-first-column">
104
								<h2 class="uk-text-center">Authentication</h2>
105
									<p>
106
										The OpenAIRE APIs can be accessed over HTTPS both by authenticated and non authenticated requests. 
107
										Currently, there is <b>an adjustment period until October 2022</b>, when the rate limit for both authenticated 
108
										and non authenticated requests is up to 7200 requests per hour. <b>After this period we plan to significantly 
109
										lower the rate limit of non authenticated requests up to 60 requests per hour.</b> 
110
										
111
										<p>Please consider to make authenticated requests to achieve better rate limits. Check our Privacy Policy <a href="http://www.openaire.eu/privacy-policy" target="_blank">here</a>.</p>
112
										
113
										<table class="uk-table uk-table-divider uk-table-striped">
114
										<thead>
115
												<tr>
116
														<th colspan="2" class="uk-text-center">OpenAIRE APIs Rate limits</th>
117
												</tr>
118
										</thead>
119
										<tbody>
120
												<tr>
121
														<td>Not authenticated requests</td>
122
														<td>up to 7200 requests per hour 
123
																<br>soon to decrease - please see above</td>
124
												</tr>
125
												<tr>
126
													<td>Authenticated requests</td>
127
													<td>up to 7200 request per hour</td>
128
												</tr>
129
										</tbody>
130
								</table>
131

    
132
								<p>The only exception to this approach is the LOD API that will continue to be accessible only via HTTP and 
133
										non authenticated requests at <a href="http://lod.openaire.eu/sparql" target="_blank"> http://lod.openaire.eu/sparql</a> 
134
										with the current rate limits.</p>
135

    
136
										OpenAIRE APIs can be used for both authentication and authorization. Our OAuth 2.0 implementation, conforms to the 
137
										OpenID Connect specification, and is <a href="https://openid.net/certification/" target="_blank">OpenID Certified</a>. 
138
										OpenID Connect is a simple identity layer on top of the OAuth 2.0 protocol. For more information about OAuth2.0 please 
139
										visit the <a href="https://oauth.net/2/" target="_blank">OAuth2.0 official site</a>. For more information about OpenID 
140
										Connect please visit the <a href="https://openid.net/connect/" target="_blank">OpenID Connect official site</a>. 
141
									</p>
142

    
143
									<h4 class="portal-color">Requests</h4>
144

    
145
									<p>To access the OpenAIRE APIs with better rate limits, send your access token using the Authorization header.</p>
146

    
147
									<pre class="uk-text-left">
148
	GET https://api.openaire.eu/{resourceServicePath}
149
	Authorization: Bearer {ACCESS_TOKEN}</pre>
150

    
151
									<p>To get an access token, we support <a href="./personalToken.html"><b>personal access token</b></a> creation and 
152
										<a href="./registeredService.html"><b>service registration</b></a>.</p>
153

    
154

    
155
									<h4 class="portal-color">Response Headers</h4>
156
									<table class="uk-table uk-table-divider uk-table-striped">
157
										<tbody>
158
												<tr>
159
														<td>x-ratelimit-limit</td>
160
														<td>The maximum number of requests allowed for the client in one time window.</td>
161
												</tr>
162
												<tr>
163
													<td>x-ratelimit-used</td>
164
													<td>The number of requests already made by the client in the current time window.</td>
165
												</tr>
166
										</tbody>
167
								</table>
168

    
169
								<p>The OpenAIRE APIs use a sliding time window of one hour.</p>
170

    
171

    
172
									<h4 class="portal-color">Error Messages</h4>
173
									<p>404 - Not found</p> <!--404-->
174
									<pre class="uk-text-left">
175
{
176
	"error": "Not found",
177
	"description": "Invald request path."
178
}</pre>
179

    
180
									<p>403 - Invalid Access Token</p> <!--403-->
181
									<pre class="uk-text-left">
182
{
183
	"error": "Token invalid",
184
	"description": "Authorization header value invalid."
185
}</pre>
186

    
187
									<p>429 - Rate limit abuse for unauthenticated user</p> <!--429-->
188
									<pre class="uk-text-left">
189
{
190
	"error": "Too many requests",
191
	"description": "Request rate exceeded. Slow down."
192
}</pre>
193

    
194
									<p>429 - Rate limit abuse</p> <!--429-->
195
									<pre class="uk-text-left">
196
{
197
	"error": "Too many requests",
198
	"description": "Request rate exceeded. Slow down."
199
}</pre>
200
						</div> <DO NOT REMOVE>
201
					</div>
202
				</div>
203
			</div>
204
			<!-- Page content ENDS here -->
205

    
206
		<!-- Footer STARTS here -->
207
		<bottom class="footer">
208
			<div class="footer-light-background uk-padding-remove-bottom uk-section uk-section-small">
209
				<div class="uk-container uk-container-small">
210
					<div>
211
						<div id="footer#3" class="uk-first-column uk-flex uk-flex-middle uk-grid uk-margin-remove-right">
212
							<div class="uk-text-center uk-width-1-1 uk-width-1-4@m">
213
								<img width="126px" height="30px" alt="OpenAIRE" loading="lazy" class="el-image" src="assets/common-assets/common/Logo_Horizontal_dark_small.png">
214
							</div>
215
							<div id="footer#5" class="uk-margin uk-text-left uk-width-expand">
216
								<div class="uk-flex uk-flex-middle">
217
									<div>
218
										<img alt="flag black white low" width="50px" height="33px" loading="lazy" style="margin-right: 8px; float: left;" src="assets/common-assets/common/commission.jpg">
219
									</div>
220
									<div class="uk-margin-left">
221
										<div>
222
												<span style="font-size: 8pt; line-height: 0.7!important;">OpenAIRE has received funding from the European Union's Horizon 2020 research and innovation programme under grant agreements No. 777541 and 101017452</span>
223
										</div>
224
									</div>
225
								</div>
226
							</div>
227
						</div>
228
						<div>
229
							<div class="uk-width-expand@m">
230
								<div id="footer#7" class="uk-text-right@m uk-text-center">
231
									<ul uk-margin="" class="uk-flex-center uk-margin-remove-bottom uk-subnav uk-subnav-divider"></ul>
232
								</div>
233
							</div>
234
						</div>
235
						<div class="uk-margin uk-text-center uk-width-1-1">
236
							<div uk-grid="" class="uk-child-width-auto uk-flex-center uk-grid uk-grid-small">
237
								<div class="uk-first-column">
238
									<a href="https://www.facebook.com/groups/openaire/" target="_blank" class="el-link uk-icon-button uk-icon">
239
										<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
240
											<path d="M11,10h2.6l0.4-3H11V5.3c0-0.9,0.2-1.5,1.5-1.5H14V1.1c-0.3,0-1-0.1-2.1-0.1C9.6,1,8,2.4,8,5v2H5.5v3H8v8h3V10z"></path>
241
										</svg>
242
									</a>
243
								</div>
244
								<div>
245
									<a href="https://www.twitter.com/OpenAIRE_eu" target="_blank" class="el-link uk-icon-button uk-icon">
246
										<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
247
											<path d="M19,4.74 C18.339,5.029 17.626,5.229 16.881,5.32 C17.644,4.86 18.227,4.139 18.503,3.28 C17.79,3.7 17.001,4.009 16.159,4.17 C15.485,3.45 14.526,3 13.464,3 C11.423,3 9.771,4.66 9.771,6.7 C9.771,6.99 9.804,7.269 9.868,7.539 C6.795,7.38 4.076,5.919 2.254,3.679 C1.936,4.219 1.754,4.86 1.754,5.539 C1.754,6.82 2.405,7.95 3.397,8.61 C2.79,8.589 2.22,8.429 1.723,8.149 L1.723,8.189 C1.723,9.978 2.997,11.478 4.686,11.82 C4.376,11.899 4.049,11.939 3.713,11.939 C3.475,11.939 3.245,11.919 3.018,11.88 C3.49,13.349 4.852,14.419 6.469,14.449 C5.205,15.429 3.612,16.019 1.882,16.019 C1.583,16.019 1.29,16.009 1,15.969 C2.635,17.019 4.576,17.629 6.662,17.629 C13.454,17.629 17.17,12 17.17,7.129 C17.17,6.969 17.166,6.809 17.157,6.649 C17.879,6.129 18.504,5.478 19,4.74"></path>
248
										</svg>
249
									</a>
250
								</div>
251
								<div>
252
									<a href="https://www.linkedin.com/groups/3893548/" target="_blank" class="el-link uk-icon-button uk-icon">
253
										<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
254
											<path d="M5.77,17.89 L5.77,7.17 L2.21,7.17 L2.21,17.89 L5.77,17.89 L5.77,17.89 Z M3.99,5.71 C5.23,5.71 6.01,4.89 6.01,3.86 C5.99,2.8 5.24,2 4.02,2 C2.8,2 2,2.8 2,3.85 C2,4.88 2.77,5.7 3.97,5.7 L3.99,5.7 L3.99,5.71 L3.99,5.71 Z"></path>
255
											<path d="M7.75,17.89 L11.31,17.89 L11.31,11.9 C11.31,11.58 11.33,11.26 11.43,11.03 C11.69,10.39 12.27,9.73 13.26,9.73 C14.55,9.73 15.06,10.71 15.06,12.15 L15.06,17.89 L18.62,17.89 L18.62,11.74 C18.62,8.45 16.86,6.92 14.52,6.92 C12.6,6.92 11.75,7.99 11.28,8.73 L11.3,8.73 L11.3,7.17 L7.75,7.17 C7.79,8.17 7.75,17.89 7.75,17.89 L7.75,17.89 L7.75,17.89 Z"></path>
256
										</svg>
257
									</a>
258
								</div>
259
								<div>
260
									<a href="https://www.slideshare.net/OpenAIRE_eu" target="_blank" class="el-link uk-icon-button uk-icon">
261
										<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
262
											<line fill="none" stroke="#000" stroke-width="1.1" x1="13.4" y1="14" x2="6.3" y2="10.7"></line>
263
											<line fill="none" stroke="#000" stroke-width="1.1" x1="13.5" y1="5.5" x2="6.5" y2="8.8"></line>
264
											<circle fill="none" stroke="#000" stroke-width="1.1" cx="15.5" cy="4.6" r="2.3"></circle>
265
											<circle fill="none" stroke="#000" stroke-width="1.1" cx="15.5" cy="14.8" r="2.3"></circle>
266
											<circle fill="none" stroke="#000" stroke-width="1.1" cx="4.5" cy="9.8" r="2.3"></circle>
267
										</svg>
268
									</a>
269
								</div>
270
								<div>
271
									<a href="https://www.youtube.com/channel/UChFYqizc-S6asNjQSoWuwjw" target="_blank" class="el-link uk-icon-button uk-icon">
272
										<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
273
											<path d="M15,4.1c1,0.1,2.3,0,3,0.8c0.8,0.8,0.9,2.1,0.9,3.1C19,9.2,19,10.9,19,12c-0.1,1.1,0,2.4-0.5,3.4c-0.5,1.1-1.4,1.5-2.5,1.6 c-1.2,0.1-8.6,0.1-11,0c-1.1-0.1-2.4-0.1-3.2-1c-0.7-0.8-0.7-2-0.8-3C1,11.8,1,10.1,1,8.9c0-1.1,0-2.4,0.5-3.4C2,4.5,3,4.3,4.1,4.2 C5.3,4.1,12.6,4,15,4.1z M8,7.5v6l5.5-3L8,7.5z"></path>
274
										</svg>
275
									</a>
276
								</div>
277
								<div>
278
									<a target="_blank" href="https://www.openaire.eu/newsletter" class="el-link newsletter">
279
										<span class="el-title uk-margin uk-text-large"> Newsletter 
280
											<span class="el-image uk-icon">
281
												<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
282
													<circle cx="3.12" cy="16.8" r="1.85"></circle>
283
													<path fill="none" stroke="#000" stroke-width="1.1" d="M1.5,8.2 C1.78,8.18 2.06,8.16 2.35,8.16 C7.57,8.16 11.81,12.37 11.81,17.57 C11.81,17.89 11.79,18.19 11.76,18.5"></path><path fill="none" stroke="#000" stroke-width="1.1" d="M1.5,2.52 C1.78,2.51 2.06,2.5 2.35,2.5 C10.72,2.5 17.5,9.24 17.5,17.57 C17.5,17.89 17.49,18.19 17.47,18.5"></path>
284
												</svg>
285
											</span>
286
										</span>
287
									</a>
288
								</div>
289
							</div>
290
						</div>
291
					</div>
292
				</div>
293
			</div>
294
			<div class="footer-light-background uk-section uk-section-xsmall">
295
				<div class="uk-container uk-container-expand">
296
					<div uk-grid="" class="uk-grid-margin uk-grid">
297
						<div class="uk-width-small@m uk-first-column"></div>
298
						<div class="uk-width-expand@m">
299
							<div id="footer#22" class="uk-text-small uk-margin uk-margin-remove-bottom uk-text-center@m uk-text-center">
300
								<a href="http://creativecommons.org/licenses/by/4.0/" rel="license" class="license"> &nbsp;
301
									<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24">
302
										<path id="creative-commons" d="M9.7,14.675a1.311,1.311,0,0,1-1.15-.557,2.511,2.511,0,0,1-.391-1.477q0-2.032,1.541-2.034a1.36,1.36,0,0,1,.666.205,1.569,1.569,0,0,1,.605.718l1.541-.8A3.222,3.222,0,0,0,9.457,9.067a3.249,3.249,0,0,0-2.412.964,3.548,3.548,0,0,0-.957,2.61,3.562,3.562,0,0,0,.945,2.63,3.362,3.362,0,0,0,2.485.942,3.367,3.367,0,0,0,1.766-.481,3.408,3.408,0,0,0,1.254-1.326l-1.419-.718a1.44,1.44,0,0,1-1.416.987Zm6.634,0a1.312,1.312,0,0,1-1.15-.557,2.511,2.511,0,0,1-.391-1.477q0-2.032,1.541-2.034a1.389,1.389,0,0,1,.686.205,1.577,1.577,0,0,1,.608.718l1.519-.8a3.181,3.181,0,0,0-3.04-1.663,3.253,3.253,0,0,0-2.412.964,3.546,3.546,0,0,0-.955,2.61,3.576,3.576,0,0,0,.934,2.63,3.349,3.349,0,0,0,2.5.942,3.328,3.328,0,0,0,1.745-.481,3.54,3.54,0,0,0,1.274-1.326l-1.438-.718a1.441,1.441,0,0,1-1.416.987ZM21.156,4.12A11.61,11.61,0,0,0,12.624.64a11.436,11.436,0,0,0-8.44,3.48A11.738,11.738,0,0,0,.641,12.64,11.537,11.537,0,0,0,4.185,21.1a11.532,11.532,0,0,0,8.44,3.541,11.856,11.856,0,0,0,8.592-3.57,11.389,11.389,0,0,0,3.424-8.431,11.583,11.583,0,0,0-3.484-8.52Zm-1.5,15.391a9.631,9.631,0,0,1-7,2.94,9.479,9.479,0,0,1-6.938-2.911A9.422,9.422,0,0,1,2.8,12.64,9.57,9.57,0,0,1,5.747,5.68,9.3,9.3,0,0,1,12.655,2.8a9.4,9.4,0,0,1,6.94,2.88,9.411,9.411,0,0,1,2.884,6.96,9.157,9.157,0,0,1-2.823,6.87Z" transform="translate(-0.641 -0.64)"></path>
303
									</svg>
304
									<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24">
305
										<g id="Group_756" data-name="Group 756" transform="translate(0)">
306
												<path id="Path_2324" data-name="Path 2324" d="M18.325,11.98a.775.775,0,0,0-.775-.775H12.641a.775.775,0,0,0-.775.775v4.909h1.369V22.7h3.719V16.889h1.37V11.98Z" transform="translate(-3.095 -2.951)"></path>
307
												<path id="Path_2325" data-name="Path 2325" d="M17.209,7.759A1.679,1.679,0,1,1,15.53,6.08,1.679,1.679,0,0,1,17.209,7.759Z" transform="translate(-3.529 -1.83)"></path>
308
												<path id="Path_2326" data-name="Path 2326" d="M12.624.64A11.439,11.439,0,0,0,4.183,4.12,11.736,11.736,0,0,0,.639,12.64,11.537,11.537,0,0,0,4.183,21.1a11.531,11.531,0,0,0,8.441,3.54,11.851,11.851,0,0,0,8.591-3.57,11.383,11.383,0,0,0,3.424-8.43,11.582,11.582,0,0,0-3.484-8.52,11.612,11.612,0,0,0-8.53-3.48Zm.03,2.159a9.4,9.4,0,0,1,6.939,2.88,9.414,9.414,0,0,1,2.883,6.96,9.156,9.156,0,0,1-2.823,6.87,9.63,9.63,0,0,1-7,2.94,9.48,9.48,0,0,1-6.939-2.91A9.425,9.425,0,0,1,2.8,12.64,9.573,9.573,0,0,1,5.746,5.68,9.3,9.3,0,0,1,12.654,2.8Z" transform="translate(-0.639 -0.64)"></path>
309
										</g>
310
									</svg>
311
								</a> &nbsp;Unless otherwise indicated, all materials created by OpenAIRE are licenced under
312
								<a href="http://creativecommons.org/licenses/by/4.0/" rel="license">
313
										CC ATTRIBUTION 4.0 INTERNATIONAL LICENSE
314
								</a>. 
315
							</div>
316
						</div>
317
						<div class="uk-width-small@m">
318
							<div class="uk-margin uk-margin-remove-top uk-margin-remove-bottom uk-text-right@m uk-text-center">
319
								<a href="#" uk-scroll="" class="uk-totop uk-icon">
320
									<svg width="18" height="10" viewBox="0 0 18 10" xmlns="http://www.w3.org/2000/svg" data-svg="totop">
321
										<polyline fill="none" stroke="#000" stroke-width="1.2" points="1 9 9 1 17 9 "></polyline>
322
									</svg>
323
								</a>
324
							</div>
325
						</div>
326
					</div>
327
				</div>
328
			</div>
329
		</bottom>
330
		<!-- Footer ENDS here -->
331

    
332
		</div>
333
	</body>
334
</html>
(7-7/19)