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