跳转到主要内容
POST
Reference example

请求规范

  • 方法与路径: POST /apis/v1/accu-weather/search-locations
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/accu-weather/search-locations
  • Runtime 事实版本: 5781dfb550d2098ff8623ee80fcdce60f473cad692c33c4ebc2dffcb2bca6ead
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

按用量计费;默认请求预估费用:$0.0004 USD(不是固定价格)。 声明的单位费率:每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.0004
  • 声明的单位费率(USD): 1e-06
  • 计费单位: provider_credit
  • 计费依据: response_units
  • 公开参考倍率: 1.0
  • 声明的最大计数或单位数: 10000000
  • 结算证据来源: response_body

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
query
string
必填

Location, city, postal code, or point-of-interest text to search.

Minimum string length: 1
示例:

"New York"

details
boolean
默认值:false

Whether to include extended location details.

language
string
默认值:en-us

Language code for localized fields.

Minimum string length: 1
示例:

"en-us"

admin_code
string

Optional administrative-area restriction. Supported for location, city, and point_of_interest searches.

示例:

"NY"

alias_count
integer
默认值:2

Number of aliases to return for location or city searches.

必填范围: x >= 0
next_cursor
string

Opaque cursor returned by a previous location or city search; omit for the first page.

country_code
string

Optional country restriction. Required when admin_code is provided.

示例:

"US"

all_languages
boolean
默认值:false

Return point-of-interest matches in all languages; valid only when location_type is point_of_interest.

location_type
enum<string>
默认值:location

Resource family to search.

可用选项:
location,
city,
postal_code,
point_of_interest
point_of_interest_type
string

Optional provider point-of-interest type filter; valid only when location_type is point_of_interest.

响应

Tool result data

has_more
boolean
必填
items
object[]
next_cursor
string