Wiki source code of 1. Authorization
Version 32.1 by Giorgi Mdivnishvili on 2024/04/16 18:43
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% data-xwiki-non-generated-content="java.util.List" %) | ||
| 2 | ((( | ||
| 3 | |||
| 4 | ))) | ||
| 5 | |||
| 6 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 7 | {{toc/}} | ||
| 8 | {{/box}} | ||
| 9 | |||
| 10 | = Authorization: Starting Your Integration = | ||
| 11 | |||
| 12 | The first step in integrating with our API is the authorization process. As a developer, you'll be assigned a unique username and password. These credentials are essential for generating the access token, a critical component that must be included in the headers of all subsequent API requests. This token validates your requests and grants you access to the full suite of our services. | ||
| 13 | |||
| 14 | |||
| 15 | == Request URL - [POST] == | ||
| 16 | |||
| 17 | (% class="box infomessage" %) | ||
| 18 | ((( | ||
| 19 | [[https:~~/~~/integration.kazunion.com/api/Auth/Auth>>https://integration.kazunion.com/api/Auth/Auth]] | ||
| 20 | ))) | ||
| 21 | |||
| 22 | |||
| 23 | == Request Parameters == | ||
| 24 | |||
| 25 | (% class="box" %) | ||
| 26 | ((( | ||
| 27 | none | ||
| 28 | ))) | ||
| 29 | |||
| 30 | |||
| 31 | == Request Body == | ||
| 32 | |||
| 33 | {{code language="Json"}} | ||
| 34 | { | ||
| 35 | "login": "string", | ||
| 36 | "password": "string" | ||
| 37 | } | ||
| 38 | {{/code}} | ||
| 39 | |||
| 40 | |||
| 41 | == Response Body == | ||
| 42 | |||
| 43 | {{code language="Json"}} | ||
| 44 | { | ||
| 45 | "accessToken": "string", | ||
| 46 | "refreshToken": "string", | ||
| 47 | "passwordExpired": true | ||
| 48 | } | ||
| 49 | {{/code}} | ||
| 50 | |||
| 51 | expiration time 30 days for both tokens: | ||
| 52 | |||
| 53 | accessToken - 43200 min | ||
| 54 | |||
| 55 | refreshToken - 2591968 sec | ||
| 56 | |||
| 57 | |||
| 58 | === Schema === | ||
| 59 | |||
| 60 | (% data-xwiki-non-generated-content="java.util.List" %) | ||
| 61 | ((( | ||
| 62 | |||
| 63 | ))) | ||
| 64 | |||
| 65 | {{success}} | ||
| 66 | AuthResponse{ | ||
| 67 | |||
| 68 | |accessToken|string | ||
| 69 | nullable: true | ||
| 70 | |refreshToken|string | ||
| 71 | nullable: true | ||
| 72 | |passwordExpired|boolean | ||
| 73 | |||
| 74 | } | ||
| 75 | {{/success}} | ||
| 76 | |||
| 77 | |||
| 78 | == Important == | ||
| 79 | |||
| 80 | {{error}} | ||
| 81 | === Implementing Authorization in Subsequent Requests === | ||
| 82 | |||
| 83 | For every API request after the initial authentication, it's crucial to include the authorization token in the request header. This ensures your requests are authorized and can access the necessary resources. Here's how to properly include your token: | ||
| 84 | |||
| 85 | * **Header Key:** Authorization | ||
| 86 | * **Header Value:** Bearer [Your Token Here] - Use the bearer token provided in the initial authentication response. The authorization type should be specified as Bearer Token. | ||
| 87 | |||
| 88 | Additionally, to ensure your requests are properly formatted and recognized, include the following headers: | ||
| 89 | |||
| 90 | * **Content-Type:** Specify this header as application/json to indicate the format of the request body. | ||
| 91 | * **Header Key:** X-nugios-timezone | ||
| 92 | * **Header Value:** 240 - Adjust this value to match your local timezone offset in minutes. | ||
| 93 | |||
| 94 | Incorporating these headers with their respective values is essential for the successful processing of your API requests. | ||
| 95 | {{/error}} |