界面呢?事實(shí)上,大多數(shù)公司使用內(nèi)部接口,而第三方接口實(shí)際上使用較少。兩者的區(qū)別在于提供者不同。
接口實(shí)際上是一個解釋接口做什么的文件。無論是你公司內(nèi)部開發(fā),還是你和一些第三方合作的時候,產(chǎn)品經(jīng)理都必須知道如何閱讀接口文檔,以及哪些部分是重要的。
否則,不要談功能實(shí)現(xiàn),溝通會很困難...
了解一些基礎(chǔ)知識,善于溝通。
比如你們公司想做一個考勤系統(tǒng),想用人臉識別打卡,但是人臉識別可能技術(shù)上有點(diǎn)難度,所以我們決定用第三方。
找第三方,第三方可能會扔給你一個界面文檔給自己看。
這個時候你要知道這個界面提供了什么功能,需要用什么,你的界面能滿足什么思想,不能滿足什么思想。
比如有一種情況,人們經(jīng)常戴口罩或者墨鏡。在這個api接口提供的人臉識別打卡功能中,如果一個人戴上眼睛后還能打卡,就需要在他的文檔中找到,看他是否具備相應(yīng)的能力。
R&D還涉及到寫很多東西~比如接口文檔。
我來介紹一些概念:
請求參數(shù)
比如你需要讓阿里云給你發(fā)短信,你至少要告訴他你想發(fā)給哪個手機(jī)吧?這個手機(jī)號碼是請求參數(shù)。在請求接口的時候,你需要把這個請求參數(shù)給他。
請求與設(shè)計(jì)功能有關(guān),所以在產(chǎn)品設(shè)計(jì)時需要考慮如何請求這些參數(shù)。在檢查接口文檔時,注意是否所有的請求參數(shù)都已寫入也很重要。
與請求參數(shù)相對應(yīng)的是返回參數(shù)。
請求完成后,它會告訴你是否發(fā)送成功。如果成功,則返回查詢的信息,如果失敗,則報(bào)錯。比如你查詢一個訂單或者一個產(chǎn)品頁面的詳細(xì)信息,界面需要把產(chǎn)品查到的產(chǎn)品的關(guān)鍵信息返回給你。這是返回參數(shù)。一般工作中會有很多“回歸參數(shù)”。
一般會返回多個字段,但是我們需要知道它的字段在接口文檔中是什么意思,比如參數(shù)名是什么,類型是什么;如果有錯誤,它會給你一些錯誤代碼。比如你下一筆支付訂單,前端調(diào)用時返回錯誤403,然后你看這個時候的接口文檔就知道403是什么意思了。
界面可以是word,txt等。形式并不重要,但關(guān)鍵是需要很好地理解文檔中最關(guān)鍵的七個步驟:
1.接口描述:簡要描述接口的功能。
2.接口地址是什么?
如果接口被公開給其他人使用,它必須有一個地址。一定要知道請求的地址是什么,也就是請求的網(wǎng)址是什么。
3.調(diào)用時的方法類型是什么?
本文將介紹Pose或get。
post和get有什么區(qū)別?傳輸get請求時,URL的后面會附上URL地址,也就是說URL上會有請求參數(shù),get請求的參數(shù)長度有限;post請求的參數(shù)不會顯示在URL中。
4