DJoserAuthAPI.postman_collection.json

{
  "info": {
    "_postman_id": "5053cbc4-6e56-46b9-9551-07986e43b7f6",
    "name": "DJoserAuthAPI",
    "description": "## DJoserAuthAPI\n\nThis collection covers the authentication and user management API built with **Djoser** and **Django REST Framework**. It includes endpoints for the full user lifecycle — from registration to account deletion — as well as seller features and Google OAuth2 social login.\n\n### What's included\n\n**Authentication (JWT)**\n\n- Register a new account, activate it via email, and log in to receive JWT tokens.\n    \n- Refresh access tokens and log out securely.\n    \n\n**Password Management**\n\n- Change your password while logged in, or trigger a reset email and confirm the reset.\n    \n\n**User Profile**\n\n- Retrieve, update, or delete your own account data.\n    \n\n**Google OAuth2**\n\n- Initiate the Google OAuth2 login flow and handle the callback to authenticate via Google.\n    \n\n**Seller Features** _(in the_ `_Seller_` _folder)_\n\n- Request to become a seller (triggers an email), verify a seller account, and access the seller dashboard.\n    \n\n### Getting Started\n\nSet the `baseURL` collection variable to your API's base URL (e.g., `http://127.0.0.1:8000/api/v1/auth`) before running any requests. Most endpoints require a valid JWT access token — use the **Login** request first and attach the returned token as a Bearer token.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_exporter_id": "43960170",
    "_collection_link": "https://go.postman.co/collection/43960170-5053cbc4-6e56-46b9-9551-07986e43b7f6?source=collection_link"
  },
  "item": [
    {
      "name": "Seller",
      "item": [
        {
          "name": "Become Seller(email sending)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "",
                "description": "JWT <access>",
                "type": "text"
              }
            ],
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "store_name",
                  "value": "",
                  "type": "text",
                  "uuid": "5d200559-3c1c-4c24-9b3e-860a5ceed425"
                },
                {
                  "key": "business_email",
                  "value": "",
                  "type": "text",
                  "uuid": "c5ab1308-1764-4fde-a816-12ffc2f18f8d"
                }
              ]
            },
            "url": {
              "raw": "{{baseURL}}/seller/",
              "host": [
                "{{baseURL}}"
              ],
              "path": [
                "seller",
                ""
              ]
            }
          },
          "response": []
        },
        {
          "name": "Verify seller",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "",
                "description": "JWT <access>",
                "type": "text"
              }
            ],
            "body": {
              "mode": "formdata",
              "formdata": []
            },
            "url": {
              "raw": "{{baseURL}}/verify-seller/<token>/",
              "host": [
                "{{baseURL}}"
              ],
              "path": [
                "verify-seller",
                "<token>",
                ""
              ]
            }
          },
          "response": []
        },
        {
          "name": "Seller Dashboard",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "",
                "description": "JWT <access>",
                "type": "text"
              }
            ],
            "body": {
              "mode": "formdata",
              "formdata": []
            },
            "url": {
              "raw": "{{baseURL}}/sellerDashboard/",
              "host": [
                "{{baseURL}}"
              ],
              "path": [
                "sellerDashboard",
                ""
              ]
            }
          },
          "response": []
        }
      ],
      "description": "## Seller\n\nThis folder contains endpoints for managing the seller onboarding flow within the DJoserAuthAPI.\n\n### Endpoints\n\n- **Become Seller** – Submits a seller registration request and triggers a verification email to the provided address.\n    \n- **Verify Seller** – Confirms the seller's identity using a unique token sent via email. Complete this step to activate seller privileges.\n    \n- **Seller Dashboard** – Retrieves the authenticated seller's dashboard data.\n    \n\n### Authentication\n\nRequests in this folder require a valid authenticated user session. Ensure your `{{baseURL}}` environment variable is set before running these requests.\n\n### Workflow\n\n1. Call **Become Seller** with the required details to initiate the process.\n    \n2. Check your email and use the verification link/token with **Verify Seller**.\n    \n3. Once verified, access your **Seller Dashboard**."
    },
    {
      "name": "Google-oauth",
      "item": [
        {
          "name": "Google Login",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseURL}}/o/google-oauth2/?redirect_uri=http://127.0.0.1:8000/api/v1/auth/o/google-oauth2/",
              "host": [
                "{{baseURL}}"
              ],
              "path": [
                "o",
                "google-oauth2",
                ""
              ],
              "query": [
                {
                  "key": "redirect_uri",
                  "value": "http://127.0.0.1:8000/api/v1/auth/o/google-oauth2/"
                }
              ]
            }
          },
          "response": []
        },
        {
          "name": "Authorize Google Login",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseURL}}/o/google-oauth2/?state= &code=",
              "host": [
                "{{baseURL}}"
              ],
              "path": [
                "o",
                "google-oauth2",
                ""
              ],
              "query": [
                {
                  "key": "state",
                  "value": " "
                },
                {
                  "key": "code",
                  "value": ""
                }
              ]
            }
          },
          "response": []
        }
      ],
      "description": "## Google OAuth\n\nThis folder contains endpoints for authenticating users via **Google OAuth 2.0** using the Djoser social auth integration.\n\n### Endpoints\n\n- **Initiate Google OAuth** – Redirects the user to Google's authentication page. Provide a `redirect_uri` pointing to your callback URL to begin the OAuth flow.\n    \n- **Complete Google OAuth** – Handles the callback from Google after the user grants permission. Exchanges the authorization `code` and `state` for an access token to authenticate the user in the system.\n    \n\n### Authentication\n\nNo prior authentication is required to initiate the flow. The `code` and `state` parameters in the callback request are provided automatically by Google after the user logs in.\n\n### Workflow\n\n1. Call the **Initiate Google OAuth** endpoint with your `redirect_uri` to get the Google login URL.\n    \n2. Redirect the user to that URL so they can log in with their Google account.\n    \n3. Google will redirect back to your `redirect_uri` with `code` and `state` query parameters.\n    \n4. Call the **Complete Google OAuth** endpoint with those parameters to receive an authentication token.\n    \n\n### Environment Setup\n\nEnsure `{{baseURL}}` is set in your active environment before running these requests."
    },
    {
      "name": "Registration",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              ""
            ],
            "type": "text/javascript",
            "packages": {},
            "requests": {}
          }
        },
        {
          "listen": "prerequest",
          "script": {
            "exec": [
              ""
            ],
            "type": "text/javascript",
            "packages": {},
            "requests": {}
          }
        }
      ],
      "request": {
        "method": "POST",
        "header": [],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "username",
              "value": "",
              "type": "text",
              "uuid": "5d077ef6-4a35-4a68-bdb9-c23b70c7d274",
              "description": "Add Unique Username"
            },
            {
              "key": "email",
              "value": "",
              "type": "text",
              "uuid": "8f63994a-7ea3-4091-a0f5-d54eb222d5c9",
              "description": "Add Unique and verified Email ( only Gmail is approved)"
            },
            {
              "key": "password",
              "value": "",
              "type": "text",
              "uuid": "205bce75-bd63-4a3d-8304-ac93fedd6ce2",
              "description": "Add unique and strong password(atleast 8 In length)"
            },
            {
              "key": "re_password",
              "value": "",
              "type": "text",
              "uuid": "2ec23331-9f24-4392-99c8-79fcf2f257b3",
              "description": "Retype Same password from above"
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/users/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "users",
            ""
          ]
        },
        "description": "Registers a new user account using the Djoser authentication framework for Django.\n\n**Method:** `POST`  \n**URL:** `{{baseURL}}/users/`  \n**Body Type:** `multipart/form-data`\n\n### Required Fields\n\n| Field | Description |\n|---|---|\n| `username` | The desired username for the new account |\n| `email` | The user's email address |\n| `password` | The account password |\n| `re_password` | Password confirmation (must match `password`) |\n\n### Notes\n- Both `password` and `re_password` must match for successful registration.\n- On success, the API returns the newly created user's details with a `201 Created` response.\n- Passwords must meet the configured Django password validation requirements."
      },
      "response": []
    },
    {
      "name": "Account Activation",
      "request": {
        "method": "POST",
        "header": [],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "uid",
              "value": "",
              "type": "text",
              "uuid": "04767fa0-9bef-4bdd-9a0d-ae5aff811b33"
            },
            {
              "key": "token",
              "value": "",
              "type": "text",
              "uuid": "6d294332-388f-4bc4-a9b9-b2bbc9441b3b"
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/users/activation/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "users",
            "activation",
            ""
          ]
        }
      },
      "response": []
    },
    {
      "name": "Login",
      "request": {
        "method": "POST",
        "header": [],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "email",
              "value": "",
              "type": "text",
              "uuid": "081f508c-0d24-4a0a-b3fd-83c985e9e186",
              "description": "email you registered"
            },
            {
              "key": "password",
              "value": "",
              "type": "text",
              "uuid": "901f3ee6-8fea-47c4-8eee-1ad0b184a742",
              "description": "password"
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/jwt/create/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "jwt",
            "create",
            ""
          ]
        }
      },
      "response": []
    },
    {
      "name": "Logout",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "",
            "description": "JWT <access>",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "refresh",
              "value": "",
              "type": "text",
              "uuid": "1d12e4f6-672b-456f-a85c-b6f15e700420",
              "description": "<refresh>"
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/logout/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "logout",
            ""
          ]
        },
        "description": "Need Header(Authorization) and body (refresh)"
      },
      "response": []
    },
    {
      "name": "New Access Token (Refresh)",
      "request": {
        "method": "POST",
        "header": [],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "refresh",
              "value": "",
              "type": "text",
              "uuid": "275fde07-1e2e-4548-b9a3-b6f9054850e6",
              "description": "<refresh>"
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/jwt/refresh/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "jwt",
            "refresh",
            ""
          ]
        }
      },
      "response": []
    },
    {
      "name": "User Data",
      "protocolProfileBehavior": {
        "disableBodyPruning": true
      },
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "",
            "description": "JWT <access>",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": []
        },
        "url": {
          "raw": "{{baseURL}}/users/me/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "users",
            "me",
            ""
          ]
        },
        "description": "Need Header(Authorization)"
      },
      "response": []
    },
    {
      "name": "Chanage User Data",
      "request": {
        "auth": {
          "type": "bearer"
        },
        "method": "PUT",
        "header": [
          {
            "key": "Authorization",
            "value": "",
            "description": "JWT <access>",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "username ",
              "value": "LamsalSushank2",
              "type": "text",
              "uuid": "b893af02-c064-4ec4-a27e-528cdc634216"
            },
            {
              "key": "email",
              "value": "lamsal@gmail.com",
              "type": "text",
              "uuid": "11b25aee-4847-413f-be2d-c1e3a55df53c",
              "disabled": true
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/users/me/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "users",
            "me",
            ""
          ]
        },
        "description": "Need Header(Authorization) and body(what to nchange for eg, username)"
      },
      "response": []
    },
    {
      "name": "Change Password after login",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "",
            "description": "JWT <access>",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "new_password",
              "value": "",
              "type": "text",
              "uuid": "cb901238-e1e3-4760-aa08-15ad922c2a7f"
            },
            {
              "key": "re_new_password",
              "value": "",
              "type": "text",
              "uuid": "6e0a9c66-a7a4-4ae4-974e-b2787369b157"
            },
            {
              "key": "current_password",
              "value": "",
              "type": "text",
              "uuid": "064764f0-73c4-4768-b017-5c4a3b3322e7"
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/users/set_password/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "users",
            "set_password",
            ""
          ]
        },
        "description": "Need Header(Authorization) and body"
      },
      "response": []
    },
    {
      "name": "Reset Password Email",
      "request": {
        "method": "POST",
        "header": [],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "email",
              "value": "",
              "type": "text",
              "uuid": "215e0ad7-0f4f-4104-bb3f-692169c9514d",
              "description": "email (registered) "
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/users/reset_password/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "users",
            "reset_password",
            ""
          ]
        }
      },
      "response": []
    },
    {
      "name": "Reset Password Confirmation",
      "request": {
        "method": "POST",
        "header": [],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "uid",
              "value": "",
              "type": "text",
              "uuid": "e9aec57a-8e17-4bd3-90fa-ddfaab2cd5ea"
            },
            {
              "key": "token",
              "value": "",
              "type": "text",
              "uuid": "186a23d1-dfdb-48f7-a8c7-b469dbf53a8e"
            },
            {
              "key": "new_password",
              "value": "",
              "type": "text",
              "uuid": "b6e41e4a-8480-492d-9eb5-7db86d3ddf5d"
            },
            {
              "key": "re_new_password",
              "value": "",
              "type": "text",
              "uuid": "31650c8d-0904-4385-9a18-b95903682e7e"
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/users/reset_password_confirm/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "users",
            "reset_password_confirm",
            ""
          ]
        }
      },
      "response": []
    },
    {
      "name": "Delete Account",
      "request": {
        "method": "DELETE",
        "header": [
          {
            "key": "Authorization",
            "value": "",
            "description": "JWT <access>",
            "type": "text"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "current_password",
              "value": "",
              "type": "text",
              "uuid": "50a5c527-099f-44a6-8c79-31168e5617ef",
              "description": "password required"
            }
          ]
        },
        "url": {
          "raw": "{{baseURL}}/users/me/",
          "host": [
            "{{baseURL}}"
          ],
          "path": [
            "users",
            "me",
            ""
          ]
        },
        "description": "Need Header(Authorization) and body"
      },
      "response": []
    }
  ],
  "variable": [
    {
      "key": "baseURL",
      "value": "",
      "type": "default"
    }
  ]
}