پاسخ این endpoint باید به‌صورت زیر باشد:

• کد وضعیت: 200
• بدنه: {"message":Welcome to Medium API}

سه پارامتر username و password و email به این endpoint ارسال می‌شوند. درصورتی‌که حداقل یکی از پارامترهای username و password ارسال نشده باشد یا برابر با رشته‌ی خالی باشد، پاسخ باید به‌صورت زیر باشد:

هر دو پارامتر username و password خالی:

• کد وضعیت: 400
• بدنه:

{
	"error": {
		"username": ["This field may not be blank."],
		"password": ["This field may not be blank."],
        }
}

پارامتر username خالی:

• کد وضعیت: 400
• بدنه:

{
	"error": {
		"username": ["This field may not be blank."]
        }
}

پارامتر password خالی:

• کد وضعیت: 400
• بدنه:

{
	"error": {
		"password": ["This field may not be blank."]
        }
}

اگر کاربری با نام کاربری واردشده، از قبل موجود باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه:

{
	"error": {
		"username": ["A user with that username already exists."],
        }
}

در غیر این صورت، کاربر باید ساخته شود، یک توکن یکتا برایش تولید شود و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 201
• بدنه:

{
	"refresh": "[REFRESH_TOKEN]",
	"access": "[ACCESS_TOKEN]",
}

دو پارامتر username و password باید به این endpoint ارسال شوند. درصورتی‌که حداقل یکی از این پارامترها ارسال نشده باشد یا برابر با رشته‌ی خالی باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 401
• بدنه: {"error": "Invalid credentials"}

اگر نام کاربری یا رمز عبور نادرست باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 401
• بدنه: {"error": "Invalid credentials"}

در غیر این صورت، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 200
• بدنه:

{
	"refresh": "[REFRESH_TOKEN]",
	"access": "[ACCESS_TOKEN]",
}

تنها پارامتر refresh باید به این endpoint ارسال شود. درصورتی‌که این پارامتر ارسال نشده باشد یا برابر با رشته‌ی خالی باشد یا حتی مقدار درستی نداشته باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه: {}

در غیر این صورت، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 205
• بدنه: {}

این endpoint نیازمند authentication نیست.

نیازی به ارسال هیچ پارامتری به این endpoint نیست و در همه‌ی حالات باید جواب برابر با مقدار زیر باشد:

• کد وضعیت: 200
• بدنه:

[
	{
		"id": "[BLOG_ID]",
		"title": "[BLOG_TITLE]",
		"content": "[BLOG_CONTENT]",
		"views": "[BLOG_VIEWS]",
		"likes": "[BLOG_LIKES]",
	},
	...
]

بلاگ‌های برگردانده‌شده باید به ترتیب زمان ثبت بلاگ باشند.

این endpoint نیازمند authentication است. در ریکوئست ارسالی، مقدار هدر Authorization باید برابر با توکن کاربر باشد (توکن همواره همراه با Bearer ارسال می‌شود.).

پارامتر title و content باید به این endpoint ارسال شود. درصورتی‌که یکی از این پارامترها ارسال نشده باشد یا برابر با رشته‌ی خالی باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه:

{
	"error": {
		"title": ["This field may not be blank."],
		"content": ["This field may not be blank."],
        }
}

در غیر این صورت، بلاگ باید ثبت شود و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 201
• بدنه:

{
	"id": "[BLOG_ID]",
	"title": "[BLOG_TITLE]",
	"content": "[BLOG_CONTENT]",
	"views": "[BLOG_VIEWS]",
	"likes": "[BLOG_LIKES]",
}

این endpoint نیازمند authentication است. در ریکوئست ارسالی مقدار هدر Authorization باید برابر با توکن کاربر باشد (توکن همواره همراه با Bearer ارسال می‌شود.).

پارامتر title و content باید به این endpoint ارسال شود. درصورتی‌که یکی از این پارامترها ارسال نشده باشد یا برابر با رشته‌ی خالی باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه:

{
	"error": {
		"title": ["This field may not be blank."],
		"content": ["This field may not be blank."],
        }
}

درصورتی‌که pk موجود در URL در دیتابیس وجود نداشته باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 404
• بدنه: {}

