Skip to content

MOGU Public API (1.0.0)

Public API for managing trips and catalogs in the MOGU platform

Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL
https://moguplatform.com
MOGU Support
support@moguplatform.com
License
Proprietary
Languages
Servers
Mock server
https://api-docs.moguplatform.com/_mock/openapi/
Production server
https://trips.api.moguplatform.com/

trips

Operations for managing trips

Operations

catalogs

Operations for managing catalogs

Operations

Get catalogs

Request

Retrieve a paginated list of catalogs

Security
bearerAuth
Query
pageinteger

Page number

Example: page=1
pageSizeinteger

Items per page

Example: pageSize=20
filtersstring

JSON array of filters

Example: filters=[]
orderBystring

JSON object for sorting

Example: orderBy={"field":"title","direction":"asc"}
searchstring

JSON object for searching

Example: search={"fields":["title"],"term":"Europe"}
curl -i -X GET \
  'https://api-docs.moguplatform.com/_mock/openapi/catalogs?page=1&pageSize=20&filters=%5B%5D&orderBy={%22field%22%3A%22title%22%2C%22direction%22%3A%22asc%22}&search={%22fields%22%3A%5B%22title%22%5D%2C%22term%22%3A%22Europe%22}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful response with paginated catalogs

Bodyapplication/json
object
Response
application/json
{}

Create catalog

Request

Create a new catalog with the specified details

Security
bearerAuth
Bodyapplication/jsonrequired
titlestringrequired
Example: "European Tours"
descriptionstring
Example: "Collection of our best European tours"
filtersobject
logoUrlstring(uri)
Example: "https://example.com/catalog-logo.png"
tripIdsArray of integers
Example: [12345,12346]
curl -i -X POST \
  https://api-docs.moguplatform.com/_mock/openapi/catalogs \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "European Tours",
    "description": "Collection of our best European tours",
    "filters": {
      "country": true
    },
    "logoUrl": "https://example.com/catalog-logo.png",
    "tripIds": [
      12345,
      12346
    ]
  }'

Responses

Catalog created successfully

Delete catalogs in bulk

Request

Delete multiple catalogs at once

Security
bearerAuth
Bodyapplication/jsonrequired
catalogIdsArray of integersrequired
Example: [101,102,103]
curl -i -X DELETE \
  https://api-docs.moguplatform.com/_mock/openapi/catalogs \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "catalogIds": [
      101,
      102,
      103
    ]
  }'

Responses

Catalogs deleted successfully

Get catalog

Request

Retrieve detailed information about a specific catalog

Security
bearerAuth
Path
idintegerrequired

Unique identifier of the catalog

Example: 101
curl -i -X GET \
  https://api-docs.moguplatform.com/_mock/openapi/catalogs/101 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Catalog details

Bodyapplication/json
object
Response
application/json
{}

Update catalog

Request

Update catalog details and associated trips

Security
bearerAuth
Path
idintegerrequired

Unique identifier of the catalog

Example: 101
Bodyapplication/jsonrequired
titlestring
Example: "Updated European Tours"
descriptionstring
Example: "Updated collection description"
tripIdsArray of integers
Example: [12345,12346,12347]
curl -i -X PATCH \
  https://api-docs.moguplatform.com/_mock/openapi/catalogs/101 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Updated European Tours",
    "description": "Updated collection description",
    "tripIds": [
      12345,
      12346,
      12347
    ]
  }'

Responses

Catalog updated successfully

Delete catalog

Request

Delete a specific catalog by ID

Security
bearerAuth
Path
idintegerrequired

Unique identifier of the catalog

Example: 101
curl -i -X DELETE \
  https://api-docs.moguplatform.com/_mock/openapi/catalogs/101 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Catalog deleted successfully

Get trips in catalog

Request

Retrieve all trips associated with a specific catalog

Security
bearerAuth
Path
idintegerrequired

Unique identifier of the catalog

Example: 101
Query
filtersstring

JSON array of filters

Example: filters=[]
curl -i -X GET \
  'https://api-docs.moguplatform.com/_mock/openapi/catalogs/101/trips?filters=%5B%5D' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of trips in the catalog

Bodyapplication/json
object
Response
application/json
{}

Get public catalog

Request

Retrieve a publicly accessible catalog by ID

Path
idintegerrequired

Unique identifier of the catalog

Example: 101
Query
filtersstring

JSON array of filters

Example: filters=[]
curl -i -X GET \
  'https://api-docs.moguplatform.com/_mock/openapi/catalogs/public/101?filters=%5B%5D'

Responses

Public catalog details

Bodyapplication/json
object
Response
application/json
{}

status

API health check

Operations