Skip to content

Create Order From Simulation Result ​

API Information ​

  • Request Path: /market/order/programming/createFromSimulation
  • Request Method: POST
  • Content-Type: application/json

Request Headers ​

ParameterTypeRequiredDescription
AuthorizationStringYesUser authentication token
Content-TypeStringYesMust be set to application/json

Request Body Structure ​

FieldTypeRequiredDescriptionConstraints
resultIdLongYesSimulation result record idmarket_programming_simulation_result.id from simulation results API
outputFolderIdLongNoOutput folder ID-
ossOutputIdLongNoExisting object storage output config IDIf provided together with ossOutput, this field takes precedence
ossOutputObjectNoNew object storage output config-
recurringBooleanNoCreate recurring parent order with first child orderdefault false
recurringDayIntegerNoRecurring interval valueRequired when recurring=true, must be > 0
recurringUnitIntegerNoRecurring interval unitRequired when recurring=true; 1=Day, 2=Week, 3=Month

OssOutputPayload Structure (ossOutput) ​

FieldTypeRequiredDescriptionConstraints
nameStringNoConfig name-
endPointStringNoEndpoint-
akStringNoAccess key-
skStringNoSecret key-
accessPathStringNoBase access path-

Request Body Example ​

json
{
  "resultId": 123,
  "recurring": false
}

Response Body Structure ​

CommonResponse Object ​

FieldTypeDescription
codeIntegerResponse status code
messageStringResponse message
dataOrderCreateRespResponse data

OrderCreateResp Object ​

FieldTypeDescription
orderNoStringCreated order number

Response Examples ​

Success Response ​

json
{
  "code": 200,
  "message": "success",
  "data": {
    "orderNo": "cff09baa-6bf3-4dc7-98f2-9becd771f1e3"
  }
}

Failure Response ​

json
{
  "code": 400,
  "message": "Simulation result not found or already used",
  "data": null
}

Error Code Description ​

Error CodeDescription
200Success
400Request parameter error or result invalid
401Unauthorized
500Server internal error

Usage Instructions ​

  1. This API creates a programming order from a single simulation result plan
  2. User authentication is required
  3. Obtain resultId from the simulation results API (/market/order/programming/simulation/results) response content[].id
  4. If recurring=true, recurringDay and recurringUnit are required
  5. The simulation task must be in success status before creating order from its result

Notes ​

  • One resultId corresponds to one programming order
  • To order multiple plans, call this API multiple times with different resultIds