Linksfield Developer
OverviewCube APIsOld version
OverviewCube APIsOld version
  1. Vshop
  • CSSS APIs
    • Overview
    • Internationalization
    • Status code
    • Sign code Example
    • SIM
      • Get all SIM cards info
      • Get real-time info about one SIM card
      • Get the SIM Cards in use
    • Usage
      • Example Query the traffic usage of a single SIM card
      • Batch querying SIM card usage
      • Example Query the daily usage
      • Batch querying the usage in a specified month
    • Plan
      • Get data plan
      • Order data plan
      • Bulk order package
      • Renew your data plan
      • Query the package order information
      • To enable the order
      • Cancel an unenabled package order
      • End package orders early
      • [不推荐]停机/暂停流量套餐订单
      • [不推荐]复机/重新启动流量套餐订单
      • 【不推荐】分页批量(查询)同步设备可订购套餐
    • SMS
      • Send SMS
    • Customized
      • Order OTA Plan
      • Query the remaing data by MNO side
  • Notification
    • Notification Overview
    • Notification status code
    • 流量使用量API预警
      POST
    • 短信下行回调
      POST
    • 短信上行回调
      POST
    • 短信上行回调(区分文本二进制)
      POST
    • Plan Order Status Change notification (IMSI)
      POST
  • Mall APIs
    • Mall全局说明
    • Mall业务流程
    • Mall签名代码示例
    • APP调用Stripe的SDK示例说明
    • Vshop
      • 卡片登录验证
        POST
      • 获取可购套餐商品列表
        POST
      • 创建用户订单
        POST
      • 查询自动续费记录
        POST
      • 关闭自动续费
        POST
      • 查询正在使用、未启用订单
        POST
      • 获取生效中的自动续费
        POST
      • 关闭自动续费
        POST
      • 用户下单(第三方支付)
        POST
    • Payment
      • 获取stripe单次支付权限
      • 获取Stripe订阅支付权限
      • 创建Stripe订阅/自动续费
      • 支付结果查询
      • 支付结果确认
    • Notification
      • 消息推送
  • eSIM QR Mall APIs
    • Introduction
    • Pre - order
    • v1.1/payment/webhook
    • User login
    • My eSIM Detail
    • Pre - order v1.2
  1. Vshop

获取可购套餐商品列表

Demo UAT
http://127.0.0.1
Demo UAT
http://127.0.0.1
POST
/singleServicePlanPage

Request

