星盘接口开发文档时空盘接口指南1. 引言本文档详细介绍了占星系统的时空盘接口的使用方法包括请求参数详解、响应数据结构、错误处理机制以及最佳实践建议。2. 接口基础信息接口名称: 时空盘请求方式: POSTContent-Type: application/x-www-form-urlencoded接口地址: /astrology/chart/时空盘3. 请求参数详解3.1 公共参数参数名类型必填说明access_token字符串是访问令牌请在用户登录后获取3.2 业务参数| access_token | 字符 | 是 | 访问Token【Token附加参数】 || planets | 数组 | 是 | 星体id || planet_xs | 数组 | 否 | 小行星id || virtual | 数组 | 否 | 虚星id || h_sys | 字符 | 否 | 宫位系统 默认k || user_list | 数组 | 是 | 双人数据结构 对象格式 例{0:{‘longitude’:121.47,‘latitude’:31.23,‘tz’:8,‘birthday’:‘2020-10-08 10:45’},1:{‘longitude’:121.47,‘latitude’:31.23,‘tz’:8,‘birthday’:‘2020-10-08 10:45’}} || svg_type | 字符 | 否 | 1普通盘 (默认高级盘) |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://www.xingpan.vip/astrology/chart/时空盘 -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 | 服务器内部错误 | 联系技术支持 | ## 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://www.xingpan.vip/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. 结论时空盘接口是占星系统的核心接口之一通过本文档的指导您应该能够顺利地集成和使用该接口。如有任何问题请联系技术支持团队xingpanvip获取帮助。文档生成时间: 2026-10-01 01:30:01版本: v1.0