iT邦幫忙

swagger相關文章
共有 34 則文章
鐵人賽 Software Development DAY 29

技術 Day 29 - Swagger UI

相信大家在開發 API 時,不能單只有後端程式內可以看到對應個別端口需要的參數或是回應的內容,很多時候必須要提供這些規格給其他不同單位,像是前端或 PM 或甚至...

靠近 ASP .NET Core 一點點 系列 第 15

技術 Day 15 Swagger : 撰寫 API 文件

前言今天想針對互動式的 API 文件,進行分享。開發時,常遇到需要先提供規格(request、response),並可以直接在瀏覽器上測試 API 等需求,最早...

鐵人賽 IT 管理 DAY 12

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

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

鐵人賽 IT 管理 DAY 11

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

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

鐵人賽 Software Development DAY 10

技術 Spring boot 從零開始 (10) - 如何利用Swagger快速生成API文件

Hello ~ 大家好,經過了前面幾天的練習後,是不是可以慢慢開發出API了呢 ? 那如果我們API愈來愈多,或是後端團隊要提供給前端團隊API文件,又或著是要...

鐵人賽 IT 管理 DAY 10

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

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

鐵人賽 IT 管理 DAY 9

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

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

鐵人賽 IT 管理 DAY 8

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

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

鐵人賽 IT 管理 DAY 7

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

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

鐵人賽 IT 管理 DAY 6

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

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

鐵人賽 IT 管理 DAY 5

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

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

鐵人賽 IT 管理 DAY 4

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

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

鐵人賽 IT 管理 DAY 3

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

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

鐵人賽 IT 管理 DAY 2

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

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

鐵人賽 IT 管理 DAY 1

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

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

鐵人賽 Software Development DAY 1

技術 Spring boot 從零開始 (1) - 修練初心 & 目標

Hello 大家好,我是Winnie今年遇到了好同事?!推坑後,燃起了今年參加鐵人賽 雖然網路上有好多教學,不過希望這次可以帶給大家更多如何建立專案的概念,希...

技術 [DAY6] Django與Docker Compose後端開發實戰 - 設置Admin管理系統與整合Swagger

在上一篇文章中,我們學習了如何修改Django項目的資料庫結構,並探討了MariaDB的使用方法。本篇文章中,我們將探討如何設置Django Admin管理系統...

技術 【Day47】ChatGPT請教教我:NestJS!(六)- API測試兼文件!swagger!

耶,這篇是我想要寫很久的,終於到swagger了另外NestJS相關系列包含這篇,應該…九篇吧!吧! 到Day50剛好把NestJS講完的話,有種很舒服的感覺(...

鐵人賽 Modern Web DAY 20

技術 Day 20:Swagger UI 引入範例

由於我想設計一個 API 完成不同種類發票的功能,包含 登錄紙本電子發票 登錄傳統發票 登錄個人載具 Schema 那要怎麼實作呢?首先是設計 Schema...

鐵人賽 影片教學 DAY 5

技術 Node.js 文件產生器 Swagger | 別人家的後端都會產文件!?我們家的都... Day5

網路上 API 文件都那麼完整,為什麼我們公司的都... 什麼!?這次文件應該是我負責?誒,我還沒寫過文件啊~~~ Swagger 算是目前相當主流的 API...

技術 利用EF Core及Scaffolding,快速建立ASP.NET Core Web API

前言 最近接了一個急案,沒辦法浪費太多時間在API的開發上。因緣際會下得知了EF Core這個方便的工具,它可以快速地建立Model,再搭配Scaffoldin...

技術 [Swagger] 在 Swagger UI 新增自訂 Header

先定義一個 Attribute [AttributeUsage(AttributeTargets.Method, AllowMultiple = true)]...

技術 開發API介接,不可不知道curlconverter這個佛系網站

連結點我:curlConverter 一般的 swagger 文件在執行 post、put、patch、delete 後,都會顯示一段 curl 指令。上述範例...

鐵人賽 Software Development DAY 4
玩轉C# 進階學習之旅 系列 第 4

技術 玩轉C#之【Swagger 不是SWAG】

這是Swagger的Logo這是SWAG的Logo 大家要小心不要Google錯了 介紹 Swagger是SmartBear Software的API開發人員套...

技術 .NET Framework4.7.2 製作 Web API 使用 [NSwag] 套件呈現 Swagger UI + JWT Authentication 及跨域處理(CORS)

本文將介紹如何使用 JWT 保持登入狀態,配合 Swagger / OpenAPI 呈現。 .NET Framework 4.7.2 開發環境 Visual...

鐵人賽 Software Development DAY 26

技術 [Day - 26] - Spring Swagger之我的SeaFood API 手冊配製方法

Abstract 我們前面講了許多Spring應用開發,但當我們開發好一套系統,勢必要有一套API手冊,不然前端開發者就會很辛苦的難以開發,都要等待您的API出...

鐵人賽 自我挑戰組 DAY 29
Python資料分析學習地圖 系列 第 29

技術 Day 29 : FastAPI 讓模型上線

我們通常會建立一個服務來讓模型上線,但在上線前,有一些基本的網路知識需要先了解。因此前面會先淺談網路,後面會介紹 FastAPI 來部署模型。 淺談網路 超文本...

技術 在本機瀏覽Open API格式的文件

原文: https://j2hongming.github.io/2021/08/06/view-open-api-in-local/ open API類似原始...

鐵人賽 Modern Web DAY 19

技術 Day 19. 建立Web API與Postman測試、產生說明文件

前言 今天我們要來學如何建立Web API,並利用Postman進行API的測試,最後安裝Swagger套件來產生API的說明文件。與WebService相比,...

鐵人賽 Modern Web DAY 9

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

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