Posted 2021-04-21 寮€鍙戣€呮妧鏈墠绾?/a>

鐐瑰嚮鈥?/span>寮€鍙戣€呮妧鏈墠绾?/span>鈥濓紝閫夋嫨鈥滄槦鏍囸煍濃€?/span>

鍦ㄧ湅|鏄熸爣|鐣欒█,  鐪熺埍

婧?nbsp;/  浜笢闆跺敭鎶€鏈?nbsp;   鏂?nbsp;/  鐜嬩附

姒傝堪

1

 鑳屾櫙

浜笢浣滀负鐢靛晢骞冲彴锛岃繎鍑犲勾鐢ㄦ埛銆佷笟鍔℃寔缁闀匡紝璁块棶閲忔寔缁笂鍗囷紝闅忕潃杩欎簺涓氬姟鐨勫彂灞曪紝API缃戝叧搴旇繍鑰岀敓銆?/p>

API缃戝叧锛屽氨鏄负浜嗚В鏀惧鎴风涓庢湇鍔＄鑰屽瓨鍦ㄧ殑銆傚浜庡鎴风锛屼娇寮€鏀剧粰瀹㈡埛绔殑鎺ュ彛鏍囧噯缁熶竴锛屼互闄嶄綆瀹㈡埛绔殑鎺ュ叆鎴愭湰锛涘浜庢湇鍔＄锛屼娇鏈嶅姟绔棤闇€鍏虫敞鎺ュ彛鏆撮湶鍦ㄥ叕缃戦潰涓寸殑闂鑰岀潃鐪间簬涓氬姟鐨勫疄鐜帮紝鏉ユ彁鍗囧紑鍙戞晥鐜囥€?/p>

鍦ㄥ垰鍒氳繃鍘荤殑鍏ㄦ皯鐙傛璐墿鑺傦紝API缃戝叧濡備綍鍋氭墠鑳介珮鏁堢殑澶勭悊杩戝崈涓囩殑骞跺彂璇锋眰鏄湰鏂囩殑閲嶇偣銆?/p>

2

 API缃戝叧浠嬬粛

API缃戝叧锛屼綔涓哄鎴风涓庢湇鍔＄鐨勭航甯︼紝鏍稿績浠诲姟鏄皢瀹㈡埛绔姹傝浆鍙戝埌鍚庣鏈嶅姟銆備絾鏄紝浣滀负鎵€鏈夋祦閲忚姹傜殑鍏ュ彛 , 闈复鐨勫緢閲嶈鐨勪竴涓棶棰樺氨鏄珮骞跺彂锛屽洜涓洪珮骞跺彂鐨勯渶瑕侊紝瑕佹眰缃戝叧澶勭悊璇锋眰蹇呴』楂樻晥锛涘叾娆℃槸瀹夊叏闃叉姢锛屽畨鍏ㄤ富瑕佹槸鎸囧缃戝叧瀵瑰悗绔湇鍔＄殑涓€涓繚鎶わ紱鍐嶈€呭氨鏄畬鍠勭殑鏁版嵁缁熻鍙婄洃鎺ф姤璀︽満鍒讹紱褰撶劧锛屼负浜嗘柟渚挎垜浠唴閮ㄧ敤鎴锋帴鍏ワ紝澶氬崗璁€傞厤鐨勬敮鎸併€佺伆搴﹀彂甯冧笂绾夸篃鏄繀澶囧姛鑳姐€?/p>

API缃戝叧鐗瑰緛锛?/p>

1锛夐珮鎬ц兘锛氬湪楂樺悶鍚愰噺涓嬩繚璇佷綆寤惰繜銆?/p>

2锛夊畨鍏ㄧǔ瀹氾細韬唤璁よ瘉銆佺簿缁嗗寲娴侀噺鎺у埗銆佸ぇ鏁版嵁瀹炴椂鍒嗘瀽绛夊绉嶆墜娈典繚闅滄湇鍔¤川閲忋€?/p>

3锛夊钩鍙板寲锛氳繘琛屽悇椤规暟鎹洃鎺э紝鎻愪緵鏁版嵁鍒嗘瀽銆佺洃鎺у憡璀︺€佹晠闅滃畾浣嶇瓑鏈嶅姟銆?/p>

