Rotate Access Token
const url = 'https://auth.interledger-test.dev/token/example';const options = {method: 'POST', headers: {Authorization: '<Authorization>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://auth.interledger-test.dev/token/example \ --header 'Authorization: <Authorization>'Management endpoint to rotate access token.
Authorizations
Sección titulada «Authorizations »Parameters
Sección titulada « Parameters »Path Parameters
Sección titulada «Path Parameters »The unique reference of the access token to be managed.
Responses
Sección titulada « Responses »OK
object
A single access token or set of access tokens that the client instance can use to call the RS on behalf of the RO.
object
The value of the access token as a string. The value is opaque to the client instance. The value SHOULD be limited to ASCII characters to facilitate transmission over HTTP headers within other protocols without requiring additional encoding.
The management URI for this access token. This URI MUST NOT include the access token value and SHOULD be different for each access token issued in a request.
The number of seconds in which the access will expire. The client instance MUST NOT use the access token past this time. An RS MUST NOT accept an access token past this time.
A description of the rights associated with this access token.
object
The type of resource request as a string. This field defines which other fields are allowed in the request object.
The types of actions the client instance will take at the RS as an array of strings.
A string identifier indicating a specific resource at the RS.
object
The type of resource request as a string. This field defines which other fields are allowed in the request object.
The types of actions the client instance will take at the RS as an array of strings.
A string identifier indicating a specific resource at the RS.
object
The URL of the incoming payment that is being paid.
object
The URL of the incoming payment that is being paid.
All amounts are maxima, i.e. multiple payments can be created under a grant as long as the total amounts of these payments do not exceed the maximum amount per interval as specified in the grant.
object
The value is an unsigned 64-bit integer amount, represented as a string.
The assetCode is a code that indicates the underlying asset. An ISO4217 currency code should be used whenever possible. The ISO4217 representation of the US Dollar is USD.
The number of decimal places that defines the scale of the smallest divisible unit for the given asset code. It determines how an integer amount is scaled to derive the actual monetary value. For example, USD has an asset scale of 2 with the smallest unit being 0.01. An integer amount of 1000 with an assetCode of USD and assetScale of 2 translates to $10.00.
object
The URL of the incoming payment that is being paid.
All amounts are maxima, i.e. multiple payments can be created under a grant as long as the total amounts of these payments do not exceed the maximum amount per interval as specified in the grant.
object
The value is an unsigned 64-bit integer amount, represented as a string.
The assetCode is a code that indicates the underlying asset. An ISO4217 currency code should be used whenever possible. The ISO4217 representation of the US Dollar is USD.
The number of decimal places that defines the scale of the smallest divisible unit for the given asset code. It determines how an integer amount is scaled to derive the actual monetary value. For example, USD has an asset scale of 2 with the smallest unit being 0.01. An integer amount of 1000 with an assetCode of USD and assetScale of 2 translates to $10.00.
object
The type of resource request as a string. This field defines which other fields are allowed in the request object.
The types of actions the client instance will take at the RS as an array of strings.
Examples
{ "access_token": { "value": "OZB8CDFONP219RP1LT0OS9M2PMHKUR64TB8N6BW7", "manage": "https://auth.interledger-test.dev/token/8f69de01-5bf9-4603-91ed-eeca101081f1", "expires_in": 3600, "access": [ { "type": "outgoing-payment", "actions": [ "create", "read" ], "identifier": "https://ilp.interledger-test.dev/alice", "limits": { "interval": "R12/2019-08-24T14:15:22Z/P1M", "receiver": "https://ilp.interledger-test.dev/bob/incoming-payments/48884225-b393-4872-90de-1b737e2491c2", "debitAmount": { "value": "500", "assetCode": "USD", "assetScale": 2 } } } ] }}Bad Request
object
object
Example
{ "error": { "code": "invalid_rotation" }}Unauthorized
object
object
Example
{ "error": { "code": "invalid_client" }}Not Found
object
object
Example
{ "error": { "code": "invalid_rotation" }}Internal Server Error
object
object
Example
{ "error": { "code": "request_denied" }}