Create New Images Order

API Information

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

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	User authentication token
Content-Type	String	Yes	Must be set to application/json

Request Body Structure

Field	Type	Required	Description	Constraints
provider	String	Yes	Provider	value: changguang or tianyi, changguang represents Optical, tianyi represents SAR
geometry	String	Yes	Geometry (WKT)	-
startDate	String	Yes	Start Time	yyyy-MM-dd HH:mm or yyyy-MM-ddTHH:mm:ss
endDate	String	Yes	End Time	yyyy-MM-dd HH:mm or yyyy-MM-ddTHH:mm:ss
recurring	Boolean	No	Is Recurring	-
recurringDay	Integer	No	Recurring Day	-
recurringUnit	Integer	No	Recurring Unit	1-Day, 2-Week, 3-Month
maxCloud	Integer	No	Max Cloud Cover	0-100
resolutionType	Integer	No	Resolution Type	1-3(changguang), 4-8(tianyi): 1-Super High(0.3m), 2-Very High(0.5m), 3-High(1m), 4-Spotlight SP(1m), 5-Stripmap SM(3m), 6-Narrow Scan NS(12m), 7-Narrow Scan Tops(12m), 8-Wide Scan ES(20m)

Request Body Example

{
  "provider": "changguang",
  "geometry": "{\"type\":\"Polygon\",\"coordinates\":[[[102.61282157031928,21.488503948497097],[106.99114976403081,21.488503948497097],[106.99114976403081,18.594746845159506],[102.61282157031928,18.594746845159506],[102.61282157031928,21.488503948497097]]]}",
  "startDate": "2023-10-27 10:00",
  "endDate": "2023-10-28 10:00",
  "recurring": false,
  "maxCloud": 20,
  "resolutionType": 1
}

Response Body Structure

CommonResponse Object

Field	Type	Description
code	Integer	Response status code
message	String	Response message
data	OrderCreateResp	Response data

OrderCreateResp Object

Field	Type	Description
orderNo	String	Created order number

Response Examples

Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "orderNo": "PROG_ORDER_202310270001"
  }
}

Failure Response

{
  "code": 400,
  "message": "Satellite not available",
  "data": null
}

Error Code Description

Error Code	Description
200	Success
400	Request parameter error
401	Unauthorized
500	Server internal error

Usage Instructions

1. This API is used to create a satellite programming order
2. User authentication is required
3. Specify satellite, time window and geometry

Notes

• Time window must be valid for the satellite