POST /api/product HTTP/1.1
Host: <API_HOST>
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "productName": "Wireless Headphones",
  "productDescription": "Bluetooth over-ear headphones",
  "sku": "WH-1001",
  "categoryId": [
    1
  ],
  "image": "<IMAGE_REFERENCE>",
  "price": "79.99",
  "quantity": 25,
  "status": 1,
  "productSlug": "wireless-headphones",
  "sortOrder": 1,
  "productAttribute": [],
  "productDiscount": [],
  "productSpecial": [],
  "tirePrices": []
}

{
  "status": 1,
  "message": "Resource created successfully",
  "data": {
    "productId": 1,
    "productName": "Wireless Headphones",
    "sku": "WH-1001",
    "price": "79.99",
    "quantity": 25,
    "status": 1
  }
}

{
  "status": 0,
  "message": "Invalid request or resource."
}

Products

Create or process Product

Post /api/product

Authentication: Vendor bearer token required for protected operations; verify exact permission decorator in controller.

Feature area: Products

Implementation source: src/api/vendor/controllers/ProductController.ts

Request example provenance: Source-defined core fields from AddProductRequest; optional arrays are empty for this example.

Response example provenance: Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema.

Example status: Illustrative. The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract.

POST

api

product

POST /api/product HTTP/1.1
Host: <API_HOST>
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "productName": "Wireless Headphones",
  "productDescription": "Bluetooth over-ear headphones",
  "sku": "WH-1001",
  "categoryId": [
    1
  ],
  "image": "<IMAGE_REFERENCE>",
  "price": "79.99",
  "quantity": 25,
  "status": 1,
  "productSlug": "wireless-headphones",
  "sortOrder": 1,
  "productAttribute": [],
  "productDiscount": [],
  "productSpecial": [],
  "tirePrices": []
}

{
  "status": 1,
  "message": "Resource created successfully",
  "data": {
    "productId": 1,
    "productName": "Wireless Headphones",
    "sku": "WH-1001",
    "price": "79.99",
    "quantity": 25,
    "status": 1
  }
}

{
  "status": 0,
  "message": "Invalid request or resource."
}

Authorizations

Authorization

string

header

required

Paste the JWT access token returned by the corresponding login endpoint.

Body

application/json

Sample request body. Source-defined core fields from AddProductRequest; optional arrays are empty for this example.

productName

string

productDescription

string

sku

string

categoryId

integer[]

image

string

price

string

quantity

integer

status

integer

productSlug

string

sortOrder

integer

productAttribute

any[]

productDiscount

any[]

productSpecial

any[]

tirePrices

any[]

Response

Successful response. Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema. Example is illustrative and does not guarantee a stable response contract.

status

integer

message

string

data

object

Show child attributes

Store API

Vendor API

Create or process Product

Authorizations

Body

Response