Sunsky API Integration

Technical guide for the Sunsky OpenAPI integration.

Overview

The module integrates with SUNSKY OpenAPI to provide:

Product catalog access
Real-time pricing
Stock availability
Order placement
Order tracking

API Credentials

Getting Credentials

Visit Sunsky Open Platform

Apply for API access

Wait for approval

Get your App Key and App Secret

Configuring Credentials

Go to Sunsky Store → Settings

Enter App Key and App Secret

Click Test Connection

Save settings

Signature Algorithm

All API requests are signed using MD5:

Add key parameter

Sort parameters by key name

Concatenate VALUES only

Append @ + secret

MD5 hash the result

// Example

$params = ['key' => 'abc', 'page' => '1'];
ksort($params);
$values = implode('', array_values($params)); // "abc1"
$signature = md5($values . '@' . $secret);

Available Endpoints

Endpoint	Purpose
category!getChildren.do	Get categories
product!search.do	Search products
product!getByItemNo.do	Product details
order!getCountries.do	Shipping countries
order!getPricesAndFreights.do	Calculate shipping
order!createOrder.do	Place order
order!getOrderList.do	List orders
order!getOrderDetails.do	Order details
order!getBalance.do	Account balance

Rate Limits

General: 100 requests/minute
Search: 30 requests/minute
Orders: 10 requests/minute

The module handles rate limiting automatically.

Error Handling

Common error codes:

Code	Meaning
1001	Invalid signature
1002	Invalid API key
2001	Product not found
3001	Invalid country
4001	Insufficient balance