Skip to content
Menu/
/
Query products list

Keeta Menu Management API (v.1.0.0)

This API provides comprehensive menu management capabilities for Keeta platform integration, including menu synchronization, product status management, and real-time notifications.

Download OpenAPI description
menu.json
menu.yaml
Overview
Keeta Developer Website

https://developers.mykeeta.com/

Languages
Servers

https://open.mykeeta.com/api/open/

OpenItemCode-Based

Operations

Webhooks

Webhooks

KeetaID-Based

Operations

Query category attribute list

Request

  1. Get the category attribute list based on the final category ID, which is used for operations such as creating products.
  2. Since there is no backend category field for this period, the categoryId can be fixed to -1.

Rate limit: 50 QPS by appId dimension.

Bodyapplication/jsonrequired
shopIdinteger(int64)required

store id in KeeTa

Example: 25381
categoryIdinteger(int64)

KeeTa platform categoryId

Example: -1
curl -i -X POST \
  https://open.mykeeta.com/api/open/product/categoryproperty/list \
  -H 'Content-Type: application/json' \
  -d '{
    "shopId": 25381,
    "categoryId": -1
  }'

Responses

Successful returns category attribute list.

Bodyapplication/json
codeintegerrequired

A numeric status identifier indicating the result of the interface call, used to determine whether the operation executed successfully.

Enum ValueDescription
0

The request was executed successfully.

Non-zero value

The request execution failed. Specific error details can be viewed in the message field.

Example: 0
messagestringrequired

Text description corresponding to the status code, explaining the operation result or error cause to users.

Example: "Success"
dataArray of objects(CategoryProperty)

attributes related to the category

Response
application/json
{
  "code": 0,
  "message": "Success",
  "data": [
    { … }
  ]
}

Query products list

Request

  1. Get all valid products in store.

Rate limit: 50 QPS by appId dimension.

Bodyapplication/jsonrequired
shopIdinteger(int64)required

store id in KeeTa

Example: 25381
curl -i -X POST \
  https://open.mykeeta.com/api/open/product/spu/list \
  -H 'Content-Type: application/json' \
  -d '{
    "shopId": 25381
  }'

Responses

Successful returns product list.

Bodyapplication/json
codeintegerrequired

A numeric status identifier indicating the result of the interface call, used to determine whether the operation executed successfully.

Enum ValueDescription
0

The request was executed successfully.

Non-zero value

The request execution failed. Specific error details can be viewed in the message field.

Example: 0
messagestringrequired

Text description corresponding to the status code, explaining the operation result or error cause to users.

Example: "Success"
dataArray of objects(SPU)

Spu data model

Response
application/json
{
  "code": 0,
  "message": "Success",
  "data": [
    { … }
  ]
}

Query a specific product

Request

  1. Get a specific product info through ID, this is far more fast comparing to query products list.

Rate limit: 100 QPS by appId dimension.

Bodyapplication/jsonrequired
shopIdinteger(int64)required

store id in KeeTa

Example: 25381
spuIdinteger(int64)required

spuId in KeeTa

Example: 2
curl -i -X POST \
  https://open.mykeeta.com/api/open/product/spu/detail \
  -H 'Content-Type: application/json' \
  -d '{
    "shopId": 25381,
    "spuId": 2
  }'

Responses

Successful returns product detail.

Bodyapplication/json
codeintegerrequired

A numeric status identifier indicating the result of the interface call, used to determine whether the operation executed successfully.

Enum ValueDescription
0

The request was executed successfully.

Non-zero value

The request execution failed. Specific error details can be viewed in the message field.

Example: 0
messagestringrequired

Text description corresponding to the status code, explaining the operation result or error cause to users.

Example: "Success"
dataobject(SPU)
Response
application/json
{
  "code": 0,
  "message": "Success",
  "data": {
    "id": 12345,
    "name": "Spicy Chicken Burger",
    "sourceLanguageType": "en",
    "nameTranslation": "辣雞腿漢堡",
    "targetLanguageType": "zh-HK",
    "nameTranslateType": 1,
    "status": 1,
    "description": "Spicy Chicken Burger description",
    "descSourceLanguageType": "en",
    "descriptionTranslation": "辣雞腿漢堡描述",
    "descTargetLanguageType": "zh-HK",
    "descriptionTranslateType": 1,
    "shopCategoryList": [ … ],
    "pictureList": [ … ],
    "propertyList": [ … ],
    "skuList": [ … ],
    "availableTime": { … },
    "isSpecialty": 0,
    "openItemCode": "SPU#10001",
    "shopCategoryOpenItemCodeList": [ … ],
    "userGetModeList": [ … ]
  }
}

Product Picture

Operations