Swagger for Web API Document – Part Ⅱ

相信經過上一篇文章的介紹,
各位讀者對於在 Asp.Net Web API 中整合 Swagger 的應用已經有了一定的基礎,
(回顧: Swagger for Web API Document – Part Ⅰ
接下來我們將更進一步地介紹如何讓 Swagger 支援 API Key / Token, 以及在 UI 上呈現 API 的 Request / Response Examples, 透過這些進階整合, 提供使用者更友善的操作體驗:

繼續閱讀 “Swagger for Web API Document – Part Ⅱ”

Swagger for Web API Document – Part Ⅰ

以往,
我們在開發 API 的過程中,
通常需要提供一份接口文件給其他團隊瀏覽或測試,
而這份文件往往都需要花費大量時間與成本在專案開發中、後期來完成它,
最近剛好小編也正著手開發一個新的 Web API 專案,
有預先針對 API Document 的實作進行 Survey,
希望能在開發 API 的同時即能產出一份「符合 RESTful API 規範的線上文件」,

繼續閱讀 “Swagger for Web API Document – Part Ⅰ”

更新 Mac App 憑證

更新 Mac App 相關憑證

當 Mac App 憑證( provisioning profile ) 要過期之前,我們要有一個更新憑證的 SOP,避免新的使用者 下載到過期的 Mac App 造成無法順利安裝 的狀況發生。
在這篇文章中,我們會紀錄 mac distribution app ( 非 app store app ) 的詳盡更新步驟。

繼續閱讀 “更新 Mac App 憑證”

使用 IoC 進行專案的客製

前言

在進行新專案的開發時,我們通常會用一個已經做好的產品當作基底開始實作給新客戶的需求,而在開發的過程中必定會有一部份是只有某間公司需要而其他公司不需要的功能,這時候就要進行所謂的客製,而客製又分為

1. 在產品上沒有,純粹新增功能

2. 在產品上有,但需要針對客製的部分做一點修改

兩種情況。這篇文章會以我對客製化的瞭解做一點簡單的分享。

什麼是 IoC

IoC 是 Inversion of Control (控制反轉) 的縮寫,其為一種設計思想,降低程式之間的耦合度,增加維護時的便利性。

繼續閱讀 “使用 IoC 進行專案的客製”

Microsoft Botframework + Adaptive Cards 快速打造 Chatbot 之 2

前言

在 Microsoft Botframework + Adaptive Cards 快速打造 Chatbot 一篇中,
我們說明如何透過 Adaptive Cards 將所有的動作透過 Action 再依它的 Action Type 來轉換成對應的 Action 物件及處理該 Action 物件的 Strategy 物件。

但是當我們的 Action 逾來逾多時,原本使用 switch 勢必會造成相對應的複雜度,依 Strategy 的方式是建立對應表,以下將介紹使用 Dictionary<string, Func<T>> 及 Autofac DI 這2種方式。

另外,如果 Strategy 物件 中有使用到 Prompt dialogs 時,原本在執行完 Strategy 物件的 Method 後,如果直接呼叫 context.Done(“”); 將會造成 botframework Dialog Stack 運行上的錯誤,我們也將修改 Strategy 物件實作的 interface ,增加最後是否要自動執行 context.Done 。 繼續閱讀 “Microsoft Botframework + Adaptive Cards 快速打造 Chatbot 之 2”