Revision 61661
Added by Katerina Iatropoulou over 2 years ago
| personalToken.html | ||
|---|---|---|
| 216 | 216 |
To create your personal access token: |
| 217 | 217 |
<ol> |
| 218 | 218 |
<li>Login to OpenAIRE. In case you are not already a member you will need to register first.</li> |
| 219 |
<li>Go to <a href="https://beta.services.openaire.eu/uoa-user-management/personalToken" target="_blank">your personal access token page</a> to get your personal access token.</li>
|
|
| 219 |
<li>Go to <a href="https://services.openaire.eu/uoa-user-management/personalToken" target="_blank">your personal access token page</a> to get your personal access token.</li> |
|
| 220 | 220 |
</ol> |
| 221 | 221 |
|
| 222 | 222 |
<div class="uk-alert-primary" uk-alert> |
| ... | ... | |
| 231 | 231 |
|
| 232 | 232 |
<p>To access the OpenAIRE APIs send your personal access token using the Authorization header.</p> |
| 233 | 233 |
|
| 234 |
<pre> |
|
| 235 |
<code> |
|
| 236 |
GET https://api-test.openaire.eu/{resourceServicePath}
|
|
| 237 |
Authorization: Bearer {ACCESS_TOKEN}
|
|
| 238 |
</code> |
|
| 239 |
</pre> |
|
| 234 |
<pre class="uk-text-left"> |
|
| 235 |
GET https://test.openaire.eu/{resourceServicePath}
|
|
| 236 |
Authorization: Bearer {ACCESS_TOKEN}</pre>
|
|
| 240 | 237 |
|
| 241 | 238 |
<h4>An hour is not enough? What to do.</h4> |
| 242 | 239 |
|
| ... | ... | |
| 246 | 243 |
<p>To get your refresh token:</p> |
| 247 | 244 |
<ol> |
| 248 | 245 |
<li>Login to OpenAIRE. In case you are not already a member you will need to register first.</li> |
| 249 |
<li>Go to <a href="https://beta.services.openaire.eu/uoa-user-management/personalToken" target="_blank">your personal access token page</a> and click the <span class="uk-text-primary"><b>"Get a refresh token"</b></span> button to get your refresh token.</li>
|
|
| 246 |
<li>Go to <a href="https://services.openaire.eu/uoa-user-management/personalToken" target="_blank">your personal access token page</a> and click the <span class="uk-text-primary"><b>"Get a refresh token"</b></span> button to get your refresh token.</li> |
|
| 250 | 247 |
</ol> |
| 251 | 248 |
|
| 252 | 249 |
<div class="uk-alert-primary" uk-alert> |
| ... | ... | |
| 267 | 264 |
|
| 268 | 265 |
<p>To get a personal access token using your refresh token you need to make the following request:</p> |
| 269 | 266 |
<pre class="uk-text-left"> |
| 270 |
<code class="uk-text-left"> |
|
| 271 |
https:beta.services.openaire.eu/uoa-user-management/api/users/getAccessToken?refreshToken=${your_refresh_token}
|
|
| 272 |
</code> |
|
| 273 |
</pre> |
|
| 267 |
https://services.openaire.eu/uoa-user-management/api/users/getAccessToken?refreshToken=${your_refresh_token}</pre>
|
|
| 274 | 268 |
|
| 275 | 269 |
<p>The response has the following format</p> |
| 276 |
<pre> |
|
| 277 |
<code> |
|
| 278 |
{ "access_token": "...",
|
|
| 279 |
"token_type":"Bearer", |
|
| 280 |
"refresh_token": "...", |
|
| 281 |
"expires_in": ..., |
|
| 282 |
"scope":"...", |
|
| 283 |
"id_token":"..." |
|
| 284 |
} |
|
| 285 |
</code> |
|
| 286 |
</pre> |
|
| 270 |
<pre class="uk-text-left"> |
|
| 271 |
{ "access_token": "...",
|
|
| 272 |
"token_type":"Bearer", |
|
| 273 |
"refresh_token": "...", |
|
| 274 |
"expires_in": ..., |
|
| 275 |
"scope":"...", |
|
| 276 |
"id_token":"..." |
|
| 277 |
}</pre> |
|
| 287 | 278 |
|
| 288 | 279 |
<h4>Error Messages</h4> |
| 289 | 280 |
<p>Missing Refresh Token</p> |
| 290 |
<pre> |
|
| 291 |
<code> |
|
| 292 |
{ "status" : "error",
|
|
| 293 |
"code" : "400", |
|
| 294 |
"message" : "Bad Request", |
|
| 295 |
"description" : "Missing refreshToken parameter" |
|
| 296 |
} |
|
| 297 |
</code> |
|
| 298 |
</pre> |
|
| 281 |
<pre class="uk-text-left"> |
|
| 282 |
{ "status" : "error",
|
|
| 283 |
"code" : "400", |
|
| 284 |
"message" : "Bad Request", |
|
| 285 |
"description" : "Missing refreshToken parameter" |
|
| 286 |
}</pre> |
|
| 299 | 287 |
|
| 300 | 288 |
<p>Invalid Refresh Token</p> |
| 301 |
<pre> |
|
| 302 |
<code> |
|
| 303 |
{ "status" : "error",
|
|
| 304 |
"code" : "401", |
|
| 305 |
"message" : "Unauthorised", |
|
| 306 |
"description" : "Invalid refreshToken token" |
|
| 307 |
} |
|
| 308 |
</code> |
|
| 309 |
</pre> |
|
| 289 |
<pre class="uk-text-left"> |
|
| 290 |
{ "status" : "error",
|
|
| 291 |
"code" : "401", |
|
| 292 |
"message" : "Unauthorised", |
|
| 293 |
"description" : "Invalid refreshToken token" |
|
| 294 |
}</pre> |
|
| 310 | 295 |
|
| 311 | 296 |
<h4>Need more access?</h4> |
| 312 |
<p>Please <a href="https://beta.services.openaire.eu/uoa-user-management/registeredServices" target="_blank">register a service</a>.</p>
|
|
| 297 |
<p>Please <a href="https://services.openaire.eu/uoa-user-management/registeredServices" target="_blank">register a service</a>.</p> |
|
| 313 | 298 |
</div> <DO NOT REMOVE> |
| 314 | 299 |
</div> |
| 315 | 300 |
</div> |
Also available in: Unified diff
PRIVATE moved changes in src folder