Skip to content
/Webhooks

Keeta Store Management API (v.1.0.0)

This API provides comprehensive store management capabilities for Keeta platform integration.

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

https://developers.mykeeta.com/

Languages
Servers

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

Endpoints

Request APIs - All endpoints for requesting store information and making updates

Operations

Webhooks

Webhooks - Webhook notifications sent by Keeta to third-party systems

Webhooks

Store Business Hour Update NotificationWebhook

Request

Keeta pushes real-time notifications when either regular business hours or special business hours are modified.

Event ID: 1101

Notes: Both 'business hour' and 'special business hour' applied this endpoint for any updates.

Bodyapplication/jsonrequired
shopIdinteger(int64)

Store ID

Example: 466663
businessHourOfTheWeekobject

Updated business hour

Example: {"thu":[{"startTime":46800,"endTime":84600}],"tue":[{"startTime":46800,"endTime":84600}],"wed":[{"startTime":46800,"endTime":84600}],"sat":[{"startTime":46800,"endTime":84600}],"fri":[{"startTime":46800,"endTime":84600}],"mon":[{"startTime":46800,"endTime":84600}],"sun":[{"startTime":46800,"endTime":84600}]}
specialBusinessHourArray of objects(SpecialBusinessHourDTO)

Updated special business hour

application/json
{
  "shopId": 466663,
  "businessHourOfTheWeek": {
    "thu": [ … ],
    "tue": [ … ],
    "wed": [ … ],
    "sat": [ … ],
    "fri": [ … ],
    "mon": [ … ],
    "sun": [ … ]
  },
  "specialBusinessHour": [
    { … }
  ]
}

Responses

Request executed successfully

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"
Response
application/json
{
  "code": 0,
  "message": "Success"
}

Store Status Update NotificationWebhook

Request

Keeta pushes real-time notifications when a store's operational status changes, enabling immediate order availability updates based on status codes and business hours.

Event ID: 1102

Notes: A store accepts orders only when its status is 3 (Operating) and the current time falls within configured business hours; if the status is 4 (Suspended), orders are blocked immediately regardless of business hours.

Bodyapplication/jsonrequired
shopIdinteger(int64)

Store ID

Example: 466663
fromStatusinteger

Previous store status

Example: 4
toStatusinteger

New store status

Enum ValueDescription
3

Indicates the store is actively conducting business. Keeta will only permit order submissions when both conditions are satisfied, the status equals 3 and the current time falls within published operating hours.

4

represents a complete operational pause, automatically disabling all order placement capabilities regardless of scheduled business hours.

application/json
{
  "shopId": 466663,
  "fromStatus": 4,
  "toStatus": 3
}

Responses

Request executed successfully

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"
Response
application/json
{
  "code": 0,
  "message": "Success"
}