步驟1:確定需要什么API
您正在尋找什么信息或想要更改什么信息?
您是要抓住@dougthepug的所有Instagram帖子嗎?也許您想自動追蹤任何關(guān)注您狗的推特的人(因為即使狗不會說話,他們也有很多話要說,我們知道Slash肯定會這樣)。
如果您已經(jīng)知道該網(wǎng)站或要連接的API,請直接轉(zhuǎn)到第2步。如果您要查找數(shù)據(jù),但不確定從哪里開始,那么Google是您的朋友。搜索“ [您感興趣的東西] API”,然后看看會發(fā)生什么。您可能會感到驚訝,那里有多少信息。
如果您想要一個簡單的示例API,則可以使用在訓(xùn)練Slash時制作的一個Michelle。它具有他最喜歡的一些命令,例如取回球和挖洞。
第2步:查找API文檔
知名公司提供的API應(yīng)該具有有關(guān)如何使用它們的詳盡文檔。
要找到這些文檔,請使用Google“ [Insert Company] API文檔”或“ [Insert Company]開發(fā)人員”。
結(jié)果應(yīng)帶您進入開發(fā)人員門戶。在“文檔”,“文檔”,“參考”或“技術(shù)參考”中查找鏈接。
在文檔中,您有時可能需要查找所需的特定API。很多選擇。例如,F(xiàn)acebook有用于營銷,廣告,頁面等的單獨的API。
如果您要連接的API不為人所知(例如Slash的API),則可能需要向開發(fā)人員咨詢文檔。他們可能有包含所需信息的PDF或未在其網(wǎng)站上列出的在線文檔。
如果您錯過了上一步中的鏈接,可以在此處找到Slash的API文檔。
第3步:找到端點
API文檔可能看起來令人生畏,但是一旦您知道要查找的內(nèi)容,它們通常結(jié)構(gòu)良好且
首先要尋找的是適當?shù)亩它c。應(yīng)該有一個與您想要的每種數(shù)據(jù)類型相對應(yīng)的端點。端點可能看起來像這樣:
https://slashtheapidog.com/api/bones/{id}
,或者僅僅是
/bones
文檔應(yīng)該有一個端點列表。它們可能是文檔中的最高級別,也可能位于“參考”,“端點”或“方法”部分下。要找到正確的端點,請查找與您要查找的數(shù)據(jù)相對應(yīng)的名稱。例如,如果要列出Slash已挖出的所有孔的列表,則/holes可能是正確的。無論如何,每個端點都應(yīng)有描述以幫助解釋其作用。
從他的文檔中可以看出,這些是Slash API中與孔有關(guān)的端點:
GET https://slashtheapidog.com/api/holes GET https://slashtheapidog.com/api/holes/{id} POST https://slashtheapidog.com/api/holes PUT https://slashtheapidog.com/api/holes/{id} POST https://slashtheapidog.com/api/holes/{id}
步驟4:確定您的請求類型
現(xiàn)在您已經(jīng)找到了正確的端點,需要確定發(fā)送請求的類型。
有4種不同類型的請求:
GET
GET請求是您要求API用它具有的東西(通常是數(shù)據(jù))進行響應(yīng)的方式。您可以根據(jù)端點和參數(shù)詢問有關(guān)一項或一組項目的特定信息。這等效于要求Slash為您帶來他的一根骨頭或所有骨頭。
POST
POST請求是您告訴API創(chuàng)建新內(nèi)容的方式。這類似于要求Slash為您挖(創(chuàng)建)一個新孔。
PUT
PUT請求是您如何告訴API更新以前創(chuàng)建的內(nèi)容。這類似于要求Slash深入(更新)他所挖的孔。
Delete
DELETE請求是告訴API刪除以前創(chuàng)建的內(nèi)容的方式。這類似于要求Slash掩蓋(刪除)他先前挖的一個孔。
考慮這四種類型。您是否正在獲取信息,創(chuàng)建新條目,更改現(xiàn)有條目或刪除條目?該答案將準確告訴您所需的請求類型。
步驟5:了解參數(shù)
許多請求都需要其他參數(shù)。參數(shù)是您的請求的詳細信息。例如,如果您希望Slash為您帶來所有紅色的球,則需要指定顏色。如果要他創(chuàng)建一個新孔,則需要告訴他將孔放置在何處以及挖掘的深度。
您所引用的API文檔中應(yīng)有一個名為“參數(shù)”或“選項”的部分。每個端點和請求類型。注意哪些參數(shù)是必需的,因為有些是可選的。如果參數(shù)被標記為可選,則文檔可能會提供一個默認示例。
Slash的API參數(shù)看起來像這樣以檢索鋼球:
GET https://slashtheapidog.com/api/balls
第6步:格式化請求
我們已經(jīng)獲得了所需的所有信息,現(xiàn)在我們只需要請求!
這里有兩種不需代碼即可連接到API的方法。讓我們連接到Slash的API,以向https://slashtheapidog.com/api/balls
Parabola發(fā)出GET請求,以獲取他的球列表-如果您要連接并使用無代碼的數(shù)據(jù)
Parabola是一個網(wǎng)絡(luò)應(yīng)用程序,可讓您輕松連接到API,然后通過可視化的拖放工具來處理數(shù)據(jù)。
查看示例Parabola flow Slash示例
在https://parabola.io上創(chuàng)建一個免費帳戶。
創(chuàng)建您的第一個流程。
li》
找到“ API導(dǎo)入”源并將其拖到屏幕上。
雙擊“ API導(dǎo)入”以更改其設(shè)置。
輸入要使用的端點,在這種情況下:https://slashtheapidog.com/api/balls
點擊“更新設(shè)置”,然后Parabola將發(fā)出GET請求!您應(yīng)該會看到響應(yīng)數(shù)據(jù)顯示在設(shè)置右側(cè)的區(qū)域中。
郵遞員—如果您想測試API請求并且不需要對數(shù)據(jù)做太多操作
Postman是用于記錄和測試API的應(yīng)用程序。
下載郵遞員:https://www.getpostman.com/downloads/。
創(chuàng)建新請求。
選擇請求類型,在這種情況下:GET。
輸入端點URL,在這種情況下:https://slashtheapidog.com/api/balls
點擊發(fā)送。
您的響應(yīng)將顯示在底部的“響應(yīng)”部分。
步驟7:使用數(shù)據(jù)
現(xiàn)在您已經(jīng)有了一些數(shù)據(jù)(GET)或已經(jīng)能夠使API采取措施(POST,PUT或DELETE),您可能會希望對數(shù)據(jù)進行某些處理。 API的真正威力來自于您使用它們的方式。
能夠要求Slash一次為我們?nèi)」穷^是一件很棒的事,我們當然想和他一起玩。但是想像一下,Slash擁有數(shù)百根骨頭,而我們的目標是安全地埋葬并記錄他的所有骨頭。為了有效地做到這一點,我們需要將動作鏈接在一起。
這只是一個示例,但是希望您可以開始理解能夠以編程方式使用API來構(gòu)建更復(fù)雜的鏈接鏈的影響。動作和數(shù)據(jù)。可以通過代碼或使用如上所述的工具來完成。
責(zé)任編輯:wv
-
API
+關(guān)注
關(guān)注
2文章
1502瀏覽量
62101
發(fā)布評論請先 登錄
相關(guān)推薦
評論