Header Params
Content-Type
string 
optional
Default:
application/json
Body Params application/json
area
string 
required
所在区域:比如亚洲,欧洲直接传中文字。mark=1时此字段不可传空字符串;mark=0时此字段可传空字符串 ,
deviceCode
string 
required
用户设备设备码(iccid/imei号)
languageCode
string 
required
语言编码:0- 汉语(中文);1- 英语;2- 西班牙语;3- 法语4- 葡萄牙语;5- 印度语;6- 德语;7-日语;8- 韩语;9- 阿拉伯语;10-台湾繁中;11-港体繁中 ,
mark
string 
required
卡片归属标识:0-归属领科(当为此值时卡片需要通过领科企业卡片有效性的验证);1-不归属领科(当为此值时卡片不需要通过领科企业卡片有效性的验证);默认标识传0(归属领科),如果打开H5时携带此参数以实际为准。此字段不可传空字符串
partnerCode
string 
required
渠道编码
sign
string 
required
请求签名
terminal
string 
required
终端设备标识:0-移动终端;1-pc。此字段不可传空字符串 ,
tradeTime
string 
required
访问时间戳
tradeType
string 
required
接口名称
version
string 
required
接口版本,本次接口值为:3.0
Example
{
    "area": "欧洲",
    "deviceCode": "89852420180910340793",
    "languageCode": "1",
    "mark": "0",
    "partnerCode": "P000270",
    "sign": "3fdb15332726c77cd792ea2328f98a80",
    "terminal": "0",
    "tradeTime": "1645782486394",
    "tradeType": "singleServicePlanPage",
    "version": "3.0"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/singleServicePlanPage' \
--header 'Content-Type: application/json' \
--data-raw '{
    "area": "欧洲",
    "deviceCode": "89852420180910340793",
    "languageCode": "1",
    "mark": "0",
    "partnerCode": "P000270",
    "sign": "3fdb15332726c77cd792ea2328f98a80",
    "terminal": "0",
    "tradeTime": "1645782486394",
    "tradeType": "singleServicePlanPage",
    "version": "3.0"
}'

Responses

🟢200成功
application/json
Body
partnerCode
string 
required
渠道编码
planList
array [object {8}] 
required
企业方案对应的语言编码和语言名称,在之后的接口中languageCode很重要
languageCode
string 
optional
套餐商品语言:(0-中文;1-英文)
minOrderPeriod
string 
optional
套餐最小订购周期
packageCode
string 
optional
套餐商品关联的原始套餐编号
servicePlanCode
string 
optional
套餐商品编号
servicePlanDetailsDesc
string 
optional
套餐商品详情
servicePlanShortDesc
string 
optional
套餐商品简介
servicePlanShowName
string 
optional
套餐商品名称
specAndPriceList
array [object {12}] 
optional
规格与价格
Example
{
    "operateCode": "S",
    "message": "success",
    "data": {
        "partnerCode": "P000270",
        "planList": [
            {
                "packageCode": "DP20190726001274",
                "minOrderPeriod": "1",
                "servicePlanCode": "SP202011301327",
                "servicePlanShowName": "China Experience Service Plan",
                "servicePlanShortDesc": "China Experience Service Plan",
                "servicePlanDetailsDesc": "<p>Coverage: China</p>",
                "languageCode": "1",
                "specAndPriceList": [
                    {
                        "orderPeriod": "1",
                        "specifications": "1",
                        "autoRenewal": "1",
                        "packageType": "2",
                        "currency": "USD",
                        "currencySymbol": "$",
                        "originalPriceUSD": "100",
                        "discountPriceUSD": "1.02",
                        "originalPriceCNY": "80",
                        "discountPriceCNY": "6.01",
                        "saveCNY": "73.99",
                        "saveUSD": "98.98",
                        "specifiedNameLabel": "zidongxufeiaaa"
                    },
                    {
                        "orderPeriod": "1",
                        "specifications": "1",
                        "autoRenewal": "0",
                        "packageType": "2",
                        "currency": "USD",
                        "currencySymbol": "$",
                        "originalPriceUSD": "200",
                        "discountPriceUSD": "19.99",
                        "originalPriceCNY": "100",
                        "discountPriceCNY": "19.99",
                        "saveCNY": "80.01",
                        "saveUSD": "180.01",
                        "specifiedNameLabel": "niubidetaocanaaaaaaa"
                    },
                    {
                        "orderPeriod": "2",
                        "specifications": "2",
                        "autoRenewal": "0",
                        "packageType": "2",
                        "currency": "USD",
                        "currencySymbol": "$",
                        "discountPriceUSD": "11",
                        "discountPriceCNY": "11",
                        "specifiedNameLabel": "aaaaaaaaaaaaaaa1aaaa"
                    }
                ]
            },
            {
                "packageCode": "DP20190726001274",
                "minOrderPeriod": "1",
                "servicePlanCode": "SP202111041459",
                "servicePlanShowName": "biaoqianweikong",
                "servicePlanShortDesc": "test",
                "servicePlanDetailsDesc": "<p>test</p>",
                "languageCode": "1",
                "specAndPriceList": [
                    {
                        "orderPeriod": "1",
                        "specifications": "1",
                        "autoRenewal": "0",
                        "packageType": "2",
                        "currency": "GBP",
                        "currencySymbol": "£",
                        "originalPriceUSD": "32",
                        "discountPriceUSD": "12.36",
                        "originalPriceCNY": "32",
                        "discountPriceCNY": "12.36",
                        "saveCNY": "19.64",
                        "saveUSD": "19.64",
                        "specifiedNameLabel": ""
                    }
                ],
                "currencyId": "12",
                "currencySymbol": "£",
                "currency": "GBP"
            },
            {
                "packageCode": "DP20190726001274",
                "minOrderPeriod": "1",
                "servicePlanCode": "SP202111041458",
                "servicePlanShowName": "biaoqianceshi",
                "servicePlanShortDesc": "test",
                "servicePlanDetailsDesc": "<p>est</p>",
                "languageCode": "1",
                "specAndPriceList": [
                    {
                        "orderPeriod": "1",
                        "specifications": "1",
                        "autoRenewal": "0",
                        "packageType": "2",
                        "currency": "JPY",
                        "currencySymbol": "JP¥",
                        "originalPriceUSD": "1000",
                        "discountPriceUSD": "569",
                        "originalPriceCNY": "1000",
                        "discountPriceCNY": "569",
                        "saveCNY": "431.00",
                        "saveUSD": "431.00",
                        "specifiedNameLabel": "biaoqian123"
                    }
                ],
                "currencyId": "11",
                "currencySymbol": "JP¥",
                "currency": "JPY"
            }
        ]
    }
}
Modified at 2022-10-04 23:23:51
Previous
卡片登录验证
Next
创建用户订单
Built with