Create order - Geckodistribution API

Request

Header Params

version

string

required

接口版本号

Default:

token

string

required

接口Token

Default:

Body Params application/json

List of items added to the shopping cart.

array of:

platform

integer <int32>

required

Derived from the 'platform' parameter in the product model, which defaults to 0 if not assigned.

Example:

0

productid

string

required

The product identifier of the item to be purchased, this parameter is taken from the 'productid' parameter of the product model.

Example:

590853024394

skudatalist

array[object (OpenSkudataAo) {2}]

required

List of SKUs to be purchased.

>= 1 items

skuid

string

required

SKU number of the item to be purchased, this parameter comes from the 'skuid' parameter of the product model.

Example:

4740865740043

qty

integer <int32>

required

Purchase quantity of the SKU.

>= 1

Example:

2

Example

[
    {
        "platform": 0,
        "productid": "590853024394",
        "skudatalist": [
            {
                "skuid": "4740865740043",
                "qty": 2
            }
        ]
    }
]

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://shopapi.geckodistribution.com/api/open/order/create' \
--header 'version;' \
--header 'token;' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "platform": 0,
        "productid": "590853024394",
        "skudatalist": [
            {
                "skuid": "4740865740043",
                "qty": 2
            }
        ]
    }
]'

Responses

🟢200Success

application/json

Body

status

enum<string>

required

Response status code, typically uses 0 to indicate no exceptions, and non-zero values to indicate the presence of exceptions.

Allowed values:

0500

Example:

0

message

string

required

Exception response message, this field usually has significance when the value of status is non-zero.

Example:

Operation successful.

data

object | null

optional

Response data.

success

array[object (OpenOrderCreateSuccessVo) {5}] | null

optional

List of successfully created orders.

failure

array[object (OpenOrderCreateFailureVo) {4}] | null

optional

List of orders that failed to be created.

Example

{
    "status": "0",
    "message": "Operation successful.",
    "data": {
        "success": [
            {
                "position": 1,
                "platform": 0,
                "productid": "590853024394",
                "message": "Order created successfully.",
                "ordernos": "170736519167627,170736529315528"
            }
        ],
        "failure": [
            {
                "position": 2,
                "platform": 0,
                "productid": "590853024394",
                "message": "Order creation failed."
            }
        ]
    }
}

🟢200Failure