aixingpan.cn API開(kāi)發(fā)文檔api_docs_onechart_progression_sec2接口指南1. 引言本文檔詳細(xì)介紹了占星系統(tǒng)的api_docs_onechart_progression_sec2接口的使用方法包括請(qǐng)求參數(shù)詳解、響應(yīng)數(shù)據(jù)結(jié)構(gòu)、錯(cuò)誤處理機(jī)制以及最佳實(shí)踐建議。2. 接口基礎(chǔ)信息接口名稱: api_docs_onechart_progression_sec2請(qǐng)求方式: POSTContent-Type: application/x-www-form-urlencoded接口地址: /astrology/chart/api_docs_onechart_progression_sec23. 請(qǐng)求參數(shù)詳解3.1 公共參數(shù)參數(shù)名類型必填說(shuō)明access_token字符串是訪問(wèn)令牌請(qǐng)?jiān)谟脩舻卿浐螳@取3.2 業(yè)務(wù)參數(shù)| planets | 數(shù)組 | 是 | 星體id列表 || h_sys | 字符 | 否 | 宮位系統(tǒng)默認(rèn)k || longitude | 字符 | 否 | 經(jīng)度 || latitude | 字符 | 否 | 緯度 || tz | 字符 | 否 | 時(shí)區(qū) || birthday | 字符 | 否 | 生日時(shí)間格式1999-10-17 21:00:00 |4. 請(qǐng)求示例解析{access_token:***,birthday:1990-01-01 12:00:00,longitude:116.404,latitude:39.915,tz:8:00}## 5. 如何發(fā)送請(qǐng)求 ### 5.1 使用curl發(fā)送請(qǐng)求bash curl-XPOSThttps://chart.12sign.top/astrology/chart/api_docs_onechart_progression_sec2 -H Content-Type:application/x-www-form-urlencoded -d access_tokenYOUR_TOKEN -d param1value1 -d param2value25.2 使用Postman發(fā)送請(qǐng)求打開(kāi)Postman新建請(qǐng)求請(qǐng)求方式選擇 POSTURL填寫接口地址在Body選項(xiàng)卡選擇 x-www-form-urlencoded填寫請(qǐng)求參數(shù)點(diǎn)擊Send發(fā)送請(qǐng)求6. 響應(yīng)處理指南6.1 成功響應(yīng)格式{chart_type:progression_sec,natal_data:{datetime:1990-06-15 14:30:00,lat:39.9042,lon:116.4074,tz:8},target_data:{datetime:2025-01-15 12:00:00,lat:39.9042,lon:116.4074,tz:8}}### 6.2 響應(yīng)字段說(shuō)明 - **code**: 狀態(tài)碼0表示成功 - - **msg**: 狀態(tài)描述 - - **data**: 返回的業(yè)務(wù)數(shù)據(jù) - - **exe_time**: 執(zhí)行時(shí)間 ## 7. 錯(cuò)誤處理與調(diào)試 | 錯(cuò)誤碼 | 說(shuō)明 | 解決方案 | |--------|------|----------| | 1001 | 參數(shù)錯(cuò)誤 | 檢查必填參數(shù)是否完整參數(shù)格式是否正確 | | 1002 | access_token無(wú)效 | 檢查access_token是否正確是否已過(guò)期 | | 1003 | 權(quán)限不足 | 確認(rèn)賬號(hào)是否有調(diào)用該接口的權(quán)限 | | 500 | 服務(wù)器內(nèi)部錯(cuò)誤 | 聯(lián)系z(mì)x12sign | ## 8. 最佳實(shí)踐與性能優(yōu)化 ### 8.1 請(qǐng)求優(yōu)化 - 合理設(shè)置超時(shí)時(shí)間建議30秒 - - 使用連接池復(fù)用連接 - - 避免頻繁重復(fù)請(qǐng)求相同參數(shù) ### 8.2 安全建議 - 不要在客戶端代碼中硬編碼access_token - - 定期更新access_token - - 使用HTTPS協(xié)議調(diào)用接口 ### 8.3 注意事項(xiàng) - 所有時(shí)間參數(shù)請(qǐng)使用正確的格式Y(jié)YYY-MM-DD HH:MM:SS - - 經(jīng)緯度參數(shù)需要精確到小數(shù)點(diǎn)后6位 - - 時(shí)區(qū)參數(shù)使用標(biāo)準(zhǔn)時(shí)區(qū)格式如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. 結(jié)論api_docs_onechart_progression_sec2接口是占星系統(tǒng)的核心接口之一通過(guò)本文檔的指導(dǎo)您應(yīng)該能夠順利地集成和使用該接口。如有任何問(wèn)題請(qǐng)聯(lián)系z(mì)x12sign 獲取幫助。文檔生成時(shí)間: 2026-10-23 01:45:01版本: v1.0