25000行超えのAPIドキュメントを分割した話

2024/03/22 54 users APIドキュメント 知見 スキーマ駆動開発 伊藤 弊社

はじめに COUNTERWORKSバックエンドエンジニアの伊藤です。 この記事ではAPIドキュメント分割の知見を紹介します。 弊社では OpenAPI を使用したスキーマ駆動開発を採用しています。 1ファイルで管理していたところ、25000行を超える行数となり管理コストが高くなっていました。 そこで分割作業を実施したのですが、どの... 続きを読む

TypeScript のような構文で OpenAPI のスキーマを定義する TypeSpec

2024/01/27 76 users TypeScript スキーマ 構文

import "@typespec/http"; using TypeSpec.Http; model User { id: string; name: string; birthday?: utcDateTime; address: Address; } model Address { street: string; city: string; state: string; zip: string; } @route("/users") interface Users { list(@query limit: int32, @query skip: int32): User[]; cr... 続きを読む

GitHub、SDKを刷新。今後はOpenAPI仕様の生成ツールで生成したSDKを提供へ

2024/01/14 58 users GitHub Octokit SDK 刷新 APIクライアント

GithHubは、今後はAPI仕様を記述する業界標準であるOpenAPIに対応した生成ツールで生成したAPIクライアントをSDKとして提供することを明らかにしました。 現在まで同社は「Octokit」と呼ばれるSDKを提供しています。これはGitHubの開発者が、外部のアプリケーション開発者のために、さまざまな言語でGitHub APIを呼び出... 続きを読む

OpenAPI (Swagger) まとめ - Qiita

2022/11/09 71 users Swagger NEST Rails API node.js

はじめに 自分は実務でReact×TypeScriptを利用したフロント周りとNode.js(Nest)やRailsを用いたバックエンド(API)の開発をしています。 本記事では、OpenAPIを用いたAPI設計の書き方及び、Swaggerの説明と使い方についてまとめていきます。 この記事の対象者 プログラミング初心者から中級者 APIの基礎を理解している人 ... 続きを読む

OpenAPI + Zod で型安全な API クライアント出力

2022/09/28 50 users Zod openapi-generator REST API

バックエンドが OpenAPI（REST） で API 仕様を公開している場合、 フロントエンド側で OpenAPI の仕様から、 型安全、かつ API 仕様通りに型定義と API クライアントを生成したい場合があり、 現状　API クライアント生成系ライブラリとして、以下のいずれかが候補に上がるかと思います。 openapi-generator 様々な言語... 続きを読む

OpenAPI からなるべく生成するフロントエンド開発

2022/10/10 59 users seya スキーマ スクリプト REST API 一挙大

こんにちは。 スキーマから何かを生成するのが大好きな seya と申します。 今の会社では REST API のスキーマを OpenAPI で記述しているのですが、それを活用して何かしらを生成するスクリプトをよく書いています。 そんなネタがそれなりに溜まってきたので一挙大放出しようというのがこの記事です。 具体的には次のよう... 続きを読む

OpenAPI generator と TypeScript で型安全にフロントエンド開発をしている話 - SmartHR Tech Blog

2020/08/25 87 users TypeScript GENERATOR Generate

こんにちは、SmartHR でフロントエンド開発を担当している @Tokky0425 です。 この記事では、私のプロダクトでの OpenAPI generator を使ったフロントエンド開発の取り組みを紹介していきます。 目次 OpenAPI とは 「ラクラク分析レポート」の DX 上の課題 OpenAPI generator とは 実際に generate してみる 生成ファイ... 続きを読む

OpenAPI や Protocol Buffers のおかげで開発がかなり捗っている話 - Medley Developer Blog

2020/08/21 193 users grpc CLINICS Protocol Buffers

こんにちは、インキュベーション本部エンジニアの加藤です。 主に CLINICS アプリの開発を担当しています。 はじめに CLINICS アプリの開発では OpenAPI や gRPC を利用しています。 OpenAPI と gRPC の間には何の関係もないのですが、どちらも API の仕様をスキーマ言語で記述するという点では共通しています。 今回は... 続きを読む

API 設計: gRPC、OpenAPI、REST の概要と、それらを使用するタイミングを理解する | Google Cloud Blog

2020/04/16 712 users grpc REST API タイミング 設計

※この投稿は米国時間 2020 年 4 月 11 日に、Google Cloud blog に投稿されたものの抄訳です。 ほとんど&#... 続きを読む

本当に使ってよかったOpenAPI (Swagger) ツール | Future Tech Blog - フューチャーアーキテクト

2019/10/08 483 users Swagger フューチャーアーキテクト 冒頭 https

サードパーティ製のツール本家からは上述のツールが提供されていますが、サードバーティ製の様々なツールが世の中には存在します。 エコシステムが成熟しているのもSwaggerを利用するメリットの一つですね。 https://openapi.tools/ 冒頭のとおり、このサードパーティ製のツールの中で実際に利用して良かったツールを3つ... 続きを読む

マイクロサービスにおけるWeb APIスキーマの管理 ─ GraphQL、gRPC、OpenAPIの特徴と使いどころ - エンジニアHub｜若手Webエンジニアのキャリアを考える！

2019/08/22 405 users 近年 利点 パフォーマンス マイクロサービスアーキテクチャ

近年流行しているマイクロサービスアーキテクチャにおいては、「どういった通信方式を選ぶか」が開発の効率やサービスの信頼性、パフォーマンスを大きく左右します。この記事では、GraphQL・gRPC・OpenAPIそれぞれの利点と適切な使い分けについて解説します。 マイクロサービスにおけるWeb API管理の重要性 Schema Fast ... 続きを読む

OpenAPIによるスキーマファースト開発の実施サンプルとCloud Runについて - OPTiM TECH BLOG

2019/04/17 58 users スキーマファースト開発 Cloud Run 高橋 去年 普段

こんにちは、インダストリー事業本部 医療チームの高橋（@yukey1031）です。 去年のクリスマス以来の投稿です。AMIAS（アミアス）をお願いします。 さて、今回は自身の周辺業務で普段行っているOpenAPIによるスキーマファースト開発の実施サンプルと先日Google Cloudより発表された「Cloud Run」について少し触れてみた... 続きを読む

OpenAPI GeneratorでRESTful APIの定義書から色々自動生成する #OpenAPI - こまどブログ

2019/01/13 292 users xlsx SPA OpenAPI Generator API

APIの定義を書く：Excel仕様書はもういやだ RESTful APIを提供するサーバと、そのAPIを利用するクライアント（たとえばSPA）とを並行で開発しようとするとき、まずAPIを定義して、それに基づいてサーバ／クライアント双方の実装を進めようと考えるのは自然だと思う。 そうと決まれば、「API仕様書_20190110.xlsx」と題す... 続きを読む

カラーミーリピートをHerokuで開発／運用して得た知見 - ペパボテックブログ

2018/06/26 69 users Heroku Rails GraphQL 半期 知見

こんにちは、kymmt90です。EC事業部カラーミーリピートチームでRails、OpenAPI、GraphQLなどを使ったWeb APIの開発を主に担当しています。だいたい半期に1回のペースでペパボテックブログに記事を書いていて、前回はRails Developers Meetup 2017の登壇レポートを書きました。 私が所属するチームではカラーミーリピート... 続きを読む

gRPCを学んでいる - はこべにっき ♨

2018/04/04 273 users grpc GraphQL ドキュ メンテナブル はこべにっき

2018 - 04 - 04 gRPCを学んでいる マイクロサービスや自作ミドルウェアのAPIをメンテナブルにしたいよねっていう文脈で、 OpenAPI や GraphQL 、 gRPC といった技術が採用されるのを最近よく目にする。 主にバックエンドを実装しているWebエンジニアとしては、こういう仕組みに人気が出て環境が整備されつつあるのはうれしい。APIをシステムの外に公開しようとするとドキュ... 続きを読む

もう管理画面のフロントコードを書く必要はありません、そう Viron ならね。 - Qiita

2018/02/01 632 users Qiita Swagger Viron jsonファイル 大小

管理画面のフロントエンドコードを書く時代は終わりました。 Viron があれば、OpenApi(Swagger)でAPI定義を行い、実装するだけで管理画面が完成します。 概要 Viron は、複数の管理画面を管理できるよう設計された、管理ツールマネージメントコンソールです。 APIサーバーとOAS2.0 jsonファイルを作成するだけで、管理画面が一つ完成します。 経緯 私の会社では、大小さまざま... 続きを読む