跳到主要内容

获取可用区域列表

在提交批量任务时，可以通过 regionCode 参数指定节点使用的国内或海外区域。这样可以确保节点从指定地区发起请求，获取地域化的数据结果。

国内区域​

接口说明​

接口地址: GET /api/business/eip-edge/ports/city-info

接口描述: 查询所有可用的区域信息，用于获取 regionCode 参数的可选值

需要认证: 否（公开接口）

请求参数​

Query 参数:

参数名类型必需默认值描述
无----

响应结果​

成功响应:

{
  "success": true,
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "province": "河南省",
      "regionCode": ["410000"]
    },
    {
      "province": "陕西省",
      "regionCode": ["610100"]
    }
  ]
}

响应字段说明:

字段名类型描述
provinceString区域名称
regionCodeArray<String>区域代码数组（行政区划代码），提交任务时填入 regionCode 参数。当前提交任务仅支持指定 1 个 regionCode（数组长度必须为 1）

使用流程​

# 步骤1: 获取可用区域列表
curl -X GET "https://business-api.molizhishu.com/api/business/eip-edge/ports/city-info"

# 步骤2: 从响应中提取 regionCode
# 例如获取到：河南省-410000

# 步骤3: 提交任务时指定 regionCode
curl -X POST "https://business-api.molizhishu.com/api/business/monitor/task/batch/shared" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": ["人工智能发展趋势"],
    "platforms": [{"platform": "deepseek", "mode": "search"}],
    "regionCode": ["410000"]
  }'

注意事项​

  1. regionCode 格式： 必须是有效的行政区划代码，可以通过本接口获取
  2. 单区域限制： 当前仅支持指定 1 个 regionCode（数组长度必须为 1）
  3. 未指定时的行为： 如果不传 regionCode 参数，节点会使用默认策略
  4. 代码有效性： regionCode 必须是当前可用的端口对应的区域代码，否则可能导致任务执行失败

海外国家/地区​

在提交批量任务时，可以通过 regionCode 参数指定节点使用的海外国家或地区。以下接口用于获取当前支持的海外国家/地区及其区域代码。

接口说明​

接口地址: GET /api/business/eip-edge/regions/overseas

接口描述: 查询系统已配置的海外国家/地区及其 regionCode

需要认证: 否（公开接口）

请求参数​

Query 参数:

参数名类型必需默认值描述
无----

响应结果​

成功响应:

{
  "success": true,
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "name": "美国",
      "regionCode": ["138"]
    },
    {
      "name": "日本",
      "regionCode": ["169"]
    },
    {
      "name": "香港",
      "regionCode": ["223"]
    },
    {
      "name": "新加坡",
      "regionCode": ["224"]
    }
  ]
}

响应字段说明:

字段名类型描述
nameString国家/地区名称
regionCodeArray<String>区域代码数组，提交任务时填入 regionCode 参数。当前提交任务仅支持指定 1 个 regionCode（数组长度必须为 1）

请求示例​

curl -X GET "https://business-api.molizhishu.com/api/business/eip-edge/regions/overseas" \
  -H "Accept: application/json"

使用示例​

以下示例演示如何使用美国节点发起请求：

curl -X POST "https://business-api.molizhishu.com/api/business/monitor/task/batch/shared" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": ["人工智能发展趋势"],
    "platforms": [{"platform": "chatgpt", "mode": "search"}],
    "regionCode": ["138"]
  }'

注意事项​

  1. 单区域限制： 当前提交任务仅支持指定 1 个 regionCode（数组长度必须为 1）
  2. 国家/地区范围： 当前支持美国、日本、香港和新加坡，以接口实际返回结果为准
  3. 未指定时的行为： 如果不传 regionCode，节点会使用默认策略