# 客户端提交搜索请求
POST /api/searches
Content-Type: application/json

{
  "query": "long running search criteria",
  "timeout": 3600
}

# 服务器响应
HTTP/1.1 202 Accepted
Location: /api/searches/12345/status
Retry-After: 10  # 建议10秒后重试

# 客户端轮询状态
GET /api/searches/12345/status

# 处理中响应
HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "processing",
  "progress": 45,
  "estimated_completion": "2023-05-20T15:30:00Z"
}

# 完成响应
HTTP/1.1 303 See Other
Location: /api/searches/12345/results

# 客户端提交搜索请求
POST /api/searches
Content-Type: application/json

{
  "query": "long running search criteria",
  "callback_url": "https://client.example.com/callbacks/search/123"
}

# 服务器响应
HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "search_id": "12345",
  "status_url": "/api/searches/12345/status"
}

# 服务器完成后回调
POST https://client.example.com/callbacks/search/123
Content-Type: application/json

{
  "search_id": "12345",
  "status": "completed",
  "results_url": "/api/searches/12345/results"
}