Skip to content

Commit 34fa6d6

Browse files
committed
Update README.md
1 parent c9e24a3 commit 34fa6d6

File tree

1 file changed

+71
-33
lines changed

1 file changed

+71
-33
lines changed

README.md

Lines changed: 71 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -44,9 +44,12 @@ curl -X GET -i 'http://127.0.0.1:8000/api/ping'
4444
### `POST /api/auth/signup`: Signup
4545
```bash
4646
curl -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
7881
curl -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

Comments
 (0)