Dokumentation

Refresh Token Endpoint

Refresh an Access Token

The Refresh Token Endpoint allows clients to obtain a new OAuth2 access token by submitting a valid refresh token along with the corresponding client ID.

Endpoint
URL: https://api.accounda.com/v1/token/refresh/
Method: POST
Request Headers
Content-Type: application/x-www-form-urlencoded
Authorization string Bearer token for accessing the endpoint. Format: Bearer your_refresh_token.
Client-ID string The client identifier issued during client registration.
Sample Request
https
POST /v1/token/refresh/ HTTP/1.1
Host: api.accounda.com
Authorization: Bearer your_refresh_token
Client-ID: your_client_id
Content-Type: application/json
Response
Content-Type: application/json
Success Response
On success, the API returns a JSON object containing the new access token, refresh token, token type, and expiration time.
Status Code: 200 OK
json
{
    "access_token": "new_access_token",
    "refresh_token": "new_refresh_token",
    "token_type": "Bearer",
    "expires_in": 3600
}
Error Response
If the request fails due to missing or invalid request headers, the API returns an error message.
Status Code: 400 Bad Request

Missing or Invalid Refresh Token
json
{
    "error": "Invalid Authorization header format."
}

Invalid Client-ID or Refresh Token
json
{
    "error": "Invalid Client-ID or refresh token."
}

Expired Refresh Token
json
{
    "error": "Refresh token has expired."
}
Security
This endpoint requires client ID (client_id) and a refresh token. All API requests should be made over HTTPS to ensure data security.
Notes
  • The access token is valid for a limited time (3600 seconds by default) and should be refreshed before it expires.
  • The refresh token is valid for a maximum of 7 days and will expire after usage.
User Validation Endpoint
Request an Access Token

Um auf geschützte Bereiche der API zuzugreifen, benötigst du einen Access Token.

Access Token Endpoint
Validate User Authentication

Verifiziere die Authentifizierung eines Nutzers, um eine korrekte Anmeldung sicherzustellen.

User Validation Endpoint
Retrieve User Information

Greife auf die Benutzerinformationen zu, um Details zu einem autorisierten Nutzer abzurufen.

User Information Endpoint