यूज़र एपीआई फ़ंक्शंस
यह अनुभाग उपयोगकर्ताओं से संबंधित संचालन का वर्णन करता है।
एक उपयोगकर्ता बनाना
एक नया उपयोगकर्ता खाता बनाता है।
एंडपॉइंट: https://petstore3.swagger.io/api/v3/user
संचालन: POST
उदाहरण
- एपीआई कुंजी
- OAuth 2.0
POST "https://petstore3.swagger.io/api/v3/user" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "api_key: <YOUR_API_KEY>" \
-d '{
"id": 0,
"username": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"password": "string",
"phone": "string",
"userStatus": 0
}'
POST "https://petstore3.swagger.io/api/v3/user" \
-H "accept: application/json" \
-H "Authorization: Bearer <YOUR_OAUTH_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"id": 0,
"username": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"password": "string",
"phone": "string",
"userStatus": 0
}'
प्रतिक्रियाएँ
| कोड | विवरण |
|---|---|
| default | सफल ऑपरेशन |
प्रतिक्रिया उदाहरण
200: सफल ऑपरेशन
{
"id": 10,
"username": "theUser",
"firstName": "John",
"lastName": "James",
"email": "john@email.com",
"password": "12345",
"phone": "12345",
"userStatus": 1
}
पैरामीटर
अनुरोध बॉडी
| नाम | प्रकार | विवरण |
|---|---|---|
| body | User object | (आवश्यक) बनाने के लिए User ऑब्जेक्ट। |
list के साथ उपयोगकर्ताओं की सूची बनाना
दी गई इनपुट सूची के साथ उपयोगकर्ताओं की सूची बनाता है।
एंडपॉइंट: https://petstore3.swagger.io/api/v3/user/createWithList
ऑपरेशन: POST
उदाहरण
- एपीआई कुंजी
- OAuth 2.0
POST "https://petstore3.swagger.io/api/v3/user/createWithList" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "api_key: <YOUR_API_KEY>" \
-d \
[
{
"id": 0,
"username": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"password": "string",
"phone": "string",
"userStatus": 0
}
]
POST "https://petstore3.swagger.io/api/v3/user/createWithList" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_OAUTH_TOKEN>" \
-d \
[
{
"id": 0,
"username": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"password": "string",
"phone": "string",
"userStatus": 0
}
]
प्रतिक्रियाएँ
| कोड | विवरण |
|---|---|
| default | सफल ऑपरेशन |
प्रतिक्रिया का उदाहरण
200: सफल ऑपरेशन
{
"id": 0,
"username": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"password": "string",
"phone": "string",
"userStatus": 0
}
पैरामीटर
अनुरोध बॉडी
| नाम | प्रकार | विवरण |
|---|---|---|
| body | Array of User objects | (आवश्यक) बनाने के लिए User ऑब्जेक्ट्स की सूची। |
लॉग इन
उपयोगकर्ता को सिस्टम में लॉग इन करता है।
एंडपॉइंट: https://petstore3.swagger.io/api/v3/user/login
ऑपरेशन: GET
उदाहरण
- एपीआई कुंजी
- OAuth 2.0
GET "https://petstore3.swagger.io/api/v3/user/login?username=string&password=string" \
-H "accept: application/json" \
-H "api_key: <YOUR_API_KEY>"
GET "https://petstore3.swagger.io/api/v3/user/login?username=string&password=string" \
-H "accept: application/json" \
-H "Authorization: Bearer <YOUR_OAUTH_TOKEN>"
प्रतिक्रियाएँ
| कोड | विवरण |
|---|---|
| 200 | सफल ऑपरेशन |
| 400 | गलत उपयोगकर्ता नाम/पासवर्ड प्रदान किया गया |
| default | अप्रत्याशित त्रुटि |
प्रतिक्रिया का उदाहरण
200: सफल ऑपरेशन
{
"message": "logged in user session:abcdef12345"
}
हेडर:
| नाम | विवरण | प्रकार |
|---|---|---|
X-Rate-Limit | उपयोगकर्ता द्वारा प्रति घंटे की जाने वाली कॉल। | integer |
X-Expires-After | UTC में वह तारीख जब टोकन समाप्त हो जाता है। | string |
पैरामीटर
क्वेरी पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
| username | string | लॉगिन के लिए उपयोगकर्ता नाम। |
| password | string | लॉगिन के लिए पासवर्ड, सादा पाठ में। |
लॉग आउट
वर्तमान लॉग इन उपयोगकर्ता सत्र को लॉग आउट करता है।
एंडपॉइंट: https://petstore3.swagger.io/api/v3/user/logout
ऑपरेशन: GET
उदाहरण
- एपीआई कुंजी
- OAuth 2.0
GET "https://petstore3.swagger.io/api/v3/user/logout" \
-H "accept: application/json" \
-H "api_key: <YOUR_API_KEY>"
GET "https://petstore3.swagger.io/api/v3/user/logout" \
-H "accept: application/json" \
-H "Authorization: Bearer <YOUR_OAUTH_TOKEN>"
प्रतिक्रियाएँ
| कोड | विवरण |
|---|---|
| 200 | सफल ऑपरेशन |
| default | सफल ऑपरेशन |
प्रतिक्रिया का उदाहरण
200: सफल ऑपरेशन
{
"message": "सफलतापूर्वक लॉग आउट हो गया"
}
पैरामीटर
कोई नहीं
उपयोगकर्ता नाम से उपयोगकर्ता प्राप्त करना
उपयोगकर्ता को उनके उपयोगकर्ता नाम से प्राप्त करता है।
एंडपॉइंट: https://petstore3.swagger.io/api/v3/user/{username}
ऑपरेशन: GET
उदाहरण
- एपीआई कुंजी
- OAuth 2.0
GET "https://petstore3.swagger.io/api/v3/user/user1" \
-H "accept: application/json" \
-H "api_key: <YOUR_API_KEY>"
GET "https://petstore3.swagger.io/api/v3/user/user1" \
-H "accept: application/json" \
-H "Authorization: Bearer <YOUR_OAUTH_TOKEN>"
प्रतिक्रियाएँ
| कोड | विवरण |
|---|---|
| 200 | सफल ऑपरेशन |
| 400 | गलत उपयोगकर्ता नाम प्रदान किया गया |
| 404 | उपयोगकर्ता नहीं मिला |
| default | अप्रत्याशित त्रुटि |
200: सफल ऑपरेशन
{
"id": 0,
"username": "string",
"firstName": "string",
"lastName": "string",
"email": "string",
"password": "string",
"phone": "string",
"userStatus": 0
}
पैरामीटर
पथ पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
| username | string | प्राप्त करने के लिए उपयोगकर्ता का नाम। परीक्षण के लिए "user" का उपयोग करें। |
उपयोगकर्ता को अपडेट करना
एक उपयोगकर्ता को अपडेट करता है।
एंडपॉइंट: https://petstore3.swagger.io/api/v3/user/{username}
ऑपरेशन: PUT
उदाहरण
- एपीआई कुंजी
- OAuth 2.0
PUT "https://petstore3.swagger.io/api/v3/user/user1" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "api_key: <YOUR_API_KEY>" \
-d '{
"id": 0,
"username": "user1",
"firstName": "string",
"lastName": "string",
"email": "string",
"password": "string",
"phone": "string",
"userStatus": 0
}'
PUT "https://petstore3.swagger.io/api/v3/user/user1" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_OAUTH_TOKEN>" \
-d '{
"id": 0,
"username": "user1",
"firstName": "string",
"lastName": "string",
"email": "string",
"password": "string",
"phone": "string",
"userStatus": 0
}'
प्रतिक्रियाएँ
| कोड | विवरण |
|---|---|
| 200 | सफल ऑपरेशन |
| 400 | अमान्य उपयोगकर्ता प्रदान किया गया |
| 404 | उपयोगकर्ता नहीं मिला |
| default | अप्रत्याशित त्रुटि |
(एक सफल अपडेट कोई प्रतिक्रिया बॉडी के बिना 200 कोड लौटाता है।)
पैरामीटर
पथ पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
| username | string | उस उपयोगकर्ता का उपयोगकर्ता नाम जिसे अपडेट करना है |
अनुरोध बॉडी
| नाम | प्रकार | विवरण |
|---|---|---|
| body | User object | (आवश्यक) अपडेट की गई जानकारी के साथ User ऑब्जेक्ट। |
किसी यूज़र को हटाना
किसी यूज़र को हटाता है।
एंडपॉइंट: https://petstore3.swagger.io/api/v3/user/{username}
ऑपरेशन: DELETE
उदाहरण
- एपीआई कुंजी
- OAuth 2.0
DELETE "https://petstore3.swagger.io/api/v3/user/user1" \
-H "accept: application/json" \
-H "api_key: <YOUR_API_KEY>"
DELETE "https://petstore3.swagger.io/api/v3/user/user1" \
-H "accept: application/json" \
-H "Authorization: Bearer <YOUR_OAUTH_TOKEN>"
प्रतिक्रियाएँ
| कोड | विवरण |
|---|---|
| 200 | उपयोगकर्ता हटा दिया गया |
| 400 | अमान्य उपयोगकर्ता नाम प्रदान किया गया |
| 404 | उपयोगकर्ता नहीं मिला |
(सफल हटाने पर कोई प्रतिक्रिया बॉडी के बिना 200 कोड लौटाता है।)
पैरामीटर
पथ पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
| username | string | जिसे हटाया जाना है, उस उपयोगकर्ता का उपयोगकर्ता नाम |