HyperSKU
HyperSKU
  1. Authentication
  • HyperSKU
    • Authentication
      • getToken
        POST
      • accessToken
        POST
      • refreshToken
        POST
    • Orders
      • createOrderFromExternal
      • getOrdersByExternalOrderId
      • create
      • getOrdersStatus
      • updateOrderAddress
      • getStockOrderInfo
      • cancelOrder
      • listOrderByStoreOrderId
    • Product
      • getPrivateProduct
      • getProductInfo
    • Logistics
      • getCountryCode
      • getLogisticsSku
      • /internationalLogisticsInfo/{storeOrderId}
    • Schemas
      • LoginReqDto
      • CountryCodeReponseDto
      • LoginResDto
      • CustomerInventoryDto
      • CreateOrderRequestVo
      • OAuth2AccesTokenReq
      • GetOrderRequestVo
      • InternationalLogisticsInfo
      • OAuth2RefreshTokenReq
      • LogisticsDetailDto
      • OAuth2TokenVo
      • LogisticsReponseDto
      • LogisticsRequestDto
      • LogisticsResult
      • ObjectRestResponse
      • ObjectRestResponse«LogisticsResult»
      • ObjectRestResponse«OrderAddressInfo»
      • ObjectRestResponse«OrderResult»
      • ObjectRestResponse«OrderStatusInfo»
      • OrderAddressInfo
      • OrderBaseInfo
      • OrderCreateResponse
      • OrderInventoryHistoryDto
      • OrderInventoryResult
      • OrderItemInfo
      • OrderLineItemVo
      • OrderResult
      • OrderStatusInfo
      • OrdersGoodsDto
      • OrdersInfoDto
      • OrdersLogisticsDto
      • OrdersLogisticsTrackInfoVo
      • OrdersLogisticsTrackVo
      • OrdersShipGoodsAliVo
      • OrdersStatusDto
      • OrdersStatusResDto
      • ProductInfoDto
      • RegionCodeDto
      • ShippingAddressDto
      • ShippingAddressVo
      • SkuAttributesDto
      • SkuInfoDto
      • SkuItemDto
      • TableData«OrderInventoryResult»
      • TableData«OrderResult»
      • TableData«ProductInfoDto»
      • TableResultResponse«OrderInventoryResult»
      • TableResultResponse«OrderResult»
      • TableResultResponse«ProductInfoDto»
  1. Authentication

accessToken

POST
/admin/token/access_token

Step 1: Application Registration#

Before starting the authorization flow, you must register your application with the platform.
Submission Requirements:
Provide a 110 x 110 px image (Application Logo).
Provide the Callback URL (Redirect URI).
Credentials Issued: Upon registration, the platform will generate the following for your app:
Client ID (clientId): The unique identifier for your application.
Client Secret (clientSecret): Used to authenticate your app when exchanging the authorization code for a token.

Step 2: Redirect to Authorization URL#

Initiate the OAuth flow by redirecting the user's browser to the platform's authorization endpoint.
Authorization URL: https://app.hypersku.com/application/auth
Request Parameters
ParameterRequiredDescription
clientIdYesYour application's API Key provided during registration.
scopeYesThe list of permissions requested (oms).
redirectUriYesThe callback address must exactly match the one provided to the platform during registration.
stateYesA randomly generated string to prevent CSRF attacks. Must be validated in Step 3.
Example URL:

Step 3: Request an Access Token#

After the user grants permission, the platform will redirect to your redirect_uri with a temporary code. Your backend must exchange this code for a permanent token.
Request Method: POST
Token Endpoint: https://api.hypersku.com/api/auth/admin/token/access_token

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
*/*
Success
Body*/*

🟢201
🟠401
🟠403
🟠404
⚪60025
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/auth/admin/token/access_token' \
--header 'Content-Type: application/json' \
--data '{
    "clientId": "string",
    "clientSecret": "string",
    "code": "string"
}'
Response Response Example
{
    "accessToken": "string",
    "expiresIn": 0,
    "refreshToken": "string",
    "refreshTokenExpireIn": 0,
    "scope": "string",
    "userId": "string"
}
Modified at 2026-05-26 02:41:03
Previous
getToken
Next
refreshToken
Built with