TOtonewow
banners

Upload a new banner

Upload a new banner with image file. Any authenticated user can upload, but requires admin approval to activate.

post/banner/upload

Request

  • Base URL
    https://api.tonewow.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.tonewow.com/banner/upload
  • Auth
    HTTP bearer

Request body multipart/form-data

bannerImageUrlstring binary required

Banner image file

bannerUrlstring required

Landing page URL

order_idstring

Display order

startDatestring date-time required

Start date (ISO 8601)

endDatestring date-time required

End date (ISO 8601)

languageType'BM' | 'EN' required

Language type

Example request

{
  "bannerUrl": "https://example.com/landing",
  "order_id": "1",
  "startDate": "2024-01-01T00:00:00.000Z",
  "endDate": "2024-12-31T23:59:59.000Z",
  "languageType": "EN"
}

Response

Banner uploaded successfully (pending approval)

idnumber required

Banner ID

bannerImageUrlstring required

Banner image URL

bannerUrlstring

Landing page URL

status'ACTIVE' | 'DEACTIVE' | 'PENDING_APPROVE' required

Banner status

order_idstring required

Display order

start_datestring date-time

Start date

end_datestring date-time

End date

languageType'BM' | 'EN' required

Language type

Example response

{
  "id": 1,
  "bannerImageUrl": "https://example.com/banner.jpg",
  "bannerUrl": "https://example.com/landing",
  "status": "ACTIVE",
  "order_id": "1",
  "start_date": "2024-01-01T00:00:00.000Z",
  "end_date": "2024-12-31T23:59:59.000Z",
  "languageType": "EN"
}

Changes

No recorded changes to this operation across all 6 revisions of this API.