Changes for page 1. Authorization

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-1. Authorization
	1	+Authorization

Content

...	...	@@ -1,33 +6,19 @@
1		-(% data-xwiki-non-generated-content="java.util.List" %)
2		-(((
3		-
4		-)))
5		-
6	6	{{box cssClass="floatinginfobox" title="**Contents**"}}
7	7	{{toc/}}
8	8	{{/box}}
9	9
10		-= Authorization: Starting Your Integration =
	5	+= Method Description =
11	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.
	7	+The initial method of the integration process is authorization. You will be provided with a test user username and password to generate the access token that you will need to pass in all the following methods.
13	13
	9	+== Request URL - [GET] ==
14	14
15		-== Request URL - [POST] ==
	11	+{{{https://online-api.kazunion.com/api/Auth/Auth}}}
16	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	23	== Request Parameters ==
24	24
25		-(% class="box" %)
26		-(((
27	27	none
28		-)))
29	29
30		-
31	31	== Request Body ==
32	32
33	33	{{code language="Json"}}
...	...	@@ -37,59 +37,45 @@
37	37	}
38	38	{{/code}}
39	39
40		-
41	41	== Response Body ==
42	42
43	43	{{code language="Json"}}
44	44	{
45		- "accessToken": "string",
46		- "refreshToken": "string",
47		- "passwordExpired": true
	30	+ "accessToken": "string"
48	48	}
49	49	{{/code}}
50	50
51		-expiration time 30 days for both tokens:
52		-
53		-accessToken - 43200 min
54		-
55		-refreshToken - 2591968 sec
56		-
57		-
58	58	=== Schema ===
59	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		-
	36	+{{code language="none"}}
	37	+GetCountriesResponse{
	38	+error boolean
	39	+errorCode string
	40	+nullable: true
	41	+errorDescription string
	42	+nullable: true
	43	+userErrorDescription string
	44	+nullable: true
	45	+countries [
	46	+nullable: true
	47	+Country{
	48	+countryCode string
	49	+nullable: true
	50	+readOnly: true
	51	+countryName string
	52	+nullable: true
	53	+note string
	54	+nullable: true
	55	+phoneCode string
	56	+nullable: true
	57	+isO2 string
	58	+nullable: true
	59	+isO3 string
	60	+nullable: true
	61	+status integer($int32)
	62	+sortingOrder integer($int32)
	63	+sellCurrency string
	64	+nullable: true
	65	+}]
74	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}}
	67	+{{/code}}