《地表覆盖遥感智能解译服务接口规范》（征求意见稿）

本文件面向地表覆盖遥感智能解译服务平台，规定图像分类、目标检测、语义分割、变化检测四类服务接口的格式、请求响应规则与调用约定，统一能力获取、处理描述、任务创建与执行、状态查询、结果获取、取消任务、任务列表等操作定义，供平台接口设计、开发与应用参照。接口基于HTTP 1.1及以上协议，经URI标识，以GET/POST传递参数，响应支持XML与JSON，图片资源支持PNG、JPEG。

接口框架与数据约定

服务接口按中文名、英文名、接口描述、请求参数、返回值、错误信息六项要素定义；英文名采用驼峰命名。参数名不区分大小写、参数值区分大小写、顺序不限；URI查询参数采用KVP编码，同名多值以逗号分隔。数据类型分简单、复杂、枚举三类，分别以名称含义默认值、属性表、基础类型与取值范围定义。

四类服务与任务操作

四类接口英文名分别为Classify、ObjectDetect、Segment、ChangeDetect，各自对应整幅图像类别判定、目标位置大小类别提取、像素级地物分类、多时相地表变化分析。每类接口均设GetCapabilities、DescribeProcess、CreateJob、ExecuteJob、GetStatus、GetResult、CancelJob、ListJobs操作；任务执行支持同步与异步两种调用模式，状态查询与结果获取仅对异步任务开放。

状态与错误处理

规范性附录明确错误码、任务状态及状态转换规则。错误码采用六位编码，10xxxx为客户端请求错误、20xxxx为服务端处理错误、30xxxx为任务执行错误，错误响应含错误码、错误消息、错误详情。状态转换遵循单向性与终态不变原则，CancelJob仅对QUEUED和RUNNING有效，对SUCCESS、ERROR等终态任务调用将报错；ListJobs对PageSize限定1至100。异步任务状态流转由服务端自动完成。