iT 邦幫忙::一起幫忙解決難題，拯救 IT 人的一天

4 Like 1 留言 98551 瀏覽

鐵人賽 Modern Web DAY 9

我與 ASP.NET Core 的 30天系列第 9 篇

達標好文技術 [Day09]使用Swagger自動建立清晰明瞭的REST API文件 - 我與 ASP.NET Core 的 30天

在寫Web API 的時候，通常也需要提供清晰明瞭的文件供對接者查看，不過撰寫文件需要花非常多時間，也必須制定出文件規範才能讓對接的使用者容易明瞭，~~而且工程...

ATai ‧ 2020-09-23

3 Like 0 留言 19092 瀏覽

達標好文技術 OpenAI API- ChatGPT + Whisper 讓你快速抓到重點

OpenAI API- ChatGPT + Whisper 讓你快速抓到重點最近2023 Global AI Bootcamp 才剛剛圓滿落幕，而我也有幸籌辦...

Ben ‧ 2023-03-06

0 Like 0 留言 5096 瀏覽

鐵人賽 Modern Web DAY 17

基於 Kotlin Ktor 建構支援模組化開發的 Web 框架系列第 17 篇

技術 [Day 17] 實作 Ktor OpenAPI Generator

先前有提到整個 OpenAPI 的運作流程是… 開發者為 route 撰寫 OpenAPI definition Generator 根據 OpenAPI S...

林俊宏 ‧ 2021-09-22 ‧團隊Kotlin 愛台灣 2021

0 Like 0 留言 3537 瀏覽

鐵人賽 Modern Web DAY 18

基於 Kotlin Ktor 建構支援模組化開發的 Web 框架系列第 18 篇

技術 [Day 18] 轉換 OpenAPI 文件為 Postman Collection 做 Web API 自動化測試

Web API 測試可以是後端工程師使用測試框架撰寫白箱測試，也可以是 QA 使用測試工具進行黑箱測試。對於後端工程師來說，如果 API 有異動，很容易找出對應...

林俊宏 ‧ 2021-09-23 ‧團隊Kotlin 愛台灣 2021

0 Like 0 留言 3389 瀏覽

鐵人賽 Modern Web DAY 16

基於 Kotlin Ktor 建構支援模組化開發的 Web 框架系列第 16 篇

技術 [Day 16] 以 Programmatic 取代 Annotation 的方式撰寫 OpenAPI 文件

Spring Boot 使用 Annotation 撰寫 OpenAPI Definition 我們先來看 spring boot 撰寫 OpenAPI def...

林俊宏 ‧ 2021-09-21 ‧團隊Kotlin 愛台灣 2021

0 Like 0 留言 3010 瀏覽

鐵人賽 DevOps DAY 5

5G 核心網路與雲原生開發之亂彈阿翔系列第 5 篇

技術 NF 之間的傳話筒：SBI

本文目標認識 SBI 認識 OpenAPI Service Based Interface SBI 是由 3GPP 提出的 interface，除了 UP...

EN ‧ 2022-09-16 ‧團隊Google開發者社群

1 Like 0 留言 2753 瀏覽

鐵人賽自我挑戰組 DAY 10

Angular+Spring Boot API 處理股市資料系列第 10 篇

技術 RestTemplate介紹(Day10)

