@@ -44,9 +44,12 @@ curl -X GET -i 'http://127.0.0.1:8000/api/ping'
4444### `POST /api/auth/signup`: Signup
4545```bash
4646curl -X POST -i 'http://127.0.0.1:8000/api/auth/signup' \
47- -H "Content-Type: application/json" --data '{"username": "c",
48- "email": "c",
49- "password": "c" }'
47+ -H "Content-Type: application/json" \
48+ --data '{
49+ "username": "user",
50+ "email": "user@email.com",
51+ "password": "4S3cr3tPa55w0rd"
52+ }'
5053```
5154
5255 - Request body:
@@ -76,7 +79,7 @@ curl -X POST -i 'http://127.0.0.1:8000/api/auth/signup' \
7679### `POST /api/auth/login`: Login
7780```bash
7881curl -X POST -H 'Content-Type: application/json' -i 'http://127.0.0.1:8000/api/auth/login' \
79- --data '{"username_or_email":"c ", "password":"c "}'
82+ --data '{"username_or_email":"user ", "password":"4S3cr3tPa55w0rd "}'
8083```
8184 - Request body:
8285 ```
@@ -104,14 +107,17 @@ curl -X POST -H 'Content-Type: application/json' -i 'http://127.0.0.1:8000/api/a
104107 ```
105108
106109### `POST /api/auth/login`: Logout
107- ```bash
108- curl -X POST -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzcyNTc4NzksImV4cCI6MTU3Nzg2MjY3OSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiYzUxNWE3NTg3NGYzNGVjNGFmNDJmNWE2M2QxMDVjMGYifQ.B9w6FxFdypb5GCRMKXZ9CZWFxQLFjvmPSusMCtcE-Ac' -i 'http://127.0.0.1:8000/api/auth/logout'
109- ```
110+ ```bash
111+ curl -X POST -H 'Content-Type: application/json' \
112+ -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzcyNTc4NzksImV4cCI6MTU3Nzg2MjY3OSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiYzUxNWE3NTg3NGYzNGVjNGFmNDJmNWE2M2QxMDVjMGYifQ.B9w6FxFdypb5GCRMKXZ9CZWFxQLFjvmPSusMCtcE-Ac' \
113+ -i 'http://127.0.0.1:8000/api/auth/logout'
114+ ```
110115
111116### ` GET /api/address-book ` : Get all people information
112- ```
113- curl -X GET -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' -i 'http://127.0.0.1:8000/api/address-book '
114- '
117+ ``` bash
118+ curl -X GET -H ' Content-Type: application/json' \
119+ -H ' Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' \
120+ -i ' http://127.0.0.1:8000/api/address-book'
115121```
116122 - Header:
117123 - Authorization: bearer \< token\>
@@ -135,8 +141,10 @@ curl -X GET -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0eX
135141 ```
136142
137143### `GET /api/address-book/{id}`: Get person information by id
138- ```
139- curl -X GET -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' -i 'http://127.0.0.1:8000/api/address-book/2 '
144+ ```bash
145+ curl -X GET -H 'Content-Type: application/json' \
146+ -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' \
147+ -i 'http://127.0.0.1:8000/api/address-book/2'
140148```
141149 - Param path:
142150 - id: int32
@@ -167,6 +175,11 @@ curl -X GET -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0eX
167175 ```
168176
169177### `GET /api/address-book/{query}`: Search for person information by keyword
178+ ```bash
179+ curl -X GET -H 'Content-Type: application/json' \
180+ -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' \
181+ -i 'http://127.0.0.1:8000/api/address-book/user'
182+ ```
170183 - Param path:
171184 - query: string
172185 - Header:
@@ -191,15 +204,18 @@ curl -X GET -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0eX
191204 ```
192205
193206### `POST /api/address-book`: Add person information
194- ```
195- curl -X POST -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' -i 'http://127.0.0.1:8000/api/address-book ' --data '{
196- "name": "a",
197- "gender": true,
198- "age": 32,
199- "address": "addr",
200- "phone": "133",
201- "email": "e@q.com "
202- }
207+ ```bash
208+ curl -X POST -H 'Content-Type: application/json' \
209+ -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' \
210+ -i 'http://127.0.0.1:8000/api/address-book' \
211+ --data '{
212+ "name": "c",
213+ "gender": true,
214+ "age": 32,
215+ "address": "addr",
216+ "phone": "133",
217+ "email": "e@q.com"
218+ }
203219'
204220```
205221 - Header:
@@ -232,6 +248,20 @@ curl -X POST -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0e
232248 ```
233249
234250### `PUT /api/address-book/{id}`: Update person information by id
251+ ```bash
252+ curl -X PUT -H 'Content-Type: application/json' \
253+ -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' \
254+ -i 'http://127.0.0.1:8000/api/address-book/2' \
255+ --data '{
256+ "name": "b",
257+ "gender": true,
258+ "age": 32,
259+ "address": "addr",
260+ "phone": "133",
261+ "email": "b@q.com"
262+ }
263+ '
264+ ```
235265 - Param path:
236266 - id: int32
237267 - Header:
@@ -264,6 +294,11 @@ curl -X POST -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0e
264294 ```
265295
266296### `DELETE /api/address-book/{id}`: Delete person information by id
297+ ```bash
298+ curl -X DELETE -H 'Content-Type: application/json' \
299+ -H 'Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NzU4NzM4MjksImV4cCI6MTU3NjQ3ODYyOSwidXNlciI6ImMiLCJsb2dpbl9zZXNzaW9uIjoiZjU5N2M3MTIxZTExNDBhMGE0ZjE0YmQ4N2NjM2Q4MWUifQ.6qppDfRgOw45eExJ7MUEwpcu3AUXXe9_ifj_mp7k22k' \
300+ -i 'http://127.0.0.1:8000/api/address-book/2'
301+ ```
267302 - Param path:
268303 - id: int32
269304 - Header:
@@ -284,19 +319,10 @@ curl -X POST -H 'Content-Type: application/json' -H 'Authorization: bearer eyJ0e
284319 }
285320 ```
286321
287- ### Errors:
288- - Invalid or missing token
289- - Status code: 401 Unauthorized
290- - Response:
291- ```
292- {
293- "message": "invalid token, please login again",
294- "data": ""
295- }
296- ```
297322### brower OPTIONS curl request example
298- ```
299- curl -X OPTIONS -i 'http://127.0.0.1:8000/api/login ' -H "Origin: http://example.com " -H "Access-Control-Request-Method: POST"
323+ ```bash
324+ curl -X OPTIONS -i 'http://127.0.0.1:8000/api/login' \
325+ -H "Origin: http://example.com" -H "Access-Control-Request-Method: POST"
300326```
301327 - Response
302328 HTTP/1.1 200 OK
@@ -306,3 +332,15 @@ curl -X OPTIONS -i 'http://127.0.0.1:8000/api/login' -H "Origin: http://example.
306332 access-control-allow-origin: *
307333 access-control-allow-headers: authorization,content-type,accept
308334 date: Tue, 07 Jan 2020 15:17:48 GMT
335+
336+
337+ ### Errors:
338+ - Invalid or missing token
339+ - Status code: 401 Unauthorized
340+ - Response:
341+ ```
342+ {
343+ "message": "invalid token, please login again",
344+ "data": ""
345+ }
346+ ```
0 commit comments