OpenAPI Generator と TypeScript で型安全にフロントエンド開発をしている話 - SmartHR Tech Blog
こんにちは、SmartHR でフロントエンド開発を担当している @Tokky0425 です。 この記事では、私のプロダクトでの OpenAPI Generator を使ったフロントエンド開発の取り組みを紹介していきます。 目次 OpenAPI とは 「ラクラク分析レポート」の DX 上の課題 OpenAPI Generator とは 実際に generate してみる 生成ファイルを使ってみる 型情報を出力してみる 組み込み・運用の工夫 chokidar で監視する lint-staged に組み込む メリット・デメリット メリット デメリット まとめ OpenAPI とは OpenAPI とは、「REST API のドキュメントの記述形式を定めた仕様」のことを指しています。 簡単な例ですが、下記のような YAML ファイルがあるとします。 schema.yml paths: "/some
実は、Ajaxのウラにこそ勝算がある：Web 2.0で変わるWebプログラミングの常識（1/5 ページ） 見た目にインパクトが大きいAjax利用のWebアプリケーション。しかし、その見た目を支える要となるものは、背後にある有益な情報処理と活用方法だ。Ajaxのインパクトに負けないWebアプリはどのように作られるのか？ このオンライン・ムックPlus「Web 2.0で変わるWebプログラミングの常識」では、これまでにAjaxの概要（第1回）から発展系としてどのような取り組みあるのか（第2回）、そして、効率的な組み込み方法の一つとしてJSONと呼ばれるデータ形式のやり取り（第3回）について解説した。 この一連の特集を読むことで、プログラミングノウハウを一から十まですべてを学べるほどのボリュームは詰め込めないが、それでも最低限押さえておくべきポイントが理解できるはずだ。今回の記事でテーマとなるの
【パズル１】ほとんどのエンジニアには解けるが、下位10％のダメなエンジニアにだけ解けないパズル? - ベルリンのITスタートアップで働くジャバ・ザ・ハットリの日記
半年ほど前にソフトウェアエンジニア向けの求人募集ページに簡単なプログラミング系のパズルを出して、それが解けた人だけ応募できる仕組みにしよう、という話になった。 その時期は求人を拡大募集していたのだが、あまりにハズレな人が多かった。私もいくつか面談をしたのだが「CV（履歴書）には高いスキルって書いてるけど、言ってることがなんでこんなに変なの？」と感じてしまう応募者が多かった。これは私だけの意見でなく、他のエンジニア達からも不満が続出した。つまり履歴書のスクリーニングが効いてないということだ。日本よりも海外の方が履歴書を誇張する率が高い気がする。そこで考えたのが求人募集ページにエンジニア向けのパズルを出す、という発想。 言ってはみたもののどんなパズルにしようかと考えると案外難しい。 パズルの条件は以下の３つ。 簡単なパズルにすること。あくまでダメなエンジニアだけを門前払いするのが目的だから、変
【エンジニアカフェEvent】エンジニアカフェ× ドリコム技術勉強会～月間50億ＰＶのソーシャルゲームを支える技術～ http://www.facebook.com/events/216511125103989/ see alse: * http://www.slideshare.net/drecom/ss-11667563
JavaによるRESTfulシステム構築 作者: Bill Burke,arton,菅野良二出版社/メーカー: オライリージャパン発売日: 2010/08/23メディア: 大型本購入: 28人 クリック: 804回この商品を含むブログ (40件) を見る これ，本当にタイトル勿体無いなぁって思う本でした． いや，タイトルに偽りは無いんだけど，これだと REST に興味無い人は手に取らないだろうなぁと思って，それは凄く勿体無い内容なので，ホントみんな読むと良いと思う． 簡単に説明すると，Java で REST を扱うために JAX-RS という API があるんだけど( JSR311 )，そのエキスパートグループの一人であり，さらにその実装である RESTEasy の作者が書いている本です． で，この人は元々 SOAP とかのどちらかというと Fat な仕様大好きっこだったので，この本には色
GitHub - httpie/cli: 🥧 HTTPie CLI — modern, user-friendly command-line HTTP client for the API era. JSON support, colors, sessions, downloads, plugins & more.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
IBM Developer is your one-stop location for getting hands-on training and learning in-demand skills on relevant technologies such as generative AI, data science, AI, and open source.
Joruri公式サイト
Joruri CMS Ver.3 お問い合わせ 初期型 Joruri CMS ダウンロード（GitHub） お知らせ 2023年08月04日【重要】Joruri CMS ver.3以下のサポート終了について 2022年02月16日Joruri CMS 3.1.8をリリース 2021年08月24日Joruri CMS 3.1.7をリリース 2021年02月09日Joruri CMS 3.1.6をリリース 2020年12月03日Adobe Flash Player 削除における影響と対応について 最新版Joruri CMS 2020の情報はこちらから パンフレット 自治体向けWebアプリケーションソフトウェアシリーズ Joruriパンフレット（2017.7.6版） Joruriパンフレット[PDF：2.7MB] 自治体OSSキットパンフレット（2017.05.16版） 自治体OSSキットパンフ
If you’ve ever argued with your team about the way your JSON responses should be formatted, JSON:API can help you stop the bikeshedding and focus on what matters: your application. By following shared conventions, you can increase productivity, take advantage of generalized tooling and best practices. Clients built around JSON:API are able to take advantage of its features around efficiently cachi
僕は仕事終わって飯食ったら基本的に部屋でだらだらしてるんだけど、寝る時間も近づいてくると「あー、風呂入んなきゃー」ってなってくる。でも、この状態から風呂へ行くまでが、非常にダルい！
Your data model has started to stabilize and you're in a position to create a public API for your web app. You realize it's hard to make significant changes to your API once it's released and want to get as much right as possible up front. Now, the internet has no shortage on opinions on API design. But, since there's no one widely adopted standard that works in all cases, you're left with a bunch
CORS(Cross-Origin Resource Sharing)によるクロスドメイン通信の傾向と対策 | DevelopersIO
CORS(Cross-Origin Resource Sharing)って何？ CORS(Cross-Origin Resource Sharing)は、その名の通り、ブラウザがオリジン(HTMLを読み込んだサーバのこと)以外のサーバからデータを取得する仕組みです。各社のブラウザには、クロスドメイン通信を拒否する仕組みが実装されています。これは、クロスサイトスクリプティングを防止するためです。Aというサイトに訪問したのに、Bというサイトに向けて個人情報を送っていたというのは困りますよね。例えば、オリジンから読み込んだHTML内のJavaScriptでJSONデータを読み込むとしましょう。JSONデータが同じサーバにあれば普通に読み込めますが、別のサーバにある場合は読み込めません。まぁ実際のところはJSONPという仕組みを使ってできちゃったりしますが、抜け道的なやり方で使われていました。CO
仕事熱心なあまり、自分のコントロールを超えるほど働いてしまうときがありせんか？ そんな状況が続くと、突然病気になったりします。職場に行けないと世界が終わってしまうような気分になるかもしれませんが、現実にはそんなことは起こりません。 ときに病気は、「ちょっとペースダウンしたほうがいいですよ」という身体からのメッセージです。Paula Davis-Laack氏は、「Psychology Today」の中で次のように説明しています。 人間の体や脳は、休みなく働き続けられるようにはできていません。「メンタル・タフネス」のトレーニングで有名な心理学者のジム・レーヤー（Jim Loehr）氏は、高いパフォーマンスを維持するためには、90分～120分ごとに短い休憩が必要だと言っています。忙しいからスケジュールのコントロールはできないと思う人は多いかもしれませんが、会社側としても、健康を優先させ、他の従業
The Cicada Principle and Why It Matters to Web Designers » HTML & CSS, Layout » Design Festival
Browse our comprehensive collection of courses, books, and tutorials on a wide range of development and design topics.
Javaのエンジニアだった私がGo言語でREST APIを作る上で学んだことをまとめています。 プロジェクト構成、単体テスト、Dockerイメージの作成など実際にREST APIを開発する上で必要だと思われる要素を盛り込みつつサンプルプロジェクトを作成していきます。 はじめに Javaのエンジニアだった私がGo言語でREST APIを作る上で学んだことをまとめています。 プロジェクト構成、単体テスト、Dockerイメージの作成など実際にREST APIを開発する上で必要だと思われる要素を盛り込みつつサンプルプロジェクトを作成していきます。 今回はできるだけ外部ライブラリやフレームワークを使わずにGo言語の標準機能のみで開発しました。 これからバックエンドにGo言語を使用することを検討されている方の参考になれば幸いです。 ※この記事は既にGo言語の開発環境をセットアップ済みで基本的な文法を学
Kazuho@Cybozu Labs: REST におけるトランザクションについて (Re: Web を支える技術)
といいつつ、ひとつだけ理解できないというか、納得できないところが。トランザクションのところがなんだかRESTっぽくないのがすごく気になる Webを支える技術 -HTTP、URI、HTML、そしてREST (WEB+DB PRESSプラスシリーズ)(山本 陽平) - ただのにっき(2010-04-23) 「Web を支える技術」は自分もとてもいい本だと思う (教科書としてすばらしいし復習用としても読みやすいのでイイ) のですが、トランザクションの所だけは分かりづらいなと感じました。その原因は、atomic transaction で解決できる課題を例として使っているという点と、トランザクションと更新クエリのレイヤ分割がされていない、という２つの点によるものではないでしょうか。 HTTP 上でトランザクションを表現する必要があるケースのほとんどは、atomic transaction ではなく
2.0のmap.resourcesのオプション設定いろいろ - ザリガニが見ていた...。
今までおろそかにしていた「ルート設定」ではあるが、Rails2.0からは避けて通ることができない*1と今更ながら思い直し、いろいろ試してみた。以下はその実験結果。 基本 追加オプションなしの基本ルート設定map.resources :slipsによって、以下のルート規則が生成される。 ルート規則は上にあるものが優先される。 .:formatが付属する偶数No.の行は、http://XXXX.XXX/slips.xml等の拡張子付きのリクエストを、respond_toブロックで適切に処理するために存在する。 # ルート設定: config/routes.rb ActionController::Routing::Routes.draw do |map| map.resources :slips end No. 名前付きルート名 メソッド URLパス書式 処理されるコントローラー、アクション
やたらと豪華なメンバーで話題沸騰のイベント、ITpro Challenge!に行って来た。 定員70名の中のラッキーな一人だったのでさっそくレポート…というかただのメモ。 もし会社員のままだったら今日絶対休めてないのでいいタイミングで辞めた俺GJ。 詳しい内容は後日動画がニコニコとかに上がるそうなのでそちらをチェックされたし。 発表者とLTの面子だけでも豪華なのに、右斜め前を見ればMatz氏が、左を見れば吉岡氏がいらっしゃったり…など聴衆もスゴかった。 メモが取り切れてないので細かい点は色々はしょって印象的だった所だけ…。（聞き入ってた。） 懇親会は存在を知らずに申し込んでなかったので直帰。出来れば参加者宛にメール流してほしかったなぁ…ブログの存在知らなかった…。 参加者へのリマインドメールにブログの記載がありました。僕が勝手に見落としていただけのようです。 2007/09/10追記 もは
RESTに対する７つの誤解
海外に行くと、既に REST対SOAPの決着は付いている[1]（エンタープライズでもコンシューマでも）ように見えるのだが、日本国内で話していると、まだまだ混乱しているようだ。さながら2009年ごろの状況を見るようだ。そこで、今日は RESTに関わる誤解について、幾つか書いてみたいと思う。（殴り書きだが、あんまり聞かれるのでFAQとして。なお、以下の多くは、[2] サービスステーション：RESTの詳細でより詳細に書かれている。） 誤解1. RESTはマッシュアップ用のプロトコルで、サーバ間通信には適さないのではないか？ どこからこのような誤解が来ているのか理解に苦しむ。ひょっとすると、RESTはHTTPベースということが、ブラウザとWebサーバのやり取りという風に誤って捉えられているのかもしれない。 もちろん間違いである。 ブラウザとWebサーバとの間同様、サーバからサーバへの通信にもHTT
目次：ITpro - 技術者視点のユーザビリティ考
使いやすいサイトを作るのは，デザイナーだけの問題ではありません。エンジニアとしてサイト構築にかかわっている筆者が，日ごろぶつかった問題をネタにじっくり考えていきます。 ・第33回 リピーター増加を阻む「面倒くささ」の壁 あるウェブサービスを初めて使った人が「しばらく使ってみよう」と思ってくれても，「面倒くささ」の壁に阻まれて次第にサービスの利用から遠ざかっていくことはよくあります。ブラウザを利用しないものを含む，さまざまなインタフェースを提供することで，その面倒くささを乗り越えられるのではないか，という仮説のもと，いくつかの例を紹介します。 ・第32回 リダイレクトの正しい使い方とは あるページ（URL）にアクセスすると，自動的にほかのページにジャンプするリダイレクトは，ウェブサイトを構築するうえで非常に重要な仕組みです。しかし，ユーザーの知らないうちにページの移動を行うため，ユーザーを戸
ドメインパーキング
tatamilab.jp
MOONGIFT: » 驚愕…JavaScriptでDB操作を行うRails向けライブラリ「Jester」:オープンソースを毎日紹介
Railsは使っている内に、もはやRails以外でプログラムをしたくなくなる位の魅力がある。MVCの仕組みといい、O/Rマッピングといい、Migrationといい…そこかしこに魅力が溢れている。 そんなRailsがさらに魅力的になるライブラリがこれだ。Rubyの壁をこえ、JavaScript上でDB操作が可能になる。 今回紹介するオープンソース・ソフトウェアはJester、RESTによるDB操作を行うJavaScriptライブラリだ。 単純に言うと、JesterはXMLベースでWebサーバにリクエストを行う。その結果をXMLベースで受け取り、JavaScriptのクラスにしてくれる。操作はRESTで行われ、データ取得系はGET、作成処理はPOST、更新処理がPUT、削除処理がDELETEとなっている。 操作だけを考えると、Railsに限ったものではない。他の言語でもインタフェースを用意すれ
Get equipment you can rely on at an affordable price. Shop IBM refurbished servers, storage and parts.
10分で理解する初めてのAPI
10分で理解する初めてのAPIとは 公開APIに興味を持っている人はどれくらいいるのか？にも書いたとおり、公開APIに興味を持っている人は少なからずいると思います。では、なぜ実際に公開APIを利用したサイトを作ってみないのかというと、公開APIを利用したサイトが完成するまでの流れにも書いたように、実際にサイトを作るまでにはいろいろな壁があるからです。 というわけで、今回は少しでも公開APIに対する抵抗感を取り除いてもらうために、「10分で理解する初めてのAPI」ページを作ってみました。「本当に10分で理解できるのか？」と疑問を持たれてしまいそうですが、「公開APIを利用するのは、怖い、難しい、大変なことではない」ということを理解していただけたら幸いです。サンプルソースとしてはPHP5を使わせてもらいましたが、基本的にはどのプログラミング（スクリプト）言語を用いても大丈夫なはずです。公開AP
WebOS Goodies へようこそ！ WebOS はインターネットの未来形。あらゆる Web サイトが繋がり、共有し、協力して創り上げる、ひとつの巨大な情報システムです。そこでは、あらゆる情報がネットワーク上に蓄積され、我々はいつでも、どこからでも、多彩なデバイスを使ってそれらにアクセスできます。 WebOS Goodies は、さまざまな情報提供やツール開発を通して、そんな世界の実現に少しでも貢献するべく活動していきます。 少し前にActiveResource で Google Spreadsheets をアクセスするライブラリを公開しましたが、思ったほどブクマとかされなくて、ちょっとションボリ（´・ω・｀）な感じでした。まあ、ライブラリがイマイチと言われればそれまでなのですが、それ以前に ActiveResource 自体があまりよく知られていたいのかな、という気もします。たしかに
2021年6月2日に行われたSendai Frontend Meetup #6で使用したスライドです。 GitHub サンプルコード https://github.com/KanDai/openapi-sample ReDocで生成されたドキュメント https://kandai.github.io/openapi-sample/ About Swagger Specification https://swagger.io/docs/specification/about/ Swagger Editor https://editor.swagger.io/ Stoplight Studio https://stoplight.io/api-design/ Swagger UI https://petstore.swagger.io/ Redoc https://github.com/Red
RESTアンチパターン
多くの人々にとって、RESTは単純にあるアプリケーションの機能を公開するためにHTTPを使用することを意味します。基本的で最も重要なオペレーション (厳密に言えば、「動詞」や「メソッド」がより良い表現です)は、HTTPのGETです。GETはURIによって特定されるリソース表現が必要です。しかし、多くの場合、それがすべてではないとしても、既存のHTTPライブラリやサーバープログラミングAPIは、リソースの識別子としてではなくパラメータをエンコードするための便利な手段として見ることがとても多いです。結果、以下のようなURLとなります。: http://example.com/some-api?method=deleteCustomer&id=1234 実際、URLを作る人は、与えられたシステムの「RESTful具合」について何も言いません。しかし、私たちは特定の場合においてGETが「安全」では
プログラミング初心者が中・上級者になるためには、GithubのリポジトリをWatchすればいいんじゃないかな - iakioの日記
よく、プログラミングを学ぶ方法として「まずは何か作りたいものを見つけて、、、」といったアドバイスを見かける。たしかに何かを作り上げることで学ぶことも多いのだけれど、どちらかというとそれは実装方法よりもデプロイだったりライブラリやツールの使い方といったところの方が大きいように感じる。 一方で、実装方法については、自分で問題を解決しているだけだとどうしても自分の考え方にとらわれてしまう。 プログラミングの上達のためにきっと一番大切なことは環境で、近くに良い師匠がいるのであれば様々な問題の解決方法を学ぶことができるだろう。 そうでない場合は、インターネット上でお手本を見つけるのが良いと思う。 あまり大きすぎず、ある程度活発なお気に入りのプロジェクトをGithubで見つけてWatchする。毎日届くNotificationをざっとで良いので目を通す。最初はほとんど意味がわからないだろうけどかまわない
ricollab Web Tech Blog » Blog Archive » 【重要】ricollabサービス終了のお知らせ
いつもricollabをご利用いただき、ありがとうございます。 この度、誠に勝手ながら2018年2月28日をもちまして「ricollab blog」「郵便番号検索サービス」の各サービスを終了させていただきます。 日頃より利用いただいております皆様にはご迷惑をおかけすることとなり、誠に申し訳ございません。長らくのご愛顧をいただき、厚くお礼申し上げます。 ricollabは、2008年より運営を続けて参りました。しかし、この数年で利用者も大幅に減少しており、サービスとしての役割を終えたと考え、終了という判断に至りました。ご愛用頂いている利用者の皆さまにはご迷惑をおかけしますが、何卒ご理解頂きたく存じます。 ■郵便番号検索APIのご紹介 http://zipcloud.ibsnet.co.jp/doc/api https://github.com/madefor/postal-code-api
Transactional Email API Service For Developers | Mailgun
Deliver emails Flexible, scalable, and results driven email sending platformBuild with the platform that enables you to send, track, and optimize emails effortlessly Great emails are personalized – your email program should be tooNo two businesses communicate alike, let alone to the same people. Pick and choose which solutions best fit your needs, with the ability to flex other tools should your s
コマース広告の大変動 プライバシー保護とパーソナライズの狭間で マーケティングの効果を最大化するためには 注目急上昇中のDaaS最新情報 コロナ禍を背景に利用者と機能を拡大中 Azure Virtual Desktop最新情報 A Business New Era あらゆるモノ・コトが変化している今 デジタルでビジネスは生まれ変わる 大事なのは”仕事の段取り” 幅広い業務を任されているからこそできる ひとり情シス流の業務改善術 サステナビリティの今と未来 企業戦略としてのサスティナビリティ推進 世界の通信インフラを支えるコルトの取組み 年間5,000件の問い合わせに対応 疑問を解消したいユーザーも答える情シスも みんな幸せになるヘルプデスクの最適解 Anywhere Workspace！ ハイブリッドワーク時代の働き方 分散業務環境3つの課題と解決策 現場主導のデジタル変革 ビジネス変革の
自分でGraphQLサーバーを実装しながら勉強したログ。間違ってるかも。 コードはここにあるが、何の注釈もない。 https://github.com/mizchi-sandbox/play-graphql-server RESTの課題 REST は URI とモデルのマッピング構造だが、往々にしてクライアントで必要となる構造は モデルのうち一部であったり、そのリレーショナルな構造に依存する。 つまり、REST というルールに従って必要なデータを組み立てると、リレーショナルな構造によってN回のリソースへのアクセスと、興味がないデータを含んだ不要なペイロードが発生しがちである。 GraphQL は何をしたいか 1リクエスト内でモデルへの問い合わせを合成し、さらに必要なものだけ返却したい 言語とは独立した、転送経路上のモデルの定義を行いたい パフォーマンス上の理由とセマンティクスが同居している
『Web API: The Good Parts』を読んだ。贈ってくれた人達ありがとうございます。 Web API: The Good Parts 作者: 水野貴明出版社/メーカー: オライリージャパン発売日: 2014/11/21メディア: 大型本この商品を含むブログ (2件) を見る 目次 詳細はO'Reillyのページにて。 1章 Web APIとは何か 2章 エンドポイントの設計とリクエストの形式 3章 レスポンスデータの設計 4章 HTTPの仕様を最大限利用する 5章 設計変更をしやすいWeb APIを作る 6章 堅牢なWeb APIを作る 所感 Web API、よく知らない場合はとりあえず作りやすい方法で作っていこうという気持ちになりやすい。しかし、Web APIは後から変更するのが比較的難しいものなので、つらいものを使い続ける羽目になりやすい。また一貫性が重要視されやすいので
はやわかり reStructuredText
本マークアップ記法の完全な詳細は reStructuredText のページに示されています。このテキストは、覚書としての性格の文書です。 "(詳細)" というリンクを辿ると reStructuredText 仕様書を参照できます。 ただし、相対リンクとなっていますので、リンク切れの場合は、 原版の "Quick reStructuredText" から参照してください。 目次 インライン マークアップ バックスラッシュによるエスケープ 章立ての構造 段落 記号つきリスト 番号つきリスト 定義リスト フィールドリスト オプションリスト 整形済みブロック ラインブロック 引用 Doctestブロック 表 区切り線 明示的マークアップ 脚注 出典 リンクターゲット 外部ターゲット 内部ターゲット 間接ターゲット 暗黙ターゲット ディレクティブ 代入参照とその定義 コメント 助けを得たい場合は
Sphinx-Users.jp
Sphinx-Users.jp¶ Sphinx-Users.jp(略称#sphinxjp)は、美しいドキュメントを簡単に生成することができるドキュメンテーションツール、 Sphinx （スフィンクス）の普及を主眼としたコミュニティです。SphinxはPythonの公式ドキュメントだけでなく、このSphinx-Users.jpのサイトも含め多くのマニュアルやサイトで使用されており、詳細を Sphinxの歴史で紹介しています。 Sphinx-Users.jp は日本の Sphinx コミュニティです。 Sphinx-Users.jp では、日本で散らばっているSphinx関連情報を集めて、Webサイト、イベントを通じてSphinx情報を発信します。 slack のコミュニケーションや勉強会の開催などを通じて、ドキュメントをパワーアップしたい人、ドキュメントや翻訳で苦労している人、Sphinxの
クールなURIとは？ クールなURIとは変わらないもののこと。 どんなURIが変わってしまう？ URIは変わらない：人がそれを変更するのだ。 理屈の上では、人々がURIを変更するべき（もしくはドキュメントのメンテナンスをやめてしまう）理由は全くありません。しかし、現実には山ほど理由があります。 理論上では、ドメイン名空間の所有者はその空間を所有しており、したがってその中に含まれるURIも所有権を持ちます。ドメイン維持料が支払えない場合を除いて、その名前を保有し続けることを妨げるものはありません。そして理論上は、あなたのドメイン名のもとにあるURIは、完全にあなたの管理下にあり、望む限りそれを安定的に保つことができるのです。 ウェブからあるドキュメントが消えてしまう唯一の納得できる理由は、そのドメイン名を保持していた会社が廃業してしまうか、サーバーを維持できなくなったという場合ぐらいでしょう
Swaggerとは何か？ - プログラマでありたい
最近、Swaggerという単語を聞く機会が増えていませんか？MicrosoftやGoogle,IBMが、REST APIの記述標準化を目指した「Open API Initiative」という団体を立ち上げ、そのベースをSwaggerを利用するということで一躍注目を集めるようになりました。しかし、Swaggerというものを調べるとツールの話やドキュメントの話が出てきて、何なのこれとなることが必定です。ということで、WebAPIとは切っても切れない関係のSwaggerの話を簡単にしてみます。 Swaggerとは？ Swaggerとは、一義的にはREST APIを記述する為の仕様です。当初から、Swaggerが標準の仕様になることを目指しますよと宣言していて、米国等ではデファクト・スタンダードとなっていました。それが、「Open API Initiative」が出来たことにより、実際に標準の仕様
はじめに 自分は実務でReact×TypeScriptを利用したフロント周りとNode.js(Nest)やRailsを用いたバックエンド(API)の開発をしています。 本記事では、OpenAPIを用いたAPI設計の書き方及び、Swaggerの説明と使い方についてまとめていきます。 この記事の対象者 プログラミング初心者から中級者 APIの基礎を理解している人 OpenAPIを用いてサクッとモックサーバーを試したい人 この記事の目標 モックサーバーの環境構築を学ぶ Swaggerの使い方を理解する OpenAPIを用いてAPI設計の具体的な書き方を学ぶ この記事でやらないこと 本記事ではOpenAPIの「書き方」をメインで解説するため、API設計についての細かい解説は省きます。 なおAPI設計については下記の記事でまとめているので、ぜひ参考にしてみてください。 用語解説 OpenAPI 公式
REST APIをテストすることができるデスクトップクライアント「Insomnia 3.0」。現在Mac/Windows/Linux用のデスクトップアプリを無料でダウンロードすることができます(Pricing Plansによると、個人用のデスクトップアプリは無償で利用できるかわりに、チーム・企業向けの有料プランが計画されているようです)。 Insomnia 3.0はChromeアプリとして公開されていたv2.0と異なり、完全なデスクトップアプリとして書き直されています。 REST APIをテストするためのクライアントアプリで、様々なHTTPリクエストを素早く組み立て、リクエストに対するレスポンスを詳細に確認することが可能です。ワークスペースを使用してリクエストを管理し、ドラッグ＆ドロップで整理したり、データをインポート・エクスポートする機能も搭載されています。 APIキーのようなリクエスト
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ITmedia エンタープライズ：実は、Ajaxのウラにこそ勝算がある (1/5)
ドリコム的Railsアプリ開発流儀
「Java による RESTful システム構築」 が超勉強になる!! - 宇宙行きたい
Efficient data transfer through zero copy
JSON API — A specification for building APIs in JSON
【面倒】風呂がめんどくさい！！ 理由と対策を考えた！｜今日はヒトデ祭りだぞ！
Best Practices for Designing a Pragmatic RESTful API
高いパフォーマンスを発揮するには90〜120分ごとに休憩が必要〜心理学者調べ | ライフハッカー・ジャパン
Go言語で基本的なCRUD操作を行うREST APIを作成 | DevelopersIO
maeda.na@はてな - ITpro Challenge!のメモとか
Edge Components 概念、計画とインストール / WebSphere Application Server
ActiveResource の使い方（前編） : Rails 同士で通信する - WebOS Goodies
OpenAPIを使ってAPIドキュメントとモックサーバーを良い感じにした話
良いURLについて考える - builder by ZDNet Japan
GraphQLを勉強した - mizchi's blog
『Web API: The Good Parts』読んだ - ✘╹◡╹✘
クールなURIは変わらない -- Style Guide for Online Hypertext
OpenAPI (Swagger) まとめ - Qiita
シンプルかつ美しいREST APIクライアント「Insomnia 3.0」 | ソフトアンテナ
https://lowlife.jp/yasusii/stories/9.html/