鍏�(n猫i)缍�(w菐ng)鐭俊椹�(y脿n)璀夌⒓鏂规
Table of contents
寮曡█
椹�(y脿n)璀夌⒓鐭俊鍦ㄧ従(xi脿n)浠ｆ噳(y墨ng)鐢ㄤ腑鎵紨钁楄嚦闂�(gu膩n)閲嶈鐨勮鑹�锛屽畠鏄竴绋啊鍠€岄珮鏁堢殑瀹夊叏椹�(y脿n)璀夋柟寮忥紝琚唬娉涚敤浜庡悇椤炴噳(y墨ng)鐢ㄥ拰鍫存櫙銆傞(y脿n)璀夌⒓鐭俊鍦ㄧ従(xi脿n)浠ｆ噳(y墨ng)鐢ㄤ腑鐨勮捣钁楄超铏熷畨鍏ㄤ繚闅溿€佷氦鏄撹垏鏀粯瀹夊叏淇濋殰绛夐噸瑕佷綔鐢�銆� 鍦ㄦ湰鏂囦腑锛屾湰鏂囧皣鍦嶇篂椹�(y脿n)璀夌⒓鐭俊 API 鐨勫熀鏈師鐞�銆侀(y脿n)璀夌⒓鐭俊 API 鐨勬妧琛�(sh霉)瑕侀粸(di菐n)绛夊収(n猫i)瀹瑰睍闁�锛屾繁鍏ユ帰绱㈤(y脿n)璀夌⒓鐭俊API鐨勫(sh铆)鐝�(xi脿n)鍘熺悊鍙婂叾鍎�(y艒u)鍖栫瓥鐣�銆�
椹�(y脿n)璀夌⒓鐭俊 API 姒傝堪
椹�(y脿n)璀夌⒓鐭俊 API 鏄竴绋彁渚涢(y脿n)璀夌⒓鐭俊鐧�(f膩)閫佹湇鍕�(w霉)鐨勬帴鍙ｏ紝鏃ㄥ湪骞姪闁嬬櫦(f膩)鑰呭拰浼佹キ(y猫)蹇€�銆侀珮鏁堝湴鍚戠敤鎴剁櫦(f膩)閫侀(y脿n)璀夌⒓鐭俊锛屽苟瀵�(sh铆)鐝�(xi脿n)椹�(y脿n)璀夌⒓鐨勯(y脿n)璀夊姛鑳姐€傞€欑ó API 鍙互閫氶亷鑸囦笁澶ч亱(y霉n)鐕熷晢锛堢Щ鍕�銆佽伅(li谩n)閫氥€侀浕淇★級鍜岃櫅鎿亱(y霉n)鐕熷晢鐨勬帴鍙ｄ氦浜�锛屽皣椹�(y脿n)璀夌⒓鐭俊婧�(zh菙n)纰哄湴鐧�(f膩)閫佺郸鐢ㄦ埗鎵嬫(j墨)锛屼互纰轰繚鐢ㄦ埗韬唤鐨勭湡瀵�(sh铆)鎬у拰瀹夊叏鎬с€�
椹�(y脿n)璀夌⒓鐭俊 API 鎺ュ叆鎸囧崡
鍏�(n猫i)缍�(w菐ng)鐭俊椹�(y脿n)璀夌⒓鏇翠富鍕曞畨鍏ㄦ€�锛屽彲浠ョ敤浜庨棞(gu膩n)閸佃妤�(y猫)闂�(gu膩n)閸垫噳(y墨ng)鐢�銆傚収(n猫i)缍�(w菐ng)椹�(y脿n)璀夌⒓骞宠嚭鎼缓鏈€濂介伕鐢ㄦ垚鐔熺殑鐭俊纭欢鍜岀煭淇′腑闁撲欢骞宠嚭銆備笉鍚屼簬澶栫恫(w菐ng)鐭俊锛屽収(n猫i)缍�(w菐ng)鐭俊闇€瑕侀啱(y墨)渚濊炒SIM鍗�锛岃€岄亱(y霉n)鐕熷晢灏峉IM鍗＄櫦(f膩)閫佹湁瑕�(gu墨)鍓囬檺鍒�锛岄噰鐢ㄦ垚鐔熺殑鐭俊涓枔浠跺彲浠ユ彁楂樼煭淇＄櫦(f膩)閫佹垚鍔熺巼銆�
瀵�(sh铆)鐝�(xi脿n)鍘熺悊
鎴戝€戝皣浠嬬垂椹�(y脿n)璀夌⒓鐭俊 API 鐨勫熀鏈伐浣滃師鐞嗭紝鍖呮嫭鐧�(f膩)閫侀(y脿n)璀夌⒓鐭俊鐨勬祦绋�銆丄PI 鑸囬亱(y霉n)鐕熷晢鐨勪氦浜掓柟寮�锛屼互鍙婄敤鎴舵帴鏀跺拰椹�(y脿n)璀夐(y脿n)璀夌⒓鐨勯亷绋嬨€�
1锛夌煭淇＄恫(w菐ng)闂�(gu膩n)鑸囩煭淇￠€氶亾
鐭俊缍�(w菐ng)闂�(gu膩n)鐨勬蹇佃垏浣滅敤锛� 鐭俊缍�(w菐ng)闂�(gu膩n)鏄€ｆ帴鎳�(y墨ng)鐢ㄧ郴绲�(t菕ng)鍜岄亱(y霉n)鐕熷晢涔嬮枔鐨勬⿱姊�锛岀敤浜庡(sh铆)鐝�(xi脿n)鐭俊鐨勭櫦(f膩)閫佸拰鎺ユ敹銆傚畠璨�(f霉)璨�(z茅)灏囨噳(y墨ng)鐢ㄧ郴绲�(t菕ng)鐢熸垚鐨勭煭淇″収(n猫i)瀹圭櫦(f膩)閫佸埌鐩告噳(y墨ng)鐨勯亱(y霉n)鐕熷晢閫氶亾锛屽苟灏囨帴鏀跺埌鐨勭煭淇″緸閬�(y霉n)鐕熷晢閫氶亾鍌抽仦鍥炴噳(y墨ng)鐢ㄧ郴绲�(t菕ng)銆傜煭淇＄恫(w菐ng)闂�(gu膩n)璧峰埌浜嗕腑杞�(zhu菐n)鍜岃綁(zhu菐n)鐧�(f膩)鐨勪綔鐢�锛屽(sh铆)鐝�(xi脿n)浜嗙煭淇＄殑璺ㄧ恫(w菐ng)鐧�(f膩)閫併€�
鍏�(n猫i)缍�(w菐ng)鐭俊閫氶亾渚濊炒鐭俊瑷�(sh猫)鍌�锛屾湁1鍙�-64鍙ｅ彲閬告搰銆�
2锛夐(y脿n)璀夌⒓鐢熸垚绠楁硶
椹�(y脿n)璀夌⒓鏄竴绋毃姗�(j墨)鐢熸垚鐨勬暩(sh霉)瀛椼€佸瓧姣嶆垨绗﹁櫉绲勫悎锛岀敤浜庨(y脿n)璀夌敤鎴剁殑韬唤銆傜敓鎴愰(y脿n)璀夌⒓鏅�锛岄渶瑕佹豢瓒充竴瀹氱殑瀹夊叏鎬у拰鍙畝鎬ц姹�銆�
浠ヤ笅鏄父瑕嬬殑椹�(y脿n)璀夌⒓鐢熸垚绠楁硶锛�
- 闅ㄦ(j墨)鏁�(sh霉)鐢熸垚绠楁硶锛� 浣跨敤闅ㄦ(j墨)鏁�(sh霉)鐢熸垚鍣ㄧ敓鎴愪竴涓叉寚瀹氶暦搴︾殑闅ㄦ(j墨)鏁�(sh霉)瀛楁垨瀛楁瘝锛屽啀灏囧叾浣滅偤椹�(y脿n)璀夌⒓鐧�(f膩)閫佺郸鐢ㄦ埗銆傞毃姗�(j墨)鏁�(sh霉)鐢熸垚绠楁硶绨″柈蹇€�锛屼絾鍙兘瀛樺湪涓嶆槗璀樺垾鐨勫瓧绗︼紝褰遍熆鐢ㄦ埗楂旈(y脿n)銆�
- 鍝堝笇绠楁硶锛� 灏囩暥(d膩ng)鍓嶆檪闁撴埑銆佺敤鎴舵墜姗�(j墨)铏熺瓑淇℃伅鑸囧瘑閼伴€�(j矛n)琛屽搱甯岃▓绠�锛岀敓鎴愬敮涓€鐨勯(y脿n)璀夌⒓銆傚搱甯岀畻娉曠敓鎴愮殑椹�(y脿n)璀夌⒓鍏锋湁杓冨ソ鐨勯毃姗�(j墨)鎬у拰鍞竴鎬�锛屼絾闇€瑕佹敞鎰忓瘑閼扮殑淇濆瘑鎬�锛屼互闃叉椹�(y脿n)璀夌⒓琚儭鎰忕敓鎴�銆�
- 娣峰悎绠楁硶锛� 绲�(ji茅)鍚堝绋毃姗�(j墨)鐢熸垚鏂规硶锛屽闅ㄦ(j墨)鏁�(sh霉)鍜屾檪闁撴埑鐨勭祫鍚�锛屼互鎻愰珮椹�(y脿n)璀夌⒓鐨勫畨鍏ㄦ€у拰鍙畝鎬�銆�
- 鏈夋晥鏈熻ō(sh猫)缃細 鐢熸垚鐨勯(y脿n)璀夌⒓鎳�(y墨ng)瑭茶ō(sh猫)缃湁鏁堟湡锛岀⒑淇濈敤鎴跺湪涓€瀹氭檪闁撳収(n猫i)浣跨敤椹�(y脿n)璀夌⒓锛岄槻姝㈤(y脿n)璀夌⒓閬庢湡灏�(d菐o)鑷撮(y脿n)璀夊け鏁�銆�
3锛夌煭淇＄櫦(f膩)閫佺殑鎶€琛�(sh霉)瀵�(sh铆)鐝�(xi脿n)
鐭俊鐧�(f膩)閫佹秹鍙婂埌鎳�(y墨ng)鐢ㄥ悗鑷哄拰鐭俊缍�(w菐ng)闂�(gu膩n)涔嬮枔鐨勪氦浜掗亷绋嬨€�
浠ヤ笅鏄煭淇＄櫦(f膩)閫佺殑鎶€琛�(sh霉)瀵�(sh铆)鐝�(xi脿n)姝ラ锛�
- 鐢ㄦ埗璜嬫眰椹�(y脿n)璀夌⒓锛� 鐢ㄦ埗鍦ㄦ噳(y墨ng)鐢ㄧ晫闈笂瑙哥櫦(f膩)璜嬫眰椹�(y脿n)璀夌⒓鐨勬搷浣�锛屼緥濡傞粸(di菐n)鎿婄嵅鍙栭(y脿n)璀夌⒓鎸夐垥銆�
- 鐢熸垚椹�(y脿n)璀夌⒓锛� 鎳�(y墨ng)鐢ㄥ悗鑷烘帴鏀跺埌鐢ㄦ埗鐨勮珛姹傚悗锛屾牴鎿�(j霉)闋�(y霉)鍏堣ō(sh猫)瀹氱殑鐢熸垚绠楁硶鐢熸垚椹�(y脿n)璀夌⒓锛屽苟灏囬(y脿n)璀夌⒓鑸囩敤鎴剁殑鎵嬫(j墨)铏熼€�(j矛n)琛岀秮瀹�銆�
- 瑾�(di脿o)鐢ㄧ煭淇＄恫(w菐ng)闂�(gu膩n)锛� 鎳�(y墨ng)鐢ㄥ悗鑷鸿(di脿o)鐢ㄧ煭淇＄恫(w菐ng)闂�(gu膩n)鎺ュ彛锛屽皣鐢熸垚鐨勯(y脿n)璀夌⒓鍜岀洰妯�(bi膩o)鎵嬫(j墨)铏熸彁浜ょ郸鐭俊缍�(w菐ng)闂�(gu膩n)銆�
- 閬告搰閬�(y霉n)鐕熷晢閫氶亾锛� 鐭俊缍�(w菐ng)闂�(gu膩n)鏍规摎(j霉)鐩(bi膩o)鎵嬫(j墨)铏熺殑閬�(y霉n)鐕熷晢锛岄伕鎿囩浉鎳�(y墨ng)鐨勯亱(y霉n)鐕熷晢閫氶亾鐧�(f膩)閫佺煭淇�銆�
- 閬�(y霉n)鐕熷晢鐧�(f膩)閫佺煭淇★細 鐭俊缍�(w菐ng)闂�(gu膩n)閫氶亷閬稿畾鐨勯亱(y霉n)鐕熷晢閫氶亾鍚戠洰妯�(bi膩o)鎵嬫(j墨)铏熺櫦(f膩)閫佸寘鍚(y脿n)璀夌⒓鐨勭煭淇°€�
- 鐢ㄦ埗鎺ユ敹鐭俊锛� 鐢ㄦ埗鎵嬫(j墨)鎺ユ敹鍒扮煭淇�锛屽叾涓寘鍚簡鐢熸垚鐨勯(y脿n)璀夌⒓銆�
- 椹�(y脿n)璀夐(y脿n)璀夌⒓锛� 鐢ㄦ埗杓稿叆鏀跺埌鐨勯(y脿n)璀夌⒓锛屽苟鎻愪氦绲︽噳(y墨ng)鐢ㄥ悗鑷洪€�(j矛n)琛岄(y脿n)璀夈€�
- 椹�(y脿n)璀夌祼(ji茅)鏋滆繑鍥烇細 鎳�(y墨ng)鐢ㄥ悗鑷哄皪鐢ㄦ埗鎻愪氦鐨勯(y脿n)璀夌⒓閫�(j矛n)琛岄(y脿n)璀�锛岃繑鍥為(y脿n)璀夌祼(ji茅)鏋滅郸鐢ㄦ埗锛屽畬鎴愭暣鍊嬮(y脿n)璀夌⒓鐭俊椹�(y脿n)璀夋祦绋嬨€�
楂樺埌閬�(d谩)鐜囪垏鍎�(y艒u)鍖栫瓥鐣�
- 鐐轰粈涔堥珮鍒伴仈(d谩)鐜囬噸瑕�
鍦ㄩ(y脿n)璀夌⒓鐭俊鍫存櫙涓�锛岄珮鍒伴仈(d谩)鐜囨槸鑷抽棞(gu膩n)閲嶈鐨�銆傚彧鏈夌暥(d膩ng)鐢ㄦ埗婧�(zh菙n)纰哄湴鎺ユ敹鍒伴(y脿n)璀夌⒓鐭俊锛屾墠鑳界⒑淇濋(y脿n)璀夋祦绋嬬殑鏈夋晥鎬у拰瀹夊叏鎬�銆傞珮鍒伴仈(d谩)鐜囩洿鎺ュ奖闊夸簡鐢ㄦ埗楂旈(y脿n)鍜屾噳(y墨ng)鐢ㄧ殑鍙潬鎬�锛岃兘澶犲寮�(qi谩ng)鐢ㄦ埗灏嶆噳(y墨ng)鐢ㄧ殑淇′换鎰�銆�
- 褰遍熆鍒伴仈(d谩)鐜囩殑鍥犵礌
- 閬�(y霉n)鐕熷晢閫氶亾璩�(zh矛)閲忥細 涓嶅悓閬�(y霉n)鐕熷晢鐨勭煭淇￠€氶亾璩�(zh矛)閲忎笉鍚�锛岄伕鎿囩┅(w臎n)瀹氬彲闈犵殑閬�(y霉n)鐕熷晢閫氶亾鑳藉鎻愰珮鍒伴仈(d谩)鐜囥€�
- 铏熺⒓鐙€鎱�(t脿i)锛� 鐢ㄦ埗鐨勬墜姗�(j墨)铏熺⒓鐙€鎱�(t脿i)锛堜緥濡傚仠姗�(j墨)銆佹瑺璨�(f猫i)绛夛級鏈冨奖闊跨煭淇＄櫦(f膩)閫佺殑鎴愬姛鐜囥€�
- 缍�(w菐ng)绲�(lu貌)鐙€娉侊細 鐢ㄦ埗鎵€铏曠殑鍦扮悊浣嶇疆鍜岀恫(w菐ng)绲�(lu貌)鐠�(hu谩n)澧冧篃鏈冨皪鐭俊鐧�(f膩)閫侀€犳垚褰遍熆銆�
- ...
- 鍎�(y艒u)鍖栫瓥鐣ワ細椹�(y脿n)璀夌⒓鐭俊鍏�(n猫i)瀹硅垏鏍煎紡
- 绨℃綌鏄庝簡鐨勫収(n猫i)瀹癸細 鐭俊鍏�(n猫i)瀹规噳(y墨ng)瑭茬啊娼旀槑浜�锛岀洿鎺ヨ〃閬�(d谩)椹�(y脿n)璀夌⒓鐨勪綔鐢ㄥ拰浣跨敤鏂瑰紡锛岄伩鍏嶅紩鍏ラ亷澶氱劇闂�(gu膩n)淇℃伅銆�
- 閬垮厤鏁忔劅瑭烇細 鐭俊鍏�(n猫i)瀹逛腑鎳�(y墨ng)閬垮厤浣跨敤鏁忔劅瑭炲尟锛屼互鍏嶈閬�(y霉n)鐕熷晢鏀旀埅銆�
- ...
椹�(y脿n)璀夌⒓鐭俊鎳�(y墨ng)鐢ㄥ牬鏅垎鏋�
鐭俊椹�(y脿n)璀夌⒓鏄竴绋潪甯稿父瑕嬬殑椹�(y脿n)璀夋柟寮�锛屽彲浠ラ€氶亷鐭俊灏囬毃姗�(j墨)鐢熸垚鐨勯(y脿n)璀夌⒓鐧�(f膩)閫佸埌鐢ㄦ埗鎵嬫(j墨)涓婇€�(j矛n)琛岄(y脿n)璀�銆傚湪涓嶅悓鐨勬キ(y猫)鍕�(w霉)鍫存櫙涓紝鐭俊椹�(y脿n)璀夌⒓鍙互鎳�(y墨ng)鐢ㄤ簬澶氱ó椹�(y脿n)璀夊牬鏅�锛屼互涓嬫槸骞惧€嬪吀鍨嬬殑鎳�(y墨ng)鐢ㄥ牬鏅細
1. 鎵嬫(j墨)娉ㄥ唺
鍦ㄧЩ鍕曚簰鑱�(li谩n)缍�(w菐ng)鏅備唬锛屾墜姗�(j墨)娉ㄥ唺宸茬稉(j墨ng)鎴愮偤浜嗛潪甯稿父瑕嬬殑涓€绋敞鍐婃柟寮�銆傚湪鐢ㄦ埗娉ㄥ唺鏅傦紝闇€瑕佽几鍏ユ墜姗�(j墨)铏熺⒓锛屽苟涓旈€氶亷鐭俊椹�(y脿n)璀夌⒓椹�(y脿n)璀夋墜姗�(j墨)铏熺殑鐪熷(sh铆)鎬�锛岄伩鍏嶆儭鎰忔敞鍐婂拰铏涘亣淇℃伅锛屼繚璀夌敤鎴朵俊鎭殑鐪熷(sh铆)鎬у拰瀹夊叏鎬�銆�
2. 鎵惧洖瀵嗙⒓
鐣�(d膩ng)鐢ㄦ埗蹇樿瀵嗙⒓鏅傦紝鍙互閫氶亷鎵嬫(j墨)铏熺⒓鐛插彇椹�(y脿n)璀夌⒓閫�(j矛n)琛岄(y脿n)璀�锛岀劧鍚庨€氶亷杓稿叆椹�(y脿n)璀夌⒓渚嗛噸缃瘑纰�銆傞€欑ó鏂瑰紡姣斿偝绲�(t菕ng)鐨勬壘鍥炲瘑纰兼柟寮忔洿鍔犵啊鍠拰蹇嵎锛屽彲浠ユ彁楂樼敤鎴剁殑浣跨敤楂旈(y脿n)銆�
3. 鏀粯椹�(y脿n)璀�
鍦ㄦ敮浠樺銆佸井淇℃敮浠樼瓑鏀粯鍫存櫙涓�锛岄渶瑕侀€氶亷鐭俊椹�(y脿n)璀夌⒓渚嗕繚璀変氦鏄撶殑瀹夊叏鎬у拰鍙潬鎬�锛岄伩鍏嶄笉娉曞垎瀛愮洔鐢ㄧ敤鎴惰超铏熼€�(j矛n)琛屾瑭愬拰闈炴硶浜ゆ槗銆�
4. 鏇存敼淇℃伅
鐢ㄦ埗鏇存敼娉ㄥ唺绠＄悊閲嶈淇℃伅鐨勬檪鍊�锛岄€氶亷濉叆鎵嬫(j墨)椹�(y脿n)璀夌⒓锛屼竴閸垫搷浣滐紝瀹夊叏鎻愪緵渚挎嵎銆�
瀵湪鏈€鍚�
闅ㄨ憲绉诲嫊浜掕伅(li谩n)缍�(w菐ng)鐨勪笉鏂风櫦(f膩)灞�锛岄(y脿n)璀夌⒓鐭俊API鐨勯噸瑕佹€у皣鎰堢櫦(f膩)鍑搁’銆傚皪浜庨枊鐧�(f膩)鑰呭拰浼佹キ(y猫)渚嗚锛岄伕鎿囩┅(w臎n)瀹氬彲闈犵殑椹�(y脿n)璀夌⒓鐭俊 API锛岃兘澧炲挤(qi谩ng)鐢ㄦ埗灏嶆噳(y墨ng)鐢ㄧ殑淇′换鎰熷拰绮樻€�锛岀偤鐢ㄦ埗鎻愪緵鏇村姞瀹夊叏銆佷究鎹风殑鏈嶅嫏(w霉)楂旈(y脿n)锛岄渶瑕佺殑灏忎紮浼磋稌绶婄敤璧蜂締鍚