跳转到主要内容
POST
Get City Information

请求规范

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

费用与请求规则

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

City name to search for (e.g., 'London', 'New York').

示例:

"London"

"Tokyo"

limit
integer

Number of results to return per request (range: 1-30). Premium feature only.

必填范围: 1 <= x <= 30
offset
integer

Pagination offset to skip the first N results.

必填范围: x >= 0
country
string

ISO-3166 alpha-2 country code to filter cities (e.g., 'US', 'GB', 'JP').

示例:

"US"

"GB"

"JP"

max_lat
number

Maximum latitude coordinate for geographic filtering (range: -90 to 90).

必填范围: -90 <= x <= 90
max_lon
number

Maximum longitude coordinate for geographic filtering (range: -180 to 180).

必填范围: -180 <= x <= 180
min_lat
number

Minimum latitude coordinate for geographic filtering (range: -90 to 90).

必填范围: -90 <= x <= 90
min_lon
number

Minimum longitude coordinate for geographic filtering (range: -180 to 180).

必填范围: -180 <= x <= 180
max_population
integer

Maximum population count for filtering cities.

必填范围: x >= 0
min_population
integer

Minimum population count for filtering cities.

必填范围: x >= 0

响应

Tool result data

details
object[]
必填