隨著ChatGPT和AI繪畫(huà)的爆火，市面上關(guān)于AI的工具型產(chǎn)品越來(lái)越多。作者從產(chǎn)品經(jīng)理角度，并結(jié)合自身經(jīng)驗(yàn)，分享從0到1設(shè)計(jì)企業(yè)的開(kāi)放平臺(tái)過(guò)程中，需要考慮哪些環(huán)節(jié)，如何設(shè)計(jì)并搭建開(kāi)放平臺(tái)？希望對(duì)你有所啟發(fā)。

本篇文章介紹了從產(chǎn)品經(jīng)理的角度，以作者親身經(jīng)歷，在從0到1設(shè)計(jì)企業(yè)的開(kāi)放平臺(tái)過(guò)程中，需要考慮哪些環(huán)節(jié)，搭建哪些基礎(chǔ)功能，技術(shù)接口設(shè)計(jì)，以及如何落地并推進(jìn)開(kāi)放平臺(tái)項(xiàng)目啟動(dòng)。

寫(xiě)在前面

隨著ChatGPT和AI繪畫(huà)的爆火，市面上越來(lái)越多的工具型產(chǎn)品繼而出現(xiàn)。

那么為這類(lèi)產(chǎn)品開(kāi)發(fā)以及設(shè)計(jì)者提供底層能力的OpenAI到底是什么公司？

實(shí)際上OpenAI是一家全球最著名的人工智能研究機(jī)構(gòu)，發(fā)布了許多著名的人工智能技術(shù)和成果，而這次爆火的ChatGPT便是OpenAI所研發(fā)的InstructGPT模型，這是一個(gè)AI對(duì)話(huà)系統(tǒng)，也是OpenAI對(duì)外開(kāi)放平臺(tái)收費(fèi)的API能力之一。

一、企業(yè)為什么需要搭建開(kāi)放平臺(tái)

什么是開(kāi)放平臺(tái)？

在互聯(lián)網(wǎng)時(shí)代，把網(wǎng)站的服務(wù)封裝成一系列計(jì)算機(jī)易識(shí)別的數(shù)據(jù)接口開(kāi)放出去，供第三方開(kāi)發(fā)者使用，這種行為就叫做Open API。

而提供開(kāi)放API的平臺(tái)本身就被稱(chēng)為開(kāi)放平臺(tái)。（狹義角度，本文后續(xù)將闡述當(dāng)前各個(gè)企業(yè)開(kāi)放平臺(tái)的定位區(qū)別）

企業(yè)為什么要搭建開(kāi)放平臺(tái)？

最早嘗到開(kāi)放平臺(tái)甜頭的公司是Facebook，扎克伯格所崇尚的開(kāi)放思維、群體智慧和創(chuàng)新精神匯聚到一個(gè)平臺(tái)。

Facebook搭建的開(kāi)放平臺(tái)，為網(wǎng)站源源不斷地注入群體開(kāi)發(fā)者的智慧，開(kāi)放戰(zhàn)略使得Facebook迅速脫穎而出，并且得以積聚人氣，為下一步的拓展、布局做好準(zhǔn)備。

開(kāi)放平臺(tái)的能力簡(jiǎn)而概之，就是將Facebook擁有的海量社交用戶(hù)檔案和關(guān)系數(shù)據(jù)，通過(guò)API開(kāi)放給第三方開(kāi)發(fā)者。

一般大廠做開(kāi)放平臺(tái)的目的：

• 平臺(tái)本身核心服務(wù)能力輸出（比如百度AI開(kāi)放平臺(tái)，文字識(shí)別、圖像技術(shù)等一系列的技術(shù)能力，場(chǎng)景方案、部署方案）
• 平臺(tái)延展服務(wù)能力引入，吸引各種服務(wù)商（ISV）在上面創(chuàng)建應(yīng)用，為客戶(hù)提供更豐富的解決方案（比如，拼多多的易掌柜、口碑的生態(tài)市場(chǎng)提供的各行業(yè)服務(wù)插件等等）。
• 形成平臺(tái)的生態(tài)圈以及影響力，為下一步布局做好準(zhǔn)備。