熟悉JWT的我敲開了大門的門鎖，走進了房間同學:來，你過來~~ 我:幹嘛啦 (被推著坐下)，哇，同學你有好多資料喔~! 同學:這沒什麼，來，來看這個好康的(送...

嫩嫩的EveryEnd工程師 ‧ 2021-09-25 ‧團隊ITKB後端工程師

0 Like 0 留言 2450 瀏覽

鐵人賽 Modern Web DAY 15

基於 Kotlin Ktor 建構支援模組化開發的 Web 框架系列第 15 篇

技術 [Day 15] 實作 OpenAPI Plugin 產生 API 文件

為什麼我想自己實作 Ktor OpenAPI Generator? 大多數的 Web 框架都有官方或社群開發的 OpenAPI Generator，自動把程式碼...

林俊宏 ‧ 2021-09-20 ‧團隊Kotlin 愛台灣 2021

1 Like 0 留言 2448 瀏覽

鐵人賽自我挑戰組 DAY 11

Angular+Spring Boot API 處理股市資料系列第 11 篇

技術 RestTemplate實作(一)(Day11)

在串接API之前我們還有一個重要的設定要做，我們必須先匯出證交所網站的SSL證書，並加入到JAVA的驗證裡面。先進入證交所openAPI首頁瀏覽器取得憑證...

嫩嫩的EveryEnd工程師 ‧ 2021-09-26 ‧團隊ITKB後端工程師

0 Like 0 留言 1835 瀏覽

鐵人賽影片教學 DAY 21

智慧雲端物聯 - 關鍵輕專業（AIoT Cloud - Essential Shallow Expertise）系列第 23 篇

技術 API (1/2)

[Day 21] API 2.0：如何從雲端獲得資訊 ? (12min)-- Application Programming Interface 應用程式...

drm ‧ 2018-11-03

0 Like 0 留言 1082 瀏覽

鐵人賽自我挑戰組 DAY 3

30 天開發 Android App 的流水帳系列第 3 篇

技術 Day 3：在 App 開發前怎麼挑選要使用的 Open Api？

不考慮自己使用第三方服務或是用 Firebase 進行資料串接之下，先想一下你的目的想要呈現什麼？你是玩什麼樣的資料？你對什麼主題有興趣？還是想要應用這些資料做...

yenyichun ‧ 2020-09-15

0 Like 0 留言 987 瀏覽

鐵人賽 Modern Web DAY 19

[POSTMAN] 該知道的都知道，不知道的慢慢了解 - 與波斯麵三十天的感情培養系列第 19 篇

技術 Postman challenge Day 18 - API specifications

前情提要在前面的挑戰中，我們曾經體驗過Mock Serivces，可以在前後端討論出介面之後，根據規格開始各自的工作。那麼問題來，怎樣的介面才能讓前後端都能夠...

chacoteeth ‧ 2022-10-04 ‧團隊森上依然梅友前

0 Like 0 留言 397 瀏覽

鐵人賽 IT 管理 DAY 1

我要成為文件工程師── Web API 文件撰寫系列第 1 篇

技術 [Day 01] Web API 與 HTTP 文件基本內容

我：「我不想寫文件！」也是我：「為什麼沒有文件！」身為一個 Web 後端工程師，既然不可能不寫文件，如何讓文件更好寫？本系列文將針對 Web API 的文件撰...

Kei Liao ‧ 2024-09-14

0 Like 0 留言 365 瀏覽

鐵人賽 IT 管理 DAY 4

我要成為文件工程師── Web API 文件撰寫系列第 4 篇

技術 [Day 04] OpenAPI：標準的 API 描述技術規範(三)

OpenAPI 的資料型別(type)是基於 Json 擴充，基礎型別有 boolean、integer、number、string......等，並可藉由...

Kei Liao ‧ 2024-09-17

0 Like 0 留言 320 瀏覽

鐵人賽 IT 管理 DAY 3

我要成為文件工程師── Web API 文件撰寫系列第 3 篇

技術 [Day 03] OpenAPI：標準的 API 描述技術規範(二)

完成服務的基本描述後，就可以針對各支 API 內容進行撰寫了。同樣以虛構的會員服務為範例，以下是一支「取得單一會員資訊 API」的 OpenAPI 規格： #...

Kei Liao ‧ 2024-09-16

0 Like 0 留言 311 瀏覽

鐵人賽 IT 管理 DAY 2

我要成為文件工程師── Web API 文件撰寫系列第 2 篇

技術 [Day 02] OpenAPI：標準的 API 描述技術規範(一)

昨天探討了 Web API 文件要有的內容，OpenAPI 提供了標準化的規範，讓開發者能夠以 json 或 yaml 格式來描述 API 規格。不少開發者都...

Kei Liao ‧ 2024-09-15

0 Like 0 留言 288 瀏覽

鐵人賽 IT 管理 DAY 6

我要成為文件工程師── Web API 文件撰寫系列第 6 篇

技術 [Day 06] OpenAPI：標準的 API 描述技術規範(五)

一般在做 API 設計時，都會盡量收斂設計，期望一組 API 不用太多支，每支 API 參數和欄位不要太複雜，希望這些 API 可以像最經典的樂高積木一樣小而...

Kei Liao ‧ 2024-09-19

0 Like 0 留言 264 瀏覽

鐵人賽 IT 管理 DAY 5

我要成為文件工程師── Web API 文件撰寫系列第 5 篇

技術 [Day 05] OpenAPI：標準的 API 描述技術規範(四)

在多數的情境下，不會獨立存在一支 API，而是由一組 API 來對領域或資源進行存取，以會員服務來說，會有一組包含：註冊、異動、註銷、取得單筆、查詢多筆......

Kei Liao ‧ 2024-09-18

0 Like 0 留言 166 瀏覽

鐵人賽 IT 管理 DAY 10

我要成為文件工程師── Web API 文件撰寫系列第 10 篇

技術 [Day 10] TypeSpec：撰寫 OpenAPI 的領域特定語言 (四)

今天將介紹 TypeSpec 的基礎型別，接著說明如何將其使用在操作的參數和回傳中。型別數值和 OpenAPI 一樣，TypeSpec 支援許多不同的數...

Kei Liao ‧ 2024-09-23

0 Like 0 留言 125 瀏覽

鐵人賽 IT 管理 DAY 9

我要成為文件工程師── Web API 文件撰寫系列第 9 篇

技術 [Day 09] TypeSpec：撰寫 OpenAPI 的領域特定語言 (三)

命名空間在 TypeSpec 中可使用命名空間 namespace 來分類類型，透過這樣的方式可以組織不同類型，也可以避免命名衝突，範例程式碼如下： nam...

Kei Liao ‧ 2024-09-22

0 Like 0 留言 124 瀏覽

鐵人賽 IT 管理 DAY 12

我要成為文件工程師── Web API 文件撰寫系列第 12 篇

技術 [Day 12] TypeSpec：撰寫 OpenAPI 的領域特定語言 (六)

模型多型接下來將使用在 [Day 06] OpenAPI：標準的 API 描述技術規範(五) 時相同的情境做說明。會員允許多種登入方式，而透過不同的登入方...

Kei Liao ‧ 2024-09-25

0 Like 0 留言 100 瀏覽

鐵人賽 IT 管理 DAY 7

我要成為文件工程師── Web API 文件撰寫系列第 7 篇

技術 [Day 07] TypeSpec：撰寫 OpenAPI 的領域特定語言 (一)

手刻 yaml 或 json 文件讓寫 OpenAPI 文件相當不方便，透過 Swagger Editor 或 Stoplight 等 UI 輔助工具是一種選...

Kei Liao ‧ 2024-09-20

0 Like 0 留言 87 瀏覽

鐵人賽 IT 管理 DAY 8

我要成為文件工程師── Web API 文件撰寫系列第 8 篇

技術 [Day 08] TypeSpec：撰寫 OpenAPI 的領域特定語言 (二)

在開始之前，先簡單介紹一下昨日我們建立的專案及基本操作。初始化 TypeSpec 專案時產生的 main.tsp 檔是 TypeSpec 的預設進入點，CLI...

Kei Liao ‧ 2024-09-21

0 Like 0 留言 73 瀏覽

鐵人賽 IT 管理 DAY 11

我要成為文件工程師── Web API 文件撰寫系列第 11 篇

技術 [Day 11] TypeSpec：撰寫 OpenAPI 的領域特定語言 (五)

模型使用關鍵字 model 建立模型，模型可以在不同的操作或其他模型中重複使用，編譯時模型會輸出在 components 節點，並在各個使用的地方透過 $r...

Kei Liao ‧ 2024-09-24

達標好文 技術 [Day09]使用Swagger自動建立清晰明瞭的REST API文件 - 我與 ASP.NET Core 的 30天

達標好文 技術 OpenAI API- ChatGPT + Whisper 讓你快速抓到重點