4锛夌伆搴︼細鐏板害鍙戝竷锛屾敮鎸佹寜璁惧銆丳IN銆佽嚜瀹氫箟姣斾緥鏂瑰紡鍦ㄤ笉褰卞搷姝ｅ父鐢ㄦ埛鐨勬儏鍐典笅锛屼繚闅滃悗绔湇鍔″钩绋宠繃娓°€?/p>

5锛夋柟渚垮揩鎹凤細鏀寔http銆乯sf鏈嶅姟蹇嵎鎺ュ叆锛宮ock鍔熻兘鍔犲揩鍗忓悓寮€鍙戙€?/p>

鎶€鏈疄璺?

API缃戝叧鏈嶅姟浜庡師鐢熷鎴风銆乄eb銆佸皬绋嬪簭锛屼笉闄愪簬鍏蜂綋鐨勪笟鍔°€傚叾涓昏鏋舵瀯鍥惧涓嬫墍绀猴細

涓昏鍒?灞傦細

• 绗?鏄疺IP灞傦紝涓昏鏄帴鏀跺鎴风http銆乭ttps璇锋眰锛屽苟灏嗚姹傝浆鍙戝埌缃戝叧锛?
• 绗?鏄綉鍏冲眰锛屽璇锋眰杩涜鍚堟硶鎬ф牎楠屽苟杞彂锛?
• 绗?灞傚氨鏄悗绔笟鍔PI锛岃繖浜涗笟鍔℃柟锛屽氨鏄垜浠湇鍔＄殑涓昏瀵硅薄銆?

1

楂樺苟鍙戝疄鐜?

缃戝叧楂樺苟鍙戝疄璺典富瑕佸埄鐢ㄥ紓姝ュ寲澶勭悊鎶€鏈紝灏嗚姹傜敱鍚屾鍙樹负寮傛锛屽埄鐢∟IO澶氳矾澶嶇敤锛岃揪鍒拌姹傛帴鏀舵渶澶у寲銆?/span>

棣栧厛鐪嬩笅鍥惧悓姝ュ鐞嗚繃绋嬶細

閲囩敤鍚屾澶勭悊锛岀嚎绋嬬殑閲婃斁灏卞彈闄愪簬鍚庣鏈嶅姟鍝嶅簲鐨勫揩鎱€傚綋鍝嶅簲杩囨參鏃讹紝绾跨▼姹犲氨瀹规槗鍑虹幇鑰楀敖鐜拌薄锛屽苟涓旇祫婧愬埄鐢ㄧ巼涓婁笉鍘伙紝鍚炲悙閲忓緢浣庯紝鎴栬€呰姝ゆ椂鐨勫ぇ閲忚姹傞兘浼氳鏈嶅姟鍣ㄦ嫆缁濄€?/p>

鐢辨鍙互鐪嬪嚭锛屽悓姝ュ鐞嗕娇璧勬簮鍒╃敤鐜囧緱涓嶅埌鍏呭垎鐨勫埄鐢紝澶ч噺璇锋眰琚嫆缁濆悓鏃跺張褰卞搷浜嗙敤鎴蜂綋楠屻€傚鏋滄兂鎻愰珮骞跺彂鍙兘閫氳繃妯悜鍔犳満鍣紝杩欐牱閫犳垚鏈哄櫒璧勬簮澶ч噺娴垂鐨勭幇璞°€傚鏋滄槸缃戝叧杩欎箞澶勭悊锛岄偅涔堣繖绉嶇幇璞′綋鐜扮殑灏嗘洿鏄庢樉銆?/p>

涓轰簡瑙ｅ喅鍚屾寮曡捣鐨勯棶棰橈紝閲囩敤寮傛锛屽涓嬪浘鎵€绀猴細

閫氳繃瀹炵幇寮傛鍖栧鐞嗭紝绾跨▼鍙互鍦ㄥ紑鍚紓姝ュ悗鐩存帴閲婃斁锛屽綋鍓嶈姹傜殑鍝嶅簲浼氳寤跺悗锛屽綋鍚庣鏈嶅姟鏈夊搷搴斿悗锛屽啀灏嗗搷搴斿啓鍥炵粰瀹㈡埛绔€傝繖鏍峰氨绠楁槸鏈夊悗绔湇鍔″搷搴斿緢鎱紝鍥犱负绾跨▼宸茶閲婃斁浜嗭紝鍙互缁х画鎺ユ敹鏂扮殑璇锋眰锛岃揪鍒版湇鍔¤祫婧愪娇鐢ㄧ殑鏈€澶у寲銆?/p>