二、開(kāi)放平臺(tái)的分類(lèi)以及服務(wù)形式

1. 開(kāi)放平臺(tái)分類(lèi)

一類(lèi)是輸出自身海量的基礎(chǔ)數(shù)據(jù)，例如極速數(shù)據(jù)的API接口。

另外一類(lèi)則是輸出自身業(yè)務(wù)能力，例如高德地圖、微信、支付寶開(kāi)放平臺(tái)等。這種類(lèi)型緊貼業(yè)務(wù)場(chǎng)景的開(kāi)放平臺(tái)建設(shè)，按照業(yè)務(wù)能力形成一道護(hù)城河，也極大豐富了開(kāi)放平臺(tái)這個(gè)大家庭的種類(lèi)。本文也將重點(diǎn)闡述這種類(lèi)型的開(kāi)放平臺(tái)建設(shè)。

2. 服務(wù)形式

純API形式和H5形式：

如需引用請(qǐng)聯(lián)系作者

如需引用請(qǐng)聯(lián)系作者

兩種服務(wù)形式的優(yōu)勢(shì)和劣勢(shì)：

兩種服務(wù)形式各有優(yōu)劣勢(shì)，當(dāng)然目前市面上也有變種，即某些部分H5形式 某些接口api輸出。具體哪種形式建設(shè)開(kāi)放平臺(tái)，要依賴(lài)自身業(yè)務(wù)模式、團(tuán)隊(duì)情況、業(yè)務(wù)發(fā)展階段、系統(tǒng)穩(wěn)定性等諸多因素綜合考量。這也是開(kāi)放平臺(tái)建設(shè)者需要第一步考慮的事情。

以我建設(shè)的開(kāi)放平臺(tái)為例，最早在設(shè)計(jì)開(kāi)放平臺(tái)之初，需求方來(lái)自于技術(shù)以及商務(wù)，需要一個(gè)可以便捷管理接口，支持讓異業(yè)接入方能快速接入并且投入使用。那么基于這些考慮，最早第一版本的開(kāi)放平臺(tái)是只支持H5模式的輸出，一直迭代到2.0才支持API模式的輸出。業(yè)務(wù)方通常不會(huì)給太多的時(shí)間給到產(chǎn)品設(shè)計(jì)者，只有在保證業(yè)務(wù)模式清晰的基礎(chǔ)上，快速上線(xiàn)滿(mǎn)足業(yè)務(wù)方需求，才能有下次迭代。

三、開(kāi)放平臺(tái)設(shè)計(jì)

1. 整體架構(gòu)設(shè)計(jì)

如需引用請(qǐng)聯(lián)系作者

這里架構(gòu)設(shè)計(jì)按照市面主流開(kāi)放平臺(tái)的架構(gòu)來(lái)繪制，包括門(mén)戶(hù)中心、開(kāi)發(fā)者接入板塊、開(kāi)放能力運(yùn)營(yíng)板塊、運(yùn)維中心、API網(wǎng)關(guān)。

門(mén)戶(hù)中心：這里主要涉及到開(kāi)放平臺(tái)的訪(fǎng)問(wèn)入口，設(shè)計(jì)者需要考慮到有多少角色參與到開(kāi)放平臺(tái)里。一般正常最基礎(chǔ)的角色是 平臺(tái)運(yùn)營(yíng)者、開(kāi)發(fā)者，平臺(tái)提供api能力給開(kāi)發(fā)者接入。再次基礎(chǔ)上，較大規(guī)模的開(kāi)放平臺(tái)一般構(gòu)建一個(gè)大生態(tài)體系，那么對(duì)于API接口服務(wù)能力的提供不僅僅需要依靠自有能力，更加重要的就是要依賴(lài)于開(kāi)發(fā)商和合作伙伴的可共享能力接入。此時(shí)便有合作伙伴，也就是服務(wù)商的角色參與。

這里參考抖音的林客，本地服務(wù)商經(jīng)營(yíng)平臺(tái)：

開(kāi)發(fā)者接入板塊：這個(gè)版塊的主要使用角色是開(kāi)發(fā)者，此時(shí)眾多開(kāi)發(fā)者就是直接用戶(hù)。產(chǎn)品經(jīng)理在設(shè)計(jì)這個(gè)版塊的時(shí)候，需要考慮到各個(gè)類(lèi)型的開(kāi)發(fā)者。

