第⼀一次使⽤用���COIMOTION���

就上⼿手

2014.07.02修訂版 Gocharm  Inc.

Before  We  Get  Started…  

上網申請⼀一個開發者帳號（tw.coimotion.com）

都好了嗎？讓我們開始吧…

請先看過COIMOTION概念介紹（h9p://slidesha.re/MPKlAr）

建⽴立你的App  

進⾸首⾴頁後點這裡，查看或建⽴立你的 App

＊如果你在2014.7.1後申請帳號，系統會同時幫你建⼀一個 App

Time Out!  

請注意，如果你已經有 client app （可能是系統⾃自動幫你建置的），可以不必再建⽴立新的 App。可以跳過下⼀一⾴頁的步驟（說明還是要看哦）

選擇App代碼 進⼊入App管理後，點選右上⽅方的新增鍵，出現如下視窗：

這個代碼將成為API網址的⼀一部分 因為在COIMOTION中，所有的API網址都有相同的格式： http://ca.coimapi.net/wa/rs/op/id 你在這裡所填的代碼，將取代網址中ca的部份

App建置成功了嗎 如果你建⽴立成功，就會出現類似以下的畫⾯面：

點選這裡，設定App的預設模組 模組讓你不需寫任何後端程式，就能提供眾多有趣的功能

設定模組

這⼆二個模組會被預設選定 「core」模組提供帳號申請和使⽤用者登錄的功能 「cms」模組提供網⾴頁管理的諸多功能

2. 點選「API」進去，可以 看到模組中各個API的 呼叫⽅方式

API使⽤用說明

URL: API的呼叫網址。格式中若出現[]，表⽰示必須填⼊入識別碼(id)

輸⼊入參數：解釋這個API可以有哪些輸⼊入參數

應⽤用程式⾦金鑰 剛才在P.6時若點選「編輯」，就可看到程式⾦金鑰

測試看看

以下是我們的測試計畫：

1. 取得 app 的 token

2. 利⽤用 cms 模組新增⼀一個網⾴頁

3. 再利⽤用 cms 模組把新增的網⾴頁讀回來

測試⼯工具

Command line⼯工具可考慮curl

習慣chrome瀏覽器的可使⽤用DHC這個chrome app

或是將API直接下到網路瀏覽器也可以

什麼是Token Token是App和COIMOTION平台間的短期契約

App能提出有效的token，才能獲准執⾏行API

COIMOTION致⼒力於⾼高標準的安全機制，token會被不定期更新

因為token會被不定期更新，以下範例僅限於測試⽤用。正式應⽤用請使⽤用SDK呼叫API。

關於獲取Token

平台在2014.4⽉月下旬全⾯面對網路上傳輸的密碼進⾏行 hash&salt 運算。原先透過登⼊入 app 再取得 token的

⽅方式已不再適⽤用。

請改⽤用以下介紹的⽅方法取得 token

取得Token 在「App管理」點選「編輯」，可以取得開發者個⼈人的token

點選這裡會秀出 你個⼈人的 token

組合 API API 格式⼀一定是：

http://ca.coimapi.net/wa/rs/op/id

•  ca: app 代碼，前⾯面解釋過 •  wa: 模組或內容集的代碼。在以下的範例中，我們會使⽤用

cms 這個模組。 •  rs: 模組下的資源。在以下的範例中，我們會使⽤用 cms 模組

下 page 這個資源，來處理網⾴頁維護的問題。 •  op: 對資源所執⾏行的動作。例如 cms/page/create 是新增

⼀一個網⾴頁，cms/page/view 是檢視⼀一個網⾴頁 •  id: 識別碼，不⼀一定需要。例如 cms/page/view/123，表

⽰示要檢視第123號的網⾴頁; cms/page/create 則不需識別碼

新增網⾴頁

title是網⾴頁標題 body是內⽂文 token⽤用來向COIMOTION認證⾃自⼰己

利⽤用cms模組所提提供的新增網⾴頁API（cms/page/create)

新增成功了嗎

errCode: 執⾏行錯誤碼。0以外的數字都代表錯誤。

message: 執⾏行正確與否的⽂文字說明。

value: 執⾏行結果。在這個例⼦子代表新增網⾴頁的識別碼

token: 怎麼⼜又出現token? 當COIMOTION認為有安全疑慮時，就會送出新的token。下⼀一個API call要改⽤用新的token。無法確定 token 的有效性時，⽤用 P.14的⽅方法取得 token。

把網⾴頁讀回來 ⽤用cms/page/view讀取網⾴頁，18509是新增網⾴頁的識別碼

下⼀一步

看看 COIMOTION 上還有什麼有趣的模組

到「內容寶庫」去看看有什麼有趣的內容可以引⽤用

客製⾃自⼰己的內容集，產⽣生⾃自⼰己的資料

範例到此成功。下⼀一步能做什麼？

關於程式⾦金鑰

呼叫API⼀一定要給有效的token，或是給應⽤用程式⾦金鑰

給應⽤用程式⾦金鑰只能存取公開的資料。私⼈人資料⼀一定要有當事⼈人的 token 才能存取

送應⽤用程式⾦金鑰的辦法： 在呼叫參數中加上_key=應⽤用程式⾦金鑰

That’s  it  for  now.  Thanks.