2

瀹夊叏闃叉姢

绮剧粏鍖栨祦鎺э細

浣滀负鎵€鏈変笟鍔℃柟鐨勭涓€閬撻槻绾匡紝缃戝叧鎵胯浇鐫€娴烽噺娴侀噺鐨勮闂紝浠ュ強闅忔椂鍙兘鐖嗗彂鐨勬伓鎰忔祦閲忔敾鍑荤殑鍘嬪姏銆?/p>

寰堝吀鍨嬬殑锛屾瘡骞村弻鍗佷竴鎴栨槸618閮戒細鏈夊埛瀛愭伓鎰忓埛鍚庣鏈嶅姟鎺ュ彛锛屽鏋滅綉鍏充笉鍋氬鐞嗙洿鎺ュ皢娴侀噺閫忎紶鍒板悗绔湇鍔★紝鍚庣鏈嶅姟寰堝ぇ鍙兘浼氳鐬椂娴侀噺鍐插灝锛岃嚦灏戜細澧炲ぇ鍚庣鏈嶅姟鍝嶅簲寤舵椂鍙婃氮璐瑰叕鍙稿ぇ閲忚祫婧愭潵澶勭悊鏀诲嚮銆?/p>

閭ｄ箞锛岃繘琛屾祦閲忔帶鍒跺氨鏄繀涓嶅彲灏戠殑銆傜綉鍏虫彁渚涚绾х殑娴侀噺鎺у埗锛屽彲浠ュ鍗曚釜鎺ュ彛鎸夊湴鍩熴€侀鎺х瓑绾х瓑缁村害杩涜娴佹帶閰嶇疆銆傝繖鏍锋祦閲忓彧鍒颁簡缃戝叧灞傞潰锛屽氨涓嶄細閫忎紶鍒板悗绔湇鍔′簡銆?/p>

娴佹帶涓昏鏄噰鐢ㄤ护鐗屾《绠楁硶瀹炵幇锛岀瓥鐣ヤ富瑕佹湁鎺掗槦鎴栫啍鏂紝鍏蜂綋鐨勭瓥鐣ユ牴鎹笉鍚岀殑绔紝閫夋嫨鍚堥€傜殑娴佹帶鍔ㄤ綔銆?/p>

      

鎺堟潈鍙婄鍚嶈璇侊細

API鏆撮湶鍦ㄥ叕缃戯紝鑲畾浼氬瓨鍦ㄨ鍒风殑椋庨櫓锛岀綉鍏宠鍋氱殑灏辨槸灏藉彲鑳介檷浣庤繖绉嶉闄┿€傚氨鍍忛€氳繃鍒跺畾娉曞緥鏉ュ敖鍙兘鍑忓皯鐘姜涓€鏍凤紝閫氳繃璁块棶鏉冮檺鎺у埗銆佺鍚嶈璇併€佽法鍩熸牎楠岀瓑鏉ュ敖鍙兘鐨勯檷浣嶢PI鎺ュ彛琚埛鐨勯闄┿€?/p>

鎺堟潈锛氬彧鏈夐€氳繃API璐熻矗浜烘巿鏉冪殑鎺ュ彛锛屽鎴风鎵嶆湁鏉冮檺璁块棶 銆傚鏋滄湭鎺堟潈锛屽湪缃戝叧澶勬嫤鎴紝鍝嶅簲缁欏鎴风娌℃湁璁块棶鏉冮檺锛?/p>

绛惧悕璁よ瘉锛氭寜瑙勫垯灏嗚姹傚弬鏁伴€氳繃HMAC-SHA256绠楁硶杩愮畻鐢熸垚绛惧悕鍊硷紝瀵瑰鎴风璁＄畻鐨勭鍚嶅€间笌缃戝叧璁＄畻鐨勭鍚嶅€艰繘琛屽尮閰嶏紝鍖归厤鐨勮姹傜户缁悜涓嬫祦杞紝鍚﹀垯鐩存帴琚嫤鎴€?/p>