用戶(hù)體驗(yàn)里面最重要的一個(gè)原則就是把用戶(hù)當(dāng)“傻子”，開(kāi)發(fā)者接入板塊要做到盡可能簡(jiǎn)明扼要，你面對(duì)的可能是剛從培訓(xùn)班出來(lái)的小白，或者是接入過(guò)無(wú)數(shù)接口的大佬。

這里重點(diǎn)闡述一下接口文檔板塊，一直以來(lái)接口文檔的維護(hù)相較于產(chǎn)品說(shuō)明文檔都會(huì)比較弱，強(qiáng)依賴(lài)于開(kāi)發(fā)者的描述，需要注意的是產(chǎn)品經(jīng)理可以適當(dāng)介入接口文檔的撰寫(xiě)，盡量做到文檔清晰易懂，重點(diǎn)注意事項(xiàng)需要標(biāo)明。

之前在做實(shí)際對(duì)接過(guò)程中，常有錯(cuò)誤返回的追述發(fā)現(xiàn)只是開(kāi)發(fā)者看漏了部分文檔參數(shù)。

開(kāi)放能力運(yùn)營(yíng)板塊：這里的用戶(hù)角色參與者較多，可能是平臺(tái)實(shí)際管理員、財(cái)務(wù)、客服、商務(wù)等。由于參與方較多，對(duì)該板塊的需求也會(huì)較為繁雜，產(chǎn)品經(jīng)理需要梳理好必要的功能建設(shè)。

運(yùn)維中心：運(yùn)維中心承擔(dān)了推動(dòng)開(kāi)放平臺(tái)正常往前的齒輪角色，這里部分開(kāi)放平臺(tái)會(huì)縮減部分，例如白名單管理、數(shù)據(jù)庫(kù)管理 這里在部分企業(yè)中，已經(jīng)被其它系統(tǒng)所承擔(dān)，復(fù)用這個(gè)版塊即可，無(wú)需重新建設(shè)。

API網(wǎng)關(guān)：網(wǎng)關(guān)可以說(shuō)是開(kāi)放平臺(tái)的核心，承擔(dān)了整個(gè)開(kāi)放平臺(tái)的流量入口，同時(shí)還要有足夠的系統(tǒng)容錯(cuò)能力。如上圖所示，網(wǎng)關(guān)包含應(yīng)用的校驗(yàn)、能力權(quán)限校驗(yàn)等功能。

市面上無(wú)論大廠還是中小廠的開(kāi)放平臺(tái)，或多或少都會(huì)在其中有部分體現(xiàn)。中小廠在考量到開(kāi)發(fā)能力，業(yè)務(wù)模式等因素，可以按照最基礎(chǔ)的板塊建設(shè)，但是涉及到安全中心這種必要板塊，產(chǎn)品經(jīng)理在設(shè)計(jì)開(kāi)放平臺(tái)之初就需要和公司安全部門(mén)進(jìn)行協(xié)商。防止開(kāi)放平臺(tái)被接口攻擊。

作為產(chǎn)品經(jīng)理的角色，不管是哪個(gè)階段設(shè)計(jì)開(kāi)放平臺(tái)，需要清晰自己業(yè)務(wù)開(kāi)放平臺(tái)的最終形態(tài)是什么，反推目前必要板塊的建設(shè)。反推之后，下一步才是進(jìn)行功能設(shè)計(jì)以及技術(shù)方案敲定。

2. 功能設(shè)計(jì)

由于我當(dāng)前項(xiàng)目涉及到api形式和H5形式，這里兩塊形式都會(huì)做一定的介紹，其中有部分重疊的設(shè)計(jì)思路就不予贅述。

在正式介紹功能設(shè)計(jì)之前，產(chǎn)品經(jīng)理需要明確一點(diǎn)開(kāi)放平臺(tái)的服務(wù)對(duì)象是誰(shuí)？

