Linksfield Developer
OverviewCube APIs旧版本API
OverviewCube APIs旧版本API
  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
      • 同步使用中SIM卡信息/Get the SIM Cards in use
    • Usage
      • 查询单张SIM卡流量使用情况/ Example Query the traffic usage of a single SIM card
      • 批量查询SIM卡流量接口 /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
      • OTA日套餐下单/Order OTA Plan
      • 运营商侧剩余流量查询/Query the remaing data by MNO side
  • Notification
    • Notification全局说明
    • Notification状态码
    • 流量使用量API预警
      POST
    • 短信下行回调
      POST
    • 短信上行回调
      POST
    • 短信上行回调(区分文本二进制)
      POST
    • 订单状态变更回调(IMSI)
      POST
  • Mall APIs
    • Mall全局说明
    • Mall业务流程
    • Mall签名代码示例
    • APP调用Stripe的SDK示例说明
    • Vshop
      • 卡片登录验证
        POST
      • 获取可购套餐商品列表
        POST
      • 创建用户订单
        POST
      • 查询正在使用、未启用订单
        POST
      • 获取生效中的自动续费
        POST
      • 关闭自动续费
        POST
      • 用户下单(第三方支付)
        POST
    • Payment
      • 获取stripe单次支付权限
      • 获取Stripe订阅支付权限
      • 创建Stripe订阅/自动续费
      • 支付结果查询
    • Notification
      • 消息推送
  • eSIM QR Mall APIs
    • Introduction
    • Pre - order
    • webhook
    • 用户登录
    • My eSIM Detail
  1. Vshop

获取可购套餐商品列表

Cube UAT
https://api-uat.io.linksfield.net/cube/v4
Cube UAT
https://api-uat.io.linksfield.net/cube/v4
POST
/singleServicePlanPage

请求参数

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

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-uat.io.linksfield.net/cube/v4/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"
}'

返回响应

🟢200成功
application/json
Body
partnerCode
string 
渠道编码
必需
planList
array [object {8}] 
必需
企业方案对应的语言编码和语言名称,在之后的接口中languageCode很重要
languageCode
string 
可选
套餐商品语言:(0-中文;1-英文)
minOrderPeriod
string 
套餐最小订购周期
可选
packageCode
string 
可选
套餐商品关联的原始套餐编号
servicePlanCode
string 
套餐商品编号
可选
servicePlanDetailsDesc
string 
套餐商品详情
可选
servicePlanShortDesc
string 
套餐商品简介
可选
servicePlanShowName
string 
套餐商品名称
可选
specAndPriceList
array [object {12}] 
规格与价格
可选
示例
{
    "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"
            }
        ]
    }
}
修改于 2022-12-12 03:21:14
上一页
卡片登录验证
下一页
创建用户订单
Built with