The Articles Management Backend API is a comprehensive and secure backend system built using Django REST Framework. It provides powerful tools for creating, managing, and interacting with articles while ensuring that user roles and permissions are strictly enforced through an advanced Role-Based Access Control (RBAC) system. This architecture ensures that Admins, Moderators, and End Users have clearly defined responsibilities and access levels, promoting security and efficiency.
\nThe API supports essential functionalities such as user registration, email verification via OTP, and JWT-based authentication. Registered users can explore articles, add comments, and request permission to contribute as authors. Moderators oversee user submissions and manage content like articles, comments, categories, and tags. Admins have full authority over system operations, including user role assignments and content moderation.
\nIn addition to robust role management, the system features advanced search and filtering capabilities for articles, comments, categories, and tags. It includes pagination for all item lists, ensuring smooth navigation through large datasets. The application also provides password reset functionality using OTP for enhanced user convenience.
\nDesigned for flexibility and scalability, this backend API is ideal for managing content-heavy platforms with multiple user roles and permissions, offering a secure and streamlined user experience.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"32119544","collectionId":"e5f24412-61e3-4137-bde2-5ec2c6253f37","publishedId":"2sAYBYfVbs","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-12-01T23:27:20.000Z"},"item":[{"name":"Registration","item":[{"name":"Register User","id":"ffdc72f3-92f1-487e-a6e8-69d921a92329","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"djdevharry@gmail.com\",\r\n \"first_name\": \"Test\",\r\n \"last_name\": \"User\",\r\n \"password\": \"testuser#123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/register/","urlObject":{"protocol":"http","port":"8000","path":["auth","register",""],"host":["127","0","0","1"],"query":[],"variable":[]}},"response":[{"id":"e5b958ab-afe4-478b-9c9f-6e35f72edb0d","name":"Successful Registration","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"djdevharry@gmail.com\",\r\n \"first_name\": \"Test\",\r\n \"last_name\": \"User\",\r\n \"password\": \"testuser#123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/register/"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:41:57 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"278"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Account created successfully. Please verify your email.\",\n \"data\": {\n \"uid\": \"9180d20e-4c72-4fbb-811d-6d92b2df2897\",\n \"email\": \"djdevharry@gmail.com\",\n \"first_name\": \"Test\",\n \"last_name\": \"User\",\n \"role\": \"user\",\n \"is_active\": false,\n \"is_staff\": false,\n \"is_superuser\": false\n }\n}"},{"id":"9153202b-79a8-4e85-8940-7aac972124e6","name":"Required Fields Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/register/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:34:42 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"183"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": {\n \"email\": [\n \"This field is required.\"\n ],\n \"first_name\": [\n \"This field is required.\"\n ],\n \"last_name\": [\n \"This field is required.\"\n ],\n \"password\": [\n \"This field is required.\"\n ]\n }\n}"},{"id":"72f7687d-cbb5-4003-9821-f4c3919ac419","name":"Email Already Exists Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"superadmin@gmail.com\",\r\n \"first_name\": \"Test\",\r\n \"last_name\": \"User\",\r\n \"password\": \"testuser#123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/register/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:36:20 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"90"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": {\n \"email\": [\n \"user model with this email address already exists.\"\n ]\n }\n}"}],"_postman_id":"ffdc72f3-92f1-487e-a6e8-69d921a92329"},{"name":"Verify OTP","id":"00fa03d9-dbc3-4225-9bd1-c46ee211c493","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"uid\": \"9180d20e-4c72-4fbb-811d-6d92b2df2897\",\r\n \"otp\": \"635336\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/verify-otp/","urlObject":{"protocol":"http","port":"8000","path":["auth","verify-otp",""],"host":["127","0","0","1"],"query":[],"variable":[]}},"response":[{"id":"2e2e2735-3de4-4f9d-80da-3d7871979d67","name":"Successful Verification","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"uid\": \"9180d20e-4c72-4fbb-811d-6d92b2df2897\",\r\n \"otp\": \"635336\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/verify-otp/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 21:01:26 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"60"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Account activated successfully.\"\n}"},{"id":"50c24ea1-3baa-4eff-b5ec-ae2cb9597a44","name":"Required Fields Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/verify-otp/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:44:22 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"53"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UID and OTP are required.\"\n}"},{"id":"f2e8d14e-e314-4b53-ab00-744b5ba0dc67","name":"Invalid UID Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"uid\": \"4c72-4fbb-811d-6d92b2df2897\",\r\n \"otp\": \"925163\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/verify-otp/"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:46:45 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"138"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Something went wrong. Please try again.\",\n \"error\": \"['“4c72-4fbb-811d-6d92b2df2897” is not a valid UUID.']\"\n}"},{"id":"475ae3a9-171e-415a-a319-196e4f37c970","name":"Invalid OTP Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"uid\": \"9180d20e-4c72-4fbb-811d-6d92b2df2897\",\r\n \"otp\": \"25163\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/verify-otp/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:47:25 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"58"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"Invalid OTP. Please try again.\"\n}"},{"id":"9dd71d5d-4716-49f1-9b9a-bbf0d5cf07d1","name":"Expired OTP Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"uid\": \"9180d20e-4c72-4fbb-811d-6d92b2df2897\",\r\n \"otp\": \"925163\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/verify-otp/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:55:12 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"80"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"The OTP has expired. Please request for another one.\"\n}"}],"_postman_id":"00fa03d9-dbc3-4225-9bd1-c46ee211c493"},{"name":"Resend OTP","id":"fee5a8fe-d507-40f5-8e0f-50c405628dd2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"djdevharry@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/resend-otp/","urlObject":{"protocol":"http","port":"8000","path":["auth","resend-otp",""],"host":["127","0","0","1"],"query":[],"variable":[]}},"response":[{"id":"9dbc266b-627a-4913-a6a6-5a5faae3691b","name":"Successful OTP Resending","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"djdevharry@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/resend-otp/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 21:00:15 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"81"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"OTP is sent to your registered email. Kindly verify.\"\n}"},{"id":"2fc9f77f-c433-4586-925c-29cad78c343a","name":"Required Field Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/resend-otp/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:56:42 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"94"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"['Please provide your registered email address for verification.']\"\n}"},{"id":"044ec97e-a498-4586-a84e-36b961f6ddba","name":"User Not Found Error","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"djdevharry123@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://127.0.0.1:8000/auth/resend-otp/"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2024 20:58:59 GMT"},{"key":"Server","value":"WSGIServer/0.2 CPython/3.12.4"},{"key":"Content-Type","value":"application/json"},{"key":"Vary","value":"Accept"},{"key":"Allow","value":"POST, OPTIONS"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Length","value":"65"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"same-origin"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"No UserModel matches the given query.\"\n}"}],"_postman_id":"fee5a8fe-d507-40f5-8e0f-50c405628dd2"},{"name":"Request To Write Articles","id":"f2f9e79d-30a4-4dfb-9eda-28f2cf614d49","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"