API Key & Notification Key的获取请通过Cube平台自助操作，详见说明文档

在线下单

开发中

Cube Prod

POST

https://api.linksfield.net/cube/v4/orders

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v2().order().placeOrder(PlaceOrder.builder(2)
.address("中国","上海","上海",
"闵行区",
"人民路21号中华老字号","亚洲中国上海市闵行区人民路21号中华老字号光明街路易大道北走500米","463000","发顺丰快递")
.accounting("CNY",1)
.consignee("京京","86","13567987906","5969789","0375","22456789045@qq.com")
.extra("此订单仅支持测试使用-uat@everybody！","订单可用")
.addItem("CP-6HPXSI4NTI6",7,300)
.build());

请求参数

Header 参数

Accept-Language

string

可选

默认，当header中无语言要求时，默认返回简体中文。当前支持zh-CN（简体中文）、en-US（英文）。/ Support : zh-CN 、 en-US

默认值:

zh-CN

Content-Type

string

可选

默认值:

application/json

Authorization

string

必需

LF {lfAccessKeyId}/{sign} 必填项

默认值:

X-LF-Api-Version

string

可选

默认值: 此最新版本。如最新版本为2.0，则默认1.0

X-LF-Signature-Type

string

1.0、2.0

可选

timestamp

string

必需

毫秒时间戳；只接受10分钟之内请求

nonce

integer

必需

随机正整数，取值范围：0-2147483647

Body 参数application/json

items

array [object {3}]

必需

string

必需

订单类型为1-新购单时，指产品ID/SKU。

quantity

integer

必需

订单类型1-新购单（卡+套餐）时，指SIM卡数量。

price

integer

必需

产品单价，必填。单位分

accounting

object | null

可选

currency

string

可选

货币代码 IOS 三位大写，默认CNY

pay_channel

integer

可选

支付方式；枚举值：1-后付账单；默认值1

contact

object

必需

name

string

收件人姓名

必需

string

联系邮箱

可选

mobile_no

string

必需

收件人手机号，如13552650314

mobile_area

string

电话国家代码

可选

tel_area

string

电话区号

可选

tel_code

string

电话号码

可选

extra

object | null

可选

string

外部系统订单ID

可选

remarks

string

订单备注

可选

notification_callback_url

string | null

可选

为空时，订单状态变更不做通知

delivery_address

object

收获地址

必需

district

string

区县

必需

province

string

省

必需

country

string

国家

必需

special_instructions

string

快递备注信息

可选

town

string

乡，镇，街，道

必需

zip

string

邮编

可选

city

string

市

必需

detail

string

详细地址

必需

示例

{
  "delivery_address": {
    "district": "闵行区",
    "province": "上海",
    "country": "中国",
    "special_instructions": "发顺丰快递",
    "town": "人民路21号中华老字号",
    "zip": "463000",
    "city": "上海",
    "detail": "亚洲中国上海市闵行区人民路21号中华老字号光明街路易大道北走500米"
  },
  "contact": {
    "mobile_area": "0375",
    "mobile_no": "5969789",
    "name": "李佳威",
    "email": "22456789045@qq.com",
    "tel_area": "86",
    "tel_code": "13567987906"
  },
  "callback": "http://localhost/mno-gateway/internal/callback",
  "extra": {
    "po": "此订单仅支持测试使用-uat@everybody！",
    "remarks": "订单可用"
  },
  "accounting": {
    "pay_channel": 1,
    "currency": "CNY"
  },
  "items": [
    {
      "price": 300,
      "id": "CP-6HPXSI4NTIL",
      "quantity": 2
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.linksfield.net/cube/v4/orders' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization;' \
--header 'X-LF-Api-Version;' \
--header 'X-LF-Signature-Type;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "delivery_address": {
        "district": "闵行区",
        "province": "上海",
        "country": "中国",
        "special_instructions": "发顺丰快递",
        "town": "人民路21号中华老字号",
        "zip": "463000",
        "city": "上海",
        "detail": "亚洲中国上海市闵行区人民路21号中华老字号光明街路易大道北走500米"
    },
    "contact": {
        "mobile_area": "0375",
        "mobile_no": "5969789",
        "name": "李佳威",
        "email": "22456789045@qq.com",
        "tel_area": "86",
        "tel_code": "13567987906"
    },
    "callback": "http://localhost/mno-gateway/internal/callback",
    "extra": {
        "po": "此订单仅支持测试使用-uat@everybody！",
        "remarks": "订单可用"
    },
    "accounting": {
        "pay_channel": 1,
        "currency": "CNY"
    },
    "items": [
        {       
            "price":300,
            "id": "CP-6HPXSI4NTIL",
            "quantity": 2
            
        }

    ]
}'

返回响应

🟢200成功

application/json

Body

data

object

必需

status

integer

可选

订单状态；1-已创建

created_at

integer

创建时间

可选

order_id

string

订单ID

可选

status

object

必需

code

string

必需

message

string

必需

detail

string

必需

示例

{
  "data": {
    "status": 1,
    "created_at": 1686707689000,
    "order_id": "OL-6XB9I9XX8QNR"
  },
  "status": {
    "code": "CB-00-0000",
    "message": "成功",
    "detail": "https://developer.linksfield.net/doc-1413557?nav=01GBM770ARR76AXBD5856Z6J6P"
  }
}

修改于 2023-06-29 01:20:01

获取覆盖地组合规格

查询订单

在线下单

SDK API 调用方式#

请求参数

示例代码

返回响应

SDK API 调用方式