# Endpoints

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

## Get Store Details

 - [POST /scm/shop/base/get](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/getstoredetails.md): This endpoint allows developer to request comprehensive store details, including:
1. 
2. : Includes both  (currently displayed) and  (pending approval)
3. 
4. : Latitude and longitude values
5. : the  for stores registered by merchants on the Keeta platform, structured into two tiers:  (main business focus) and  (supplementary services)
6. 
7. 
8. 


## Update Store Profile Image

 - [POST /scm/shop/picture/main/update](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/updatestoreprofileimage.md): Update Store Profile Image


1.  Images are displayed in store exposure contexts including search results pages, homepage recommendations, and store header banners to increase user visibility.
2.  Images must exceed 900×900 pixels in dimension and be under 5MB in file size. 
3.  Images should represent store quality and characteristics, featuring either high-quality signature dishes or brand logos (for locally renowned establishments).
4.  Image URLs must begin with http:// or https:// and end with .jpg, .png, .jpeg, or .webp extensions.
5.  Changes don't take effect immediately after API call; all modifications require approval review before activation.
6.  Keeta rejects duplicate requests when images are in "Pending Review" status.


## Update Store Contact Phone Number

 - [POST /scm/shop/contact/update](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/updatestorecontactphone.md): This endpoint allows updating a store's contact phone numbers.


1. The updated contact numbers will be displayed on the  to facilitate customer communication with the merchant.
2. The interface validates phone number quantity (: 1 phone number, : 3 phone numbers)
3. Phone numbers must follow the strict format: International Area Code - Mobile Number (e.g., 86-13800138000)


## Query Store Business Hours

 - [POST /scm/shop/business/hour/effective/get](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/querystorebusinesshours.md): This endpoint allows querying a store business hours.

## Update Store Business Hours

 - [POST /scm/shop/business/hour/effective/update](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/updatestorebusinesshours.md): This endpoint allows updating a store's business hours.


1. To indicate a full-day closure, set both startTime and endTime to 0 in the BusinessHourDTO structure for that day.
2. Within the businessHourOfTheWeek field, business hours must not overlap for any single day.


## Suspend Store

 - [POST /scm/shop/status/rest](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/suspendstore.md): Use this endpoint to suspend store operations. Suspended stores remain hidden from customers until manually reactivated.

## Store Reactivation

 - [POST /scm/shop/status/open](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/reactivatestore.md): This endpoint reactivates suspended stores, transitioning them from a non-operational state back to operational status for order acceptance and customer visibility.

## Query Special Business Hours

 - [POST /scm/shop/special/business/hour/effective/get](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/queryspecialbusinesshours.md): This endpoint retrieves a store's currently active special business hours, which temporarily override regular operating hours for specific dates (e.g., holidays, events).


1. Special business hours refer to temporarily adjusted operating schedules for stores on specific dates, such as holidays, special events, or operational changes that differ from regular weekly hours
2. When configured, these hours automatically override standard schedules during their effective period and seamlessly revert to normal hours after expiration without manual intervention, ensuring continuous and accurate operational information.


## Update Special Business Hours

 - [POST /scm/shop/special/business/hour/effective/update](https://api-docs.mykeeta.com/apis/standard/shop/endpoints/updatespecialbusinesshours.md): This endpoint updates a store's special business hours, enforcing non-overlapping date ranges and supporting full-day closures or complete configuration clearance.


1. Multiple SpecialBusinessHourDTO entries must have non-overlapping date ranges (startDate to endDate) to prevent scheduling conflicts and ensure operational clarity.
2. To indicate 24-hour closure during a period, submit one SpecialBusinessHourDTO with startTime=0 and endTime=0.
3. To completely clear all special business hours configurations, set the specialBusinessHour field to either null or an empty array [] in your request payload.