درصورتی‌که کاربر ارسال‌کننده‌ی ریکوئست برابر با نویسنده‌ی بلاگ نباشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 403
• بدنه: {}

در غیر این صورت، بلاگ باید آپدیت شود و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 200
• بدنه:

{
	"id": "[BLOG_ID]",
	"title": "[BLOG_TITLE]",
	"content": "[BLOG_CONTENT]",
	"views": "[BLOG_VIEWS]",
	"likes": "[BLOG_LIKES]",
}

این endpoint نیازمند authentication است. در ریکوئست ارسالی مقدار هدر Authorization باید برابر با توکن کاربر باشد (توکن همواره همراه با Bearer ارسال می‌شود.).

پارامتری به این endpoint ارسال نمی‌شود. در صورتی که pk موجود در URL در دیتابیس وجود نداشته باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 404
• بدنه: {}

در صورتی که کاربر ارسال‌کننده‌ی ریکوئست برابر با نویسنده بلاگ نباشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 403
• بدنه: {}

در غیر این صورت، بلاگ باید حذف شود و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 204
• بدنه: {}

این endpoint نیازمند authentication نیست.

نیازی به ارسال هیچ پارامتری به این endpoint نیست. در همه‌ی حالات، پاسخ باید برابر با مقادیر زیر باشد:

درصورتی‌که pk موجود در URL در دیتابیس وجود نداشته باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 404
• بدنه: {}

در غیر این‌صورت، بلاگ باید ثبت شود و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 200
• بدنه:

{
	"id": "[BLOG_ID]",
	"title": "[BLOG_TITLE]",
	"content": "[BLOG_CONTENT]",
	"views": "[BLOG_VIEWS]",
	"likes": "[BLOG_LIKES]",
}

توجه داشته باشید که درصورتی‌که بلاگ موردنظر وجود داشت و کاربر بدون مشکل می‌توانست آن را مشاهده کند، باید به مقدار viewی بلاگ، یک واحد اضافه کنید و سپس بلاگ را برگردانید. یعنی بازدید فعلی کاربر در میزان بازدید‌های بلاگ برگردانده‌شده باید محاسبه شده باشد.

نکته‌ی ریت لیمیت: در این‌جا نیاز به پیاده‌سازی سازوکاری برای ریت لیمیت داریم. می‌خواهیم هر device_id و ip بتواند تنها 10 بار هر بلاگ را ببیند تا میزان ویو‌های هر بلاگ، شهودی واقعی از میزان دیده‌شدن بلاگ بدهد. تا 10 ریکوئست برای گرفتن یک بلاگ از یک device_id و ip را بدون مشکل باز گردانید و مقدار ویوی بلاگ را هم اضافه کنید. به محض عبور از 10 نیاز است که پاسخ برابر زیر باشد و به مقدار ویوی بلاگ هیچ عددی اضافه نشود.

• کد وضعیت: 429
• بدنه: {}

این endpoint نیازمند authentication است. در ریکوئست ارسالی مقدار هدر Authorization باید برابر با توکن کاربر باشد (توکن همواره همراه با Bearer ارسال می‌شود.).

پارامتری به این endpoint ارسال نمی‌شود. درصورتی‌که pk موجود در URL در دیتابیس وجود نداشته باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 404
• بدنه: {}

درصورتی‌که توکن Authorization وجود نداشت و در اصل یوزر لاگین نبود، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 401
• بدنه: {}

در غیر این صورت، باید یک عدد به لایک‌های بلاگ اضافه شود و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 200
• بدنه:

{
	"id": "[BLOG_ID]",
	"title": "[BLOG_TITLE]",
	"content": "[BLOG_CONTENT]",
	"views": "[BLOG_VIEWS]",
	"likes": "[BLOG_LIKES]",
}

این endpoint نیازمند authentication است. در ریکوئست ارسالی مقدار هدر Authorization باید برابر با توکن کاربر باشد (توکن همواره همراه با Bearer ارسال می‌شود.).

درصورتی‌که توکن Authorization وجود نداشت و در اصل یوزر لاگین نبود، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 401
• بدنه: {}

در غیر این صورت، باید مجموع تمام view و likeهای تمام بلاگ‌های نویسنده را محاسبه کند و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 200
• بدنه:

{
	"total_views": "int",
	"total_likes": "int"
}