璺ㄥ煙鏁堥獙锛?/strong>

瀵逛簬WEB绔簲鐢紝璋冪敤缃戝叧灞炰簬璺ㄥ煙璇锋眰銆傝繖绫昏姹傦紝濡傛灉涓嶈繘琛屾牎楠岋紝浼氫骇鐢熻法鍩熸敾鍑汇€傛墍浠ラ渶瑕佽幏鍙栧埌瀹㈡埛绔姹傛潵婧愶紝瀵瑰鎴风璇锋眰鏉ユ簮杩涜璁よ瘉锛屽彧鏈夊悎娉曠殑璇锋眰鏉ユ簮鎵嶈鍏佽璁块棶鍚庣鏈嶅姟銆傚浜庡皬绋嬪簭搴旂敤锛屼篃浼氭牎楠屽皬绋嬪簭鐪熷疄鎬с€?/p>

3

鐏板害鍙戝竷

璁炬兂杩欐牱涓€涓満鏅細鏈変竴涓牳蹇冧笟鍔★紝鍋氫簡姣旇緝澶х殑鏀瑰姩锛屽張鎴栬€呮槸椤圭洰閲嶆瀯锛屽紑鍙戝畬鎴愶紝鍚屾椂娴嬭瘯瀹屾垚锛岃涓婄嚎浜嗐€備絾鏄紝闂涔熸潵浜嗭細鍥犱负鏀瑰姩寰堝ぇ锛屼笟鍔″緢閲嶈锛屾祴璇曟墍鎷挎満鍨嬭澶囨湁闄愶紝鎷呭績鐩存帴鍏ㄩ儴涓婄嚎浼氬奖鍝嶆祴璇曟湭瑕嗙洊鐨勭嚎涓婄敤鎴枫€傞偅涔堬紝鑳戒笉鑳藉厛鏈?0%鐨勬祦閲忚姹傚埌鏂版湇鍔★紝鐪嬩笅鐢ㄦ埛浣跨敤鎯呭喌锛屽啀鍐冲畾鏄惁鍏ㄩ儴涓婄嚎鍛€?/span>

涓轰簡婊¤冻杩欑闇€姹傦紝缃戝叧鎻愪緵鎸夎澶囧彿銆佺敤鎴锋爣璇嗙殑瀹氱偣鐏板害娴嬭瘯锛屽悓鏃舵敮鎸佹寜姣斾緥杩涜鐨勭伆搴︿笂绾裤€?/p>

鑷姩鍖栬繍钀?

鍦ㄩ珮涓惧彲鎸佺画鍙戝睍鏃楀笢鐨勬椂浠ｄ笅锛屽鏋滀竴涓骇鍝佷粎浠呭仛鍒板姛鑳介綈鍏ㄦ槸杩滆繙涓嶅鐨勩€傚彧鏈夊仛鍒板彲鎸佺画鍙戝睍锛屽疄鐜拌嚜鍔ㄥ寲杩愯惀鐨勪骇鍝佹墠鐪熸鏄釜濂戒骇鍝併€侫PI缃戝叧骞冲彴鍖栨剰鍛崇潃N鏉′骇鍝佺嚎锛屼竴涓綉鍏筹紝閫氳繃瀹炵幇鑷姩鍖栬繍钀ワ紝瑙ｆ斁鐢熶骇鍔涳紝鎵撻€犵粺涓€鍖栧钩鍙帮紝鎻愪緵鍙寔缁寲浜у搧锛屾嫢鎶盇PI缁忔祹锛屽疄鐜癆PI鍙樼幇銆?/p>

API缃戝叧鎺у埗鍙伴椤?/span>

1