這里具體服務(wù)對(duì)象包括大型連鎖企業(yè)、中小企業(yè)、小微商家、有分銷(xiāo)能力商家、個(gè)人開(kāi)發(fā)者、合作伙伴服務(wù)商。

根據(jù)不同的服務(wù)對(duì)象，主流開(kāi)放平臺(tái)一般區(qū)分為，標(biāo)準(zhǔn)接入型開(kāi)放平臺(tái)（例如微信、支付寶開(kāi)放平臺(tái)）以及解決方案接入型開(kāi)放平臺(tái)（例如高德開(kāi)放平臺(tái)提供的解決方案）。

兩種開(kāi)放平臺(tái)的整體架構(gòu)不會(huì)有太大差別，但是具體對(duì)接流程、收費(fèi)模式、服務(wù)形式會(huì)有差別，在這個(gè)基礎(chǔ)上延展出來(lái)運(yùn)營(yíng)設(shè)計(jì)也會(huì)有所不同。這里需要產(chǎn)品經(jīng)理按照各自業(yè)務(wù)特性來(lái)進(jìn)行設(shè)計(jì)。

根據(jù)使用角色，延展出來(lái)主流開(kāi)放平臺(tái)主要解決以下幾個(gè)層面的需求：

• 開(kāi)發(fā)者需求，開(kāi)發(fā)者身份注冊(cè)、應(yīng)用申請(qǐng)與數(shù)據(jù)權(quán)限授權(quán)、開(kāi)發(fā)者獲取相關(guān)資料（接口文檔、使用說(shuō)明、對(duì)接人聯(lián)系方式等）
• 平臺(tái)管理需求，平臺(tái)方內(nèi)部管理，客戶(hù)管理，申請(qǐng)審核流程、服務(wù)配置、財(cái)務(wù)對(duì)賬管理、參數(shù)配置、角色分配等
• 業(yè)務(wù)需求，業(yè)務(wù)交易管理及統(tǒng)計(jì)看板、報(bào)表分析（涉及業(yè)務(wù)結(jié)算類(lèi)型，例如預(yù)充值或者CPS返傭）
• 安全層面需求，數(shù)據(jù)加密、應(yīng)用秘鑰、應(yīng)用接口權(quán)限控制、系統(tǒng)角色權(quán)限、訪(fǎng)問(wèn)黑白名單、字段脫敏等

如需引用請(qǐng)聯(lián)系作者

3. 功能設(shè)計(jì)說(shuō)明

（1）運(yùn)營(yíng)管理后臺(tái)

開(kāi)放平臺(tái)運(yùn)營(yíng)管理后臺(tái)主要是基于銷(xiāo)售、商務(wù)、運(yùn)營(yíng)者、財(cái)務(wù)的多端需求建成的管理后臺(tái)，其中功能需要能滿(mǎn)足接入申請(qǐng)審核、接入方管理、賬號(hào)管理、業(yè)務(wù)數(shù)據(jù)管理、文檔管理、工單管理。如果財(cái)務(wù)板塊有對(duì)賬以及開(kāi)票需求，還需要融合進(jìn)財(cái)務(wù)管理系統(tǒng)中的自動(dòng)對(duì)賬中心以及自動(dòng)開(kāi)票中心。

（2）開(kāi)發(fā)者門(mén)戶(hù)（接入方后臺(tái)）

開(kāi)發(fā)者門(mén)戶(hù)的入口一般來(lái)說(shuō)是網(wǎng)站為主，由于目前開(kāi)發(fā)者大部分通過(guò)搜索引擎來(lái)查詢(xún)，網(wǎng)站的包裝也比較重要。門(mén)戶(hù)網(wǎng)站的主要功能職責(zé)就是幫助開(kāi)發(fā)者用戶(hù)了解開(kāi)放平臺(tái)的能力，幫助企業(yè)或者開(kāi)發(fā)者做到什么，引導(dǎo)用戶(hù)進(jìn)行注冊(cè)。

一般主流開(kāi)放平臺(tái)會(huì)選擇云服務(wù)控制臺(tái)給到開(kāi)發(fā)者進(jìn)行應(yīng)用的申請(qǐng)、賬戶(hù)充值等操作，控制臺(tái)一般需要承載能力簽約、賬戶(hù)充值、文檔下載檢索、業(yè)務(wù)數(shù)據(jù)查看等多項(xiàng)功能。

