aixingpan.cn API开发文档api_docs_interpretation_corpus接口指南1. 引言本文档详细介绍了占星系统的api_docs_interpretation_corpus接口的使用方法包括请求参数详解、响应数据结构、错误处理机制以及最佳实践建议。2. 接口基础信息接口名称: api_docs_interpretation_corpus请求方式: POSTContent-Type: application/x-www-form-urlencoded接口地址: /astrology/chart/api_docs_interpretation_corpus3. 请求参数详解3.1 公共参数参数名类型必填说明access_token字符串是访问令牌请在用户登录后获取3.2 业务参数| chartType | string | 必需 | 星盘类型如 “natal”、“solar_return” 等 || fallInto | object | 必需 | 查询条件对象包含以下字段 || fallInto.type | integer | 必需 | 语料类型1 行星解释4 行星落宫解释5 行星落座解释6 行星相位解释7 宫头落入星座解释 || fallInto.planet_id | integer | 条件必需 | 行星IDtype1,4,5,6时需要 || fallInto.planet_id2 | integer | 条件必需 | 第二个行星ID仅type6时需要 || fallInto.sign_id | integer | 条件必需 | 星座IDtype5,7时需要 || fallInto.house_id | integer | 条件必需 | 宫位IDtype4,7时需要 || fallInto.degree | integer | 条件必需 | 相位度数仅type6时需要 || corpusSets | array | 可选 | 语料集名称列表用于过滤查询结果。推荐使用 [“aixingpan”] 来获取爱星盘解释语料。 || returnAll | boolean | 可选 | 是否返回所有匹配的语料集结果默认为 false |4. 请求示例解析{access_token:***,birthday:1990-01-01 12:00:00,longitude:116.404,latitude:39.915,tz:8:00}## 5. 如何发送请求 ### 5.1 使用curl发送请求bash curl-XPOSThttps://chart.12sign.top/astrology/chart/api_docs_interpretation_corpus -H Content-Type:application/x-www-form-urlencoded -d access_tokenYOUR_TOKEN -d param1value1 -d param2value25.2 使用Postman发送请求打开Postman新建请求请求方式选择 POSTURL填写接口地址在Body选项卡选择 x-www-form-urlencoded填写请求参数点击Send发送请求6. 响应处理指南6.1 成功响应格式{code:0,msg:操作成功,data:{...}}### 6.2 响应字段说明 - **code**: 状态码0表示成功 - - **msg**: 状态描述 - - **data**: 返回的业务数据 - - **exe_time**: 执行时间 ## 7. 错误处理与调试 | 错误码 | 说明 | 解决方案 | |--------|------|----------| | 1001 | 参数错误 | 检查必填参数是否完整参数格式是否正确 | | 1002 | access_token无效 | 检查access_token是否正确是否已过期 | | 1003 | 权限不足 | 确认账号是否有调用该接口的权限 | | 500 | 服务器内部错误 | 联系zx12sign | ## 8. 最佳实践与性能优化 ### 8.1 请求优化 - 合理设置超时时间建议30秒 - - 使用连接池复用连接 - - 避免频繁重复请求相同参数 ### 8.2 安全建议 - 不要在客户端代码中硬编码access_token - - 定期更新access_token - - 使用HTTPS协议调用接口 ### 8.3 注意事项 - 所有时间参数请使用正确的格式YYYY-MM-DD HH:MM:SS - - 经纬度参数需要精确到小数点后6位 - - 时区参数使用标准时区格式如8:00 ## 9. 使用案例 ### 案例1基本本命盘查询pythonimportrequests urlhttps://chart.12sign.top/astrology/chart/nataldata{access_token:YOUR_TOKEN,birthday:1990-01-01 12:00:00,longitude:116.404,latitude:39.915,tz:8:00}responserequests.post(url,datadata)resultresponse.json()print(result)10. 结论api_docs_interpretation_corpus接口是占星系统的核心接口之一通过本文档的指导您应该能够顺利地集成和使用该接口。如有任何问题请联系zx12sign 获取帮助。文档生成时间: 2026-08-14 01:45:02版本: v1.0