鐙珛閮ㄧ讲涓庡揩閫熸墿灞?

  API缃戝叧缁熶竴绠＄悊鐫€鍙戝竷鏂瑰澶栨毚闇茬殑API鏈嶅姟锛屽悇涓湇鍔″彲浠ョ嫭绔嬪紑鍙戦儴缃层€傞拡瀵瑰悗绔湇鍔＄殑鍙戝竷涓庝笅绾匡紝鍙戝竷鏂瑰彲閫氳繃API缃戝叧鎻愪緵鐣岄潰鍖栫鐞嗘帶鍒跺钩鍙帮紝瀹炵幇娴佺▼鍖栫鐞嗭紝绾夸笂瀹℃壒閫氳繃鍚庯紝瀹炴椂鐢熸晥锛屾棤闇€鎵嬪姩鎺у埗锛屽疄鐜拌嚜鍔ㄥ寲杩愯惀銆?/span>

鍚屾椂瀵逛簬鍚庣鏈嶅姟鐨勫悇椤归厤缃紝濡侫PI鏉冮檺绠＄悊銆佹祦閲忔帶鍒剁瓑锛孉PI缃戝叧杩涜鑷姩鍖栫鐞嗭紝鍔ㄦ€侀厤缃紝鍔ㄦ€佸姞杞斤紝淇濊瘉鍦ㄦ棤闇€閲嶅惎鏈嶅姟鐨勬儏鍐典笅鍗冲彲杩涜閰嶇疆鏇存敼鎿嶄綔銆?/p>

瑕佸疄鐜拌嚜鍔ㄥ寲杩愯惀锛岄櫎浜嗗API鏈嶅姟绠＄悊鍋氬埌鐙珛閮ㄧ讲銆佸揩閫熸墿灞曞锛屽浜嶢PI鐨勮皟鐢ㄦ柟涔熷疄鐜拌嚜鍔〢PI寮€閫氾紝鎺堟潈璁块棶API鏈嶅姟銆?/p>

2

鏁版嵁鍒嗘瀽涓庣洃鎺у憡璀?

鐢变簬API缃戝叧澶勫湪涓€涓唴閮ㄧ郴缁熶笌澶栭儴鐜鐨勫垎鐣岀偣澶勶紝鎵€鏈夊閮ㄨ姹傞兘缁忚繃API缃戝叧杩涜璋冨害鍜岃繃婊わ紝姣忔椂姣忓埢閮芥湁澶ч噺璇锋眰閫氳繃API缃戝叧杩涘叆鍐呴儴鏈嶅姟銆傚洜姝ゅ彲浠ュ湪API缃戝叧灞傝繘琛岃姹傛帴鍏ョ洃鎺э紝鐩戞帶鍚勪釜鎺ュ彛鐨勮闂姹傚苟杩涜鏀堕泦锛屼互渚跨浉搴旀寚鏍囩殑缁熻鍒嗘瀽銆?/span>

鍦ˋPI缃戝叧鐣岄潰鍖栫鐞嗘帶鍒跺钩鍙颁腑锛屽鏀堕泦缁熻鍒扮殑鐩戞帶鏁版嵁锛屽API鎺ュ彛璋冪敤閲忋€佸搷搴旀椂闂寸瓑淇℃伅锛屾彁渚涗簡鍙鍖栫殑API瀹炴椂鏅鸿兘鏁版嵁鍒嗘瀽涓庣洃鎺у憡璀﹀姛鑳斤紝璁㈤槄API寮傚父鎶ヨ淇℃伅锛屼互渚垮疄鏃剁洃鎺у悗绔湇鍔¤繍琛屾儏鍐点€?/p>

鍚庣鎺ュ彛鐩戞帶鏁版嵁鍥?/span>

3

绾夸笂鐜鏁呴殰瀹氫綅

褰撳彂鐢熺嚎涓婃晠闅滄椂锛孉PI缃戝叧鎻愪緵涓€绯诲垪鐨勬晠闅滅幇鍦鸿繕鍘熸帾鏂借繘琛屾晠闅滅殑瀹氫綅涓庢帓鏌ワ紝閫氳繃鏃ュ織瀹炴椂鍒嗘瀽銆佸紓甯告祦閲忓疄鏃舵帰娴嬨€佺洃鎺у憡璀︾瓑鎶€鏈紝蹇€熸嬁鍒版晠闅滃揩鐓с€佽繕鍘熸晠闅滅幇鍦轰互鍙婅繀閫熷畾浣嶉棶棰樺師鍥犮€?/span>

鍚庣鎺ュ彛璋冭瘯鐣岄潰鍥?/span>