SharkAPI

DEVELOPER DOCUMENTATION

接口文档

统一使用 HTTPS + JSON 调用 SharkAPI。所有接口均通过 API Key 认证，并按调用量扣除 Tokens。

认证方式Authorization: Bearer sk_live_your_api_key

POST

金额大写转换

将人民币金额转换为中文大写金额。

10 Tokens
/v1/tool/amount-words

请求字段

amount · string · 必填

返回字段

amount · string；words · string

请求头

Authorization：API Key
Content-Type：application/json

请求与响应示例

{ "amount": "123.45" }

→ { "amount": "123.45", "words": "壹佰贰拾叁元肆角伍分" }

POST

农历日期转换

返回公历对应的农历、干支和宜忌信息。

10 Tokens
/v1/calendar/lunar

请求字段

date · string · YYYY-MM-DD

返回字段

lunar_info · object（农历及干支信息）

请求头

Authorization：API Key
Content-Type：application/json

请求与响应示例

{ "date": "2026-10-29" }

→ { "lunar_info": { "solar": { "date": "2026-10-29" }, "lunar": { "chinese_year": "二〇二六" } } }

POST

User-Agent 解析

识别浏览器、操作系统、设备类型和移动端状态。

10 Tokens
/v1/tool/ua-parse

请求字段

user_agent · string · 必填

返回字段

browser · string；os · string；device · string；mobile · boolean

请求头

Authorization：API Key
Content-Type：application/json

请求与响应示例

{ "user_agent": "Mozilla/5.0 ..." }

→ { "browser": "Chrome", "os": "Windows", "device": "Desktop", "mobile": false }

POST

图像二值化

使用固定阈值、Otsu 或局部自适应算法处理图片。

100 Tokens
/v1/compute/image-binary

请求字段

image · base64 string · 必填；method · threshold|otsu|adaptive

返回字段

image · base64 string；content_type · string

请求头

Authorization：API Key
Content-Type：application/json

请求与响应示例

{ "image": "iVBORw0KGgo...", "method": "otsu" }

→ { "content_type": "image/png", "image": "iVBORw0KGgo..." }

POST

全球行政区划查询

按 ISO 国家代码和层级查询国家、一级行政区及中国区县。

10 Tokens
/v1/geo/district

请求字段

country_code · string；level · 0-4；parent_code · string

返回字段

list · array（列表查询）或 area · object（详情查询）

请求头

Authorization：API Key
Content-Type：application/json

请求与响应示例

{ "country_code": "US", "level": 1, "parent_code": 0 }

→ { "list": [{ "country_code": "US", "code": "CA", "name": "California", "level": 1 }] }

POST

IP 属地查询

根据 IP 查询地理位置，需等待数据服务接入。

10 Tokens
/v1/network/ip-location

请求字段

ip · string · 必填

返回字段

country_code · string；region · string；city · string

请求头

Authorization：API Key
Content-Type：application/json

请求与响应示例

{ "ip": "8.8.8.8" }

→ { "country_code": "US", "region": "California", "city": "Mountain View" }