Paged Query Existing Images

API Information

• Request Path: /market/page/query
• 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	No	Provider name	value: changguang or tianyi, changguang represents Optical, tianyi represents SAR
startDate	String	No	Start date	-
endDate	String	No	End date	-
geometry	String	No	Geometry	-
productIds	List<String>	No	Product IDs	-
sensors	List<Integer>	No	Sensor types	-
pageNumber	int	Yes	Page number	-
pageSize	int	Yes	Page size	-
imageGsd	Integer	No	Image GSD	-
cloudPercent	Double	No	Cloud cover percentage	-

Request Body Example

{
  "provider": "tianyi",
  "startDate": "2023-01-01",
  "endDate": "2026-12-31",
  "geometry": "{\"type\":\"Polygon\",\"coordinates\":[[[102.61282157031928,21.488503948497097],[106.99114976403081,21.488503948497097],[106.99114976403081,18.594746845159506],[102.61282157031928,18.594746845159506],[102.61282157031928,21.488503948497097]]]}",
  "pageNumber": 1,
  "pageSize": 10,
  "imageGsd": 50,
  "cloudPercent": 20.0
}

Response Body Structure

CommonResponse Object

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

ImageListResp Object

Field	Type	Description
total	Long	Total count
content	List<ImageListRespItem>	Product list
timeItems	List<String>	Time items

ImageListRespItem Object

Field	Type	Description
id	Long	Product ID
productId	String	Product ID string
thumb	String	Thumbnail URL
name	String	Product name
resolution	String	Resolution
imageTime	String	Image acquisition time
minSize	BigDecimal	Minimum size
deliveryIn	BigDecimal	Delivery time
unitPrice	BigDecimal	Unit price
geometry	String	Geometry WKT
area	BigDecimal	Area size
amount	BigDecimal	Total amount
discount	BigDecimal	Discount rate
discountAmount	BigDecimal	Discounted amount
discountUnitPrice	BigDecimal	Discounted unit price
provider	String	Provider name
satelliteAngle	BigDecimal	Satellite angle
centerLongitude	BigDecimal	Center longitude
centerLatitude	BigDecimal	Center latitude

Response Examples

Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 100,
    "content": [
      {
        "id": 12345,
        "productId": "product_1",
        "provider": "tianyi",
        "thumb": "http://example.com/thumb.jpg",
        "name": "SAR Image",
        "resolution": "0.5m",
        "imageTime": "2023-06-15 12:00:00",
        "minSize": 25,
        "deliveryIn": 24,
        "unitPrice": 100.00,
        "geometry": "{\"type\":\"Polygon\",\"coordinates\":[[[102.6886899850927,20.21950658516742],[102.451897801616,20.16874196097035],[102.56974195534,19.67552515468356],[102.8057902075779,19.72608503057904],[102.6886899850927,20.21950658516742]]]}",
        "area": 50.5,
        "amount": 5050.00,
        "discount": 0.9,
        "discountAmount": 4545.00,
        "discountUnitPrice": 90.00,
        "satelliteAngle": 15.5,
        "centerLongitude": 120.5,
        "centerLatitude": 30.5
      }
    ],
    "timeItems": ["2023-06-15"]
  }
}

Failure Response

{
  "code": 400,
  "message": "Invalid date format",
  "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 query market products with pagination
2. User authentication is required
3. Supports filtering by date range, geometry, provider, etc.
4. Returns a paginated list of products

Notes

• Geometry should be in WKT format
• Date format should be YYYY-MM-DD