Vedina Movies API Documentation

Overview

Vedina Movies is a comprehensive movie streaming platform API developed by Yousef Jafari for Vedina Co. This API provides endpoints for user management, movie browsing, favorites, watch history, subscription handling, payment processing, comments, and blog functionality.

Table of Contents

• Authentication
• API Endpoints
  • User Management
  • Movies
  • Favorites
  • Watch History
  • Subscription
  • Payment
  • Comments
  • Blog
• Version Info

Authentication

Most endpoints require a valid session token. Include the session token in the URL where :session is specified.

API Endpoints

User Management

Base URL: /users

Register New User

POST /users
Content-Type: application/json

{
  "name": "string",
  "email": "string",
  "phone": "string",
  "password": "string"
}

User Login

POST /users/login
Content-Type: application/json

{
  "user": "string",
  "password": "string"
}

Get User Profile

GET /users/:session

Update User Profile

PATCH /users/:session
Content-Type: application/json

{
  "name": "string",
  "email": "string",
  "phone": "string"
}

Reset Password

POST /users/reset-password
Content-Type: application/json

{
  "email": "string"
}

Change Password

POST /users/change-password/:session
Content-Type: application/json

{
  "password": "string"
}

OTP Operations

Send OTP:

GET /users/otp/send/:session

Verify OTP:

GET /users/otp/verify/:session?otp=123456

Movies

Base URL: /movies

Get All Movies

GET /movies?search=string&target=title&limit=15&page=1&sort=string&order=string&basic=true&imdb=number&dub=boolean&sub=boolean&years=string&genres=string&countries=string

Get Single Movie

GET /movies/:id?basic=false

Add Movie (Admin)

POST /movies
Content-Type: application/json

{
  // Movie details
}

Update Movie (Admin)

PUT /movies/:id
Content-Type: application/json

{
  // Updated movie details
}

Delete Movie (Admin)

DELETE /movies/:id

Favorites

Base URL: /favorites

Check if Movie is Favorited

GET /favorites/is/:session/:movie

Get User's Favorites

GET /favorites/:session

Add to Favorites

GET /favorites/add/:session/:movie

Remove from Favorites

GET /favorites/remove/:session/:movie

Watch History

Base URL: /watched

Check if Movie is Watched

GET /watched/is/:session/:movie

Get Watch History

GET /watched/:session

Add to Watch History

GET /watched/add/:session/:movie

Remove from Watch History

GET /watched/remove/:session/:movie

Subscription

Base URL: /subscription

Get Subscription Status

GET /subscription/:session

Add Subscription

GET /subscription/add/:session/:plan

Payment

Base URL: /pay

Start Payment

GET /pay/start/:session/:amount

Payment Callback

GET /pay/callback/:session?trackId=string

Comments

Base URL: /comments

Add Comment

POST /comments/:session/:movie
Content-Type: application/json

{
  "comment": "string"
}

Get Movie Comments

GET /comments/:movie

Blog

Base URL: /blog

Get Blog Categories

GET /blog/categories

Get All Blog Posts

GET /blog?limit=number&page=number&search=string&categoryId=string&sort=string&order=string

Get Single Blog Post

GET /blog/:id

Version Info

GET /version

Response Format

All endpoints return JSON responses in the following format:

{
  "status": "success",
  "data": {
    // Response data
  }
}

Error Handling

Errors are returned in the following format:

{
  "status": "error",
  "message": "Error message description"
}

Author

• Yousef Jafari

Company

• Vedina Co.

---

For additional support or inquiries, please contact Vedina Co. support team.