（3）后端安全中心

開(kāi)放平臺(tái)的后端安全中心要解決的問(wèn)題主要由兩個(gè)：由接口調(diào)用一定會(huì)碰到的數(shù)據(jù)安全以及相關(guān)鑒權(quán)。這里做安全的小伙伴一定比我更專(zhuān)業(yè)，產(chǎn)品經(jīng)理需要和運(yùn)維中心、安全部門(mén)同事協(xié)商考慮好開(kāi)放平臺(tái)的后端安全中心建設(shè)。

四、技術(shù)接口設(shè)計(jì)

這里主要是基于目前項(xiàng)目的技術(shù)方案做的接口設(shè)計(jì)，當(dāng)然市面上已經(jīng)有很多技術(shù)大佬寫(xiě)過(guò)的開(kāi)放平臺(tái)技術(shù)設(shè)計(jì)方案，我這里不做過(guò)多的描述。產(chǎn)品經(jīng)理了解大概的實(shí)現(xiàn)原理即可，這里更多需要關(guān)注的是接口在設(shè)計(jì)時(shí)候，作為開(kāi)發(fā)者接入時(shí)候的開(kāi)發(fā)成本，提高開(kāi)發(fā)者的用戶(hù)體驗(yàn)，我從這個(gè)角度來(lái)闡述下接口設(shè)計(jì)原則。

1. 接口簡(jiǎn)潔性

這里要考慮到，由于不同業(yè)務(wù)輸出的復(fù)雜程度，會(huì)導(dǎo)致接口數(shù)量指數(shù)級(jí)飆升。如果是純API接入的開(kāi)發(fā)者，在理解接口調(diào)用時(shí)序圖時(shí)會(huì)花更多時(shí)間。嘗嘗會(huì)在實(shí)際調(diào)用時(shí)卡在莫名其妙的節(jié)點(diǎn)，這里就需要只輸出必要接口，并且保證接口足夠簡(jiǎn)介易懂。

由于開(kāi)發(fā)平臺(tái)建設(shè)方，未必有足夠資源建設(shè)SDK中心，那么對(duì)于開(kāi)發(fā)者來(lái)說(shuō)就不是那么友好，因此純API接入文檔的接口和調(diào)用方式需要保證和主流接口有一定相似性，最大程度確保開(kāi)發(fā)者能快速熟悉接口。

2. 接口兼容性

這里主要是考慮到，不同開(kāi)發(fā)者應(yīng)用的平臺(tái)不同。例如某些專(zhuān)門(mén)輸出給硬件廠商的開(kāi)放平臺(tái)，此時(shí)就需要考慮到應(yīng)用設(shè)備前端版本不同，對(duì)應(yīng)參數(shù)范圍也會(huì)造成差異。這里可以考慮各自業(yè)務(wù)具體形式來(lái)設(shè)計(jì)。

五、運(yùn)營(yíng)設(shè)計(jì)

開(kāi)放平臺(tái)的成功運(yùn)行，離不開(kāi)良好的平臺(tái)運(yùn)營(yíng)。那么這里需要對(duì)平臺(tái)運(yùn)營(yíng)的各個(gè)環(huán)節(jié)進(jìn)行流程設(shè)計(jì)，確保每個(gè)環(huán)節(jié)都保證足夠高效。

這里我貼上一份目前項(xiàng)目開(kāi)放平臺(tái)的對(duì)接流程示意圖

如需引用請(qǐng)聯(lián)系作者

大部分商業(yè)化的開(kāi)放平臺(tái)項(xiàng)目可以基于上述流程做變更。

需要注意的是，業(yè)務(wù)輸出特性不同，會(huì)影響運(yùn)營(yíng)參與角色不同。比如我所在項(xiàng)目，實(shí)際運(yùn)營(yíng)人員還包括了客服，因?yàn)樾枰玫娇头芰鉀Q接入方平臺(tái)的客訴問(wèn)題。那么次數(shù)處理流程里面就需要包含客服處理流程。以及產(chǎn)品需要針對(duì)業(yè)務(wù)，給內(nèi)部客服部門(mén)做客服文檔，提供客服sop，優(yōu)化處理流程。

六、落地細(xì)節(jié)

撰文過(guò)程中，考慮到開(kāi)放平臺(tái)建設(shè)的通用性，沒(méi)有將建設(shè)的很多細(xì)節(jié)寫(xiě)出來(lái)，這里我單獨(dú)加一個(gè)板塊來(lái)介紹，希望給平臺(tái)設(shè)計(jì)者避坑。

需要明確開(kāi)放平臺(tái)的核心用戶(hù)是誰(shuí)？大部分人的第一反應(yīng)，核心用戶(hù)一定是開(kāi)發(fā)者。其實(shí)這個(gè)答案可以說(shuō)是也可以時(shí)候不是，由于B端商業(yè)化商品的特殊性，大部分產(chǎn)品設(shè)計(jì)出來(lái)是給到某一類(lèi)角色用的（而非具體某個(gè)人），開(kāi)放平臺(tái)的使用用戶(hù)角色大部分是開(kāi)發(fā)者，這點(diǎn)沒(méi)錯(cuò)。

然而，實(shí)際上為這個(gè)商業(yè)產(chǎn)品買(mǎi)單的用戶(hù)，大部分情況下是公司決策者，這里就代表，如果需要這個(gè)平臺(tái)持續(xù)被買(mǎi)單，需要滿(mǎn)足的核心用戶(hù)實(shí)際上是公司決策者。

舉個(gè)例子，只要是打過(guò)工的小伙伴大部分都過(guò)釘釘打卡這樣類(lèi)似功能。這個(gè)產(chǎn)品本質(zhì)上是B端產(chǎn)品，有簽到的功能，簽到的時(shí)候直接可以定位，對(duì)員工而言這簡(jiǎn)直就是個(gè)反人性的功能，員工作為個(gè)體本身是很排斥打卡的，釘釘卻把打卡功能延展了各種反作弊的功能（比如定位、面容識(shí)別），可沒(méi)辦法誰(shuí)讓釘釘是個(gè)B端產(chǎn)品。

所以B端產(chǎn)品就算體驗(yàn)不好，甚至是反人性的，只要管理者覺(jué)得達(dá)成了管理目標(biāo)，你就要必須使用系統(tǒng)，因?yàn)槟悴皇悄阕约?，你是企業(yè)的一份子。

企業(yè)決策者最關(guān)心的問(wèn)題，實(shí)際上是開(kāi)放平臺(tái)的能力是否能給企業(yè)降本增效，當(dāng)然并不是說(shuō)不需要關(guān)心開(kāi)發(fā)者的用戶(hù)體驗(yàn)，而是平臺(tái)設(shè)計(jì)者需要把更多的時(shí)間花在企業(yè)決策者的考慮角度上，要滿(mǎn)足為你付費(fèi)的用戶(hù)的核心需求。

七、后記

感謝能堅(jiān)持看到最后的各位，開(kāi)放平臺(tái)的建設(shè)是一個(gè)長(zhǎng)期的過(guò)程，中間會(huì)經(jīng)歷多次迭代，甚至由于公司的業(yè)務(wù)的調(diào)整影響開(kāi)放平臺(tái)的基礎(chǔ)能力的建設(shè)。

設(shè)計(jì)者除了要為功能負(fù)責(zé)之外，更多的是陪伴開(kāi)放平臺(tái)的成長(zhǎng)，開(kāi)放平臺(tái)的概念最早形成于2010年左右，目前各大互聯(lián)網(wǎng)平臺(tái)都有自己的開(kāi)放平臺(tái)生態(tài)，服務(wù)了無(wú)數(shù)開(kāi)發(fā)者以及企業(yè)。隨著OpenAI的火爆，相信平臺(tái)建設(shè)者都逐漸致力于形成自己平臺(tái)的護(hù)城河，為企業(yè)提供更多元化，更有意思的能力。我作為建設(shè)者之一，也很希望看到中小廠利用核心能力建設(shè)開(kāi)放平臺(tái)，也希望本文能幫助到各位建設(shè)者。