导入
额外的 API 参数
了解 SeatGeek API 端点的附加参数。
| 名称 | 类别 | 语法 | 描述 |
|---|---|---|---|
| 地理位置 IP | 可选 | geoip | 该参数根据用户的地理位置信息对请求进行定位。可以向此参数提供用户的有效IP地址或邮政编码。也可以传入 true，此时API会自动获取用户的IP地址并完成定位。该参数的默认值为 false。 |
| 纬度 | 可选 | lat | 该参数定义用户位置的纬度浮点数值。如果使用了 lon 参数，则此参数变为必填项。该参数的默认值为 null。 |
| 经度 | 可选 | lon | 该参数定义用户位置的经度浮点数值。如果使用了 lat 参数，则此参数变为必填项。该参数的默认值为 null。 |
| 范围 | 可选 | range | 该参数定义以用户位置为中心的搜索半径，单位可以是英里（mi）或公里（km）。该参数的默认值为 30mi。 |
| 名称 | 类别 | 语法 | 描述 |
|---|---|---|---|
| 每页文档数量 | 可选 | per_page | 该参数定义每页返回的响应文档数量。该参数的默认值为 10。 |
| 页码 | 可选 | page | 该参数定义要获取响应文档的页码。该参数的默认值为 1。 |
| 名称 | 类别 | 语法 | 描述 |
|---|---|---|---|
| 排序 | 可选 | sort=[FIELD].[DIRECTION] | 该参数定义每次API调用中如何对响应文档进行排序。DIRECTION 的取值包括 asc 和 desc，FIELD 的取值包括 datetime_local、datetime_utc、announce_date、id 和 score。事件接口的默认值为 datetime_utc.asc；表演者和场馆接口的默认值为 score.desc。 |
| 名称 | 类别 | 语法 | 描述 |
|---|---|---|---|
| 筛选 | 可选 | listing_count.[OPERATOR]average_price.[OPERATOR]lowest_price.[OPERATOR]highest_price.[OPERATOR] | 该参数定义每次API调用中如何对响应文档进行筛选。OPERATOR 的取值包括 gt、gte、lt 和 lte。该参数的默认值为 null。 |