並び順

ブックマーク数

期間指定

  • から
  • まで

1 - 40 件 / 146件

新着順 人気順

RESTの検索結果1 - 40 件 / 146件

RESTに関するエントリは146件あります。 開発api設計 などが関連タグです。 人気エントリには 『きちんと休むことが、「高度な技術」であることを多くの人は知らない』などがあります。
  • きちんと休むことが、「高度な技術」であることを多くの人は知らない

    今、多くの人が、気付かぬうちに疲れやストレスを抱えています。 科学技術の高度化により、私たちは便利で快適な生活を手に入れやすくなりました。ほとんどの人がスマートフォンやタブレットなどを手にし、ネットで手軽に有益な情報や娯楽を得ることができます。 それでも、心と身体のバランスを崩してしまう人は後を絶ちません。精神を患う人、睡眠に問題を抱える人、メンタルヘルスの不調による休職者は増加し続けています。 コミュニケーションがますます複雑化した結果、情報が多すぎて処理しきれなくなり、何を信じ、何を頼りにして生きればいいのか分かりにくくなっているのかもしれません。 家に帰ってきても、心配事がなくなることはなく、知らず知らずのうちに心身が疲弊してしまっている人、限界までストレスをためてしまっている人、心の傷を負ってしまっている人が少なくないのです。 そして、「いくら休んでも、疲れがとれない」「そもそも、

      きちんと休むことが、「高度な技術」であることを多くの人は知らない
    • API設計スキルを次のレベルに引き上げるベストプラクティス22選 - Qiita

      本記事は、Mohammad Faisal氏による「22 Best Practices to Take Your API Design Skills to the Next Level」(2021年4月15日公開)の和訳を、著者の許可を得て掲載しているものです。 API設計スキルを次のレベルに引き上げるベストプラクティス22選 REST API設計のための実践的アドバイス Photo by Andrea Piacquadio from Pexels はじめに すべてが分かりにくく、ひどいAPIに不満を感じたことはありませんか?私はそうです。 マイクロサービスの世界では、バックエンドAPIの一貫した設計が不可欠です。 今日は、知っておくべきベストプラクティスについて、簡潔に説明します。さあ始めましょう! 用語 API設計は、リソース指向設計というものに従います。3つの重要な概念で構成されていま

        API設計スキルを次のレベルに引き上げるベストプラクティス22選 - Qiita
      • 現場で役立つAPIデザイン

        Web APIは外部連携のために公開するだけでなく、システム内部での利用も一般的になっており、重要性はますます高まっています。しかし、APIデザインについての知見はまだ広く浸透していません。書籍やオンライン情報はいろいろありますが、本セッションではその中から重要な要素をピックアップし、実際の著名なサービ…

          現場で役立つAPIデザイン
        • 意地悪なベンチ バス停にも公園にも 公共の場で増殖する「排除アート」 | 写真企画 うちな〜う | 沖縄タイムス+プラス

          屋根を撤去した休憩所/琉球王国時代に程順則、蔡温、山田親雲上の3賢者がここで語り合ったと伝わる三文殊公園。休憩所の屋根が撤去されて柱だけが残り、語り合うには適さない場所になっている=18日、那覇市辻

            意地悪なベンチ バス停にも公園にも 公共の場で増殖する「排除アート」 | 写真企画 うちな〜う | 沖縄タイムス+プラス
          • 独自Webアプリや社内ツールが作り放題のオープンソース開発環境「ToolJet」を使ってみた! -

            どうも、まさとらん(@0310lan)です! 今回は、さまざまなWebサービスやデータベースと連携して、独自のWebアプリなどを手軽に開発できるサービスをご紹介します! データソースの連携や画面デザインなどはドラッグ&ドロップの操作で簡単に構築が可能で、ロジックやイベント処理などもわずかなJavaScriptを利用するだけで開発できるのが特徴です。 オープンソースで開発が進められており、セルフホストすることで大きな制限もなく活用できるのでご興味ある方はぜひ参考にしてください。 【 ToolJet 】 ■「ToolJet」の使い方 それでは、「ToolJet」をどのように使えばいいのか詳しく見ていきましょう! まずはメールアドレスを入力したら【Create an account】ボタンをクリックして無料のユーザー登録を済ませておきます。 メールアドレス宛にユーザー登録用のリンクが送付されるの

              独自Webアプリや社内ツールが作り放題のオープンソース開発環境「ToolJet」を使ってみた! -
            • API設計まとめ - Qiita

              Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? はじめに 自分は2021年に新卒でWeb系の開発会社にフロントエンジニアとして入社し2022年で2年目になります。 実務ではReact×TypeScriptを利用したフロント周りとNode.js(Nest)やRailsを用いたバックエンド(API)の開発をしています。 その中で使っていたAPI設計について改めて学び直したのでまとめて行きます。 この記事の対象者 エンジニア初心者から中級者 APIについて学びを深めたい人 この記事の目標 APIについて学ぶ 我流ではなく正しいAPI設計について学ぶ この記事でやらないこと 具体的にコードを

                API設計まとめ - Qiita
              • RESTful のウェブ API 設計で避けるべき 6 つのよくあるミス | Google Cloud 公式ブログ

                ※この投稿は米国時間 2022 年 12 月 1 日に、Google Cloud blog に投稿されたものの抄訳です。 オンラインで、組み立て式のテーブルを注文したとします。ところが、パッケージを開けてみると、組立説明書が入っていません。完成品がどんなものかはわかっていても、それぞれのパーツをどう組み立てればいいのか、まるでわかりません。設計が不十分な API を使うコンシューマ開発者も、同じような経験をしているといえます。適切に設計された API なら、容易に見つけ、検索してアクセスし、使用することができます。高品質の API は、コンシューマ開発者がアイデアをひらめき、新しいユースケースを作り上げる手助けになってさえくれます。 もちろん、API 設計を改善する方法はあります。たとえば、RESTful のプラクティスに従うなどです。しかし、お客様が知らず知らずのうちに、ちょっとした不便

                  RESTful のウェブ API 設計で避けるべき 6 つのよくあるミス | Google Cloud 公式ブログ
                • Microsoft の「クラウドアプリケーションのベストプラクティス」が良かったので紹介したい | DevelopersIO

                  こんにちは。CX事業本部MAD事業部のYui(@MayForBlue)です。 最近調べものをしている中で見つけたドキュメントが良かったのでご紹介したいと思います。 先にまとめ Microsoft の RESTful Web API の設計 のドキュメントが API 設計を考える上で勉強になった 関連する クラウド アプリケーションのベスト プラクティス のドキュメントもアプリケーションを設計する際の指標として良さそう RESTful Web API の設計 最近 API 設計やパス設計について考える機会があったのですが、これという正解がなかったり、人によって思想やこだわりが違ったりして結構難しいなと感じていました。 そんな中で下記のドキュメントを見つけてひとつの指標として良いなと思ったのでご紹介します。 内容(項目) REST とは何か リソースを中心とした API 設計の整理 HTTP

                    Microsoft の「クラウドアプリケーションのベストプラクティス」が良かったので紹介したい | DevelopersIO
                  • GraphQL を利用したアーキテクチャの勘所 / Architecture practices with GraphQL

                    iCARE Dev Meetup 20 で発表した資料です #icare_meetup p.7,8,61 https://graphql.org/ p.18 https://twitter.com/a_suenami/status/1379270185207484417 p.33 [SQLQL…

                      GraphQL を利用したアーキテクチャの勘所 / Architecture practices with GraphQL
                    • GraphQLが解決する問題とその先のユースケース

                      サーバーサイドからみたGraphQL Serverlss Meetup#19 2021/03/31 に行われた Serverlss Meetup#19 で上記のタイトルで登壇してきました。サーバーサイドの話をしようと思ったけどGraphQLの解決している話をしようと思ったらクライアントの事もかなりはいってしまったので記事のタイトルは変えました。 以下内容です。記事の最後に資料を書くにあたって参考になった資料のリンクを置いてます。 GraphQL and me この1年書いたQiita記事 GraphQLの特徴を分解する ~API インターフェース・Universal BFF・API Gateway~ GraphQLはサーバーサイド実装のベストプラクティスとなるか GraphQLの全体像とWebApp開発のこれから 今回話す事 そもそもGraphQLはなんで作られたのか、何を解決しようとして

                        GraphQLが解決する問題とその先のユースケース
                      • Page Not Found - Mibet Energy

                        Or you can return to our home page, or contact us if you can’t find what you are looking for.

                        • ホテルでタバコを吸っていないのに7万円超えの喫煙代を請求される事例が多発、喫煙センサーのサイトには「Win-Win-Win」の文字が

                          ホテルでは禁煙ルームと喫煙ルームが明確に分かれていることがほとんどで、禁煙ルームでタバコを吸ったことが発覚すると追加料金が発生することもあります。アメリカのとあるホテルでは「タバコを吸っていないのに、吸ったと決めつけられて、追加料金を請求された」という事態が多発しています。 I was just scammed by a @Hyatt hotel — and what I’ve uncovered so far points to a *much* bigger issue. A 🧵 (1/13)— Zach Griff (@_ZachGriff) July 17, 2025 旅行関連ジャーナリストのジャック・グリフ氏は2025年7月にロードアイランド州にあるハイアットの「The Pell」というホテルに宿泊しました。グリフ氏は妻と8カ月になる娘と共に宿泊していたとのこと。 そして、チェ

                            ホテルでタバコを吸っていないのに7万円超えの喫煙代を請求される事例が多発、喫煙センサーのサイトには「Win-Win-Win」の文字が
                          • Hacker News 日本語まとめ

                            1996 "Authentic" Beta Pokemon Cards Exposed as 2024 Prints via Printer Dots->

                              Hacker News 日本語まとめ
                            • なぜ HTML の form は PUT / DELETE をサポートしないのか? | blog.jxck.io

                              Intro 10 年ほど前に同じことを調べたことがある。 なぜ html の form は PUT / DELETE をサポートしないのか? - Block Rockin' Codes https://jxck.hatenablog.com/entry/why-form-dosent-support-put-delete 当時は全くの素人で、素人なりに調査はしたが、ほとんどが推測の域を出ない結論だった。 この問題についてあらためて記す。 仕様策定の経緯 表題の通り、<form> の method には GET と POST しかサポートされていない。HTTP には他にも PUT や DELETE といったメソッドもあるのに、なぜサポートされていないのかという疑問から始まった。 仕様が決定した経緯は、以下に残っている。 Status: Rejected Change Description:

                                なぜ HTML の form は PUT / DELETE をサポートしないのか? | blog.jxck.io
                              • サクッとAPIを叩く方法 (VS CodeでHTTPリクエストが送れちゃう拡張機能) - Qiita

                                概要 開発中のAPIを試したり、サードパーティのAPIをサクッと叩いてみたいといった時に皆さんどのようにしますか? 私は、curlコマンドやPostmanをよく使っています。 ただ、もっと楽にHTTPリクエストを投げ、かつその時使用した情報を残すことができる方法を以前のチームメンバーに教えていただいたので、記事にしました。 REST Client 今回、紹介するのはVS CodeのエクステンションにあるREST Clientというものになります。 このREST ClientというのはVS Code上でHTTPリクエストを送信し、レスポンスを確認できる拡張機能となっています。 使用方法 使用方法はすごく簡単で、拡張子が「.http」か「.rest」というファイルで決められた構文に従いHTTPリクエストを記述するだけです。 下記にcrudの例を載せていきたいと思います。 また今回はREST A

                                  サクッとAPIを叩く方法 (VS CodeでHTTPリクエストが送れちゃう拡張機能) - Qiita
                                • REST API設計のパターンと原則|Sachiko Kijima

                                  APIの設計って意外と移り変わりがあるんです。例えばAPIのバージョンの指定方法がヘッダーを使う方法からURLを使う方法にだんだん統合されてきました。 したがって本やスライドなど、その時点のベストプラクティスを読むよりは、生きているベストプラクティスを読んだ方が良いと思います。 ここではいくつか参考になるリソースのご紹介と、よく聞かれる質問について触れておきます。 設計ガイドライン、スタイルガイドAPIの設計のベストプラクティスを把握するためによくAPIのドキュメントを見ているのですが、特にご紹介したいのはスタイルガイドや設計ガイドです。 マイクロソフトのAPIガイドライン

                                    REST API設計のパターンと原則|Sachiko Kijima
                                  • HTTP検索条件、GETにするか?POSTにするか? | フューチャー技術ブログ

                                    はじめにTIG DXユニット 1真野です。 RESTfullとかRESTishな方針でWebA PIの横断検索を設計する際にチーム内で方針について議論したやり取りの備忘記事です。 注意としてB2C向けなWeb APIを提供するというよりは、主に企業間または企業内部で使われるようなAPIの設計のバイアスがあります。LSUDs(Large Set of Unknown Developers)かSSKDs(Small Set of Known Developers)で言えば、確実にSSKDs脳で記事が書かれています。 REST API広く使われているため日本語記事も多数です。実践RESTful HTTP - InfoQ や、0からREST APIについて調べてみた など良さそうな記事が沢山でてくるの読むと良いでしょう。一般的な設計方法はやや古いですがWeb API: The Good Parts

                                      HTTP検索条件、GETにするか?POSTにするか? | フューチャー技術ブログ
                                    • RESTful API との比較で GraphQL API を作ることの難しさ|qsona

                                      上の資料でも書いてるんですが、要点を言うと以下のようなことを主張している。 API の設計手法として、以下の2つのパターンが考えられる ・Resource-based API ・Usecase-based API Usecase-based というのは要はクライアントの要求にそのまま沿った形で API を作るということだ。しかし、UI やその他クライアントの要求というのは変わりやすいものなので、そのたびにいちいち API を変更しないといけないとか、API に一貫性がなくて使いにくいとか、1つの endpoint で多数の要求に対処する "神API" が作られてパフォーマンスが悪化する、というような問題が起こる。 したがって、注意深く RESTful API を設計すると Resource-based になる。ここで言っている Resource というのはテーブル設計にやや近いが、そのまま

                                        RESTful API との比較で GraphQL API を作ることの難しさ|qsona
                                      • Web API設計ガイドラインを公開しました | フューチャー技術ブログ

                                        こんにちは。Strategic AI Group の佐藤です。 フューチャーでは さまざまなガイドラインを公開しており 、本ブログでも 「ガイドライン」タグ に過去の紹介記事がいくつか載っています。Web API に関するガイドラインも昨年11月から検討を開始し、今年の 1/17 に 公開されました! 本記事はそのご紹介です。 4ヶ月も寝かせていて本当に申し訳ありません 本ガイドラインの経緯フューチャーでは様々な規模、様々な環境で動くシステムを構築しています。システム開発におけるバックエンド設計かくあるべしという共通知識は大規模システムに偏っていて、昨今急速に数を増やしている Web ベースのシステムに限った話というものはあまり言語化されていませんでした。 そこで今回、設計の属人性を軽減させ、知識の横展開を容易にするべくガイドラインを作成・公開しました。当初はHTTPメソッドやステータスコ

                                          Web API設計ガイドラインを公開しました | フューチャー技術ブログ
                                        • 令和時代のページネーションを考える (REST API編) - Sweet Escape

                                          今回はバックエンドAPIでページネーションをどうやるかについての話なので、よくある無限スクロールUIのようなフロントエンド側の実装に関する話はしない。あくまでもAPI、もっと言えばRESTfulなAPIのリクエスト・レスポンスにおけるページネーションの話。 本気で深く考えるというよりざっくり検討したときの話です。 はじめに REST APIを実装するにあたってリスト系のAPIを提供する場合に必須といっても過言ではないのがページネーション。大量のリソースをレスポンスする場合にそれらを一気に返してしまうことは応答速度、転送量、クライアントサイドでの扱いづらさなどなどに繋がるので必須と言える。 最近、新たなAPIを開発するにあたってページネーションをする必要があったこともあり、今回はこのページネーションをどうやって提供するか整理して改めて検討してみた。 前提 TypeScript Nest.js

                                            令和時代のページネーションを考える (REST API編) - Sweet Escape
                                          • GraphQLはどんな時に使うか

                                            @saboyutaka 合同会社春秋 Tech Base Okinawa 2023

                                              GraphQLはどんな時に使うか
                                            • GraphQLの誤解/rethinking-graphql

                                              GraphQL実践ノウハウ https://speakerdeck.com/sonatard/graphql-knowhow GraphQL実践ノウハウv2 https://speakerdeck.com/sonatard/graphql-knowhow-v2 宣言的UIの状態管理とアー…

                                                GraphQLの誤解/rethinking-graphql
                                              • CloudFrontとS3で作成する静的サイト構成の私的まとめ | DevelopersIO

                                                しばたです。 以前の記事でも触れた様にCloudFrontとS3を使って静的サイトを作る構成に対する理解にあいまいな部分があったので改めてまとめてみました。 特に目新しい話も無く知っている人には当たり前の内容かもしれませんが、まあ、自分自身の理解を整理するために記事にしていきます。 1. S3静的ウェブサイトを使うパターン はじめの構成は「S3静的ウェブサイト」を使ったパターンです。 S3にはバケットの内容を静的ウェブサイトとしてホストできる静的ウェブサイトホスティングの機能があります。 この機能ではHTTPのみ利用可能なためHTTPSを使う場合はCloudFrontと組み合わせる必要があります。 S3静的ウェブサイトを使うにはバケット内のコンテンツを公開する必要があり、S3バケットはパブリックアクセス可能にする必要があります。 また、必ずHTTPのWEBサイトが公開されることになるためユ

                                                  CloudFrontとS3で作成する静的サイト構成の私的まとめ | DevelopersIO
                                                • RESTful のウェブ API 設計で避けるべき 6 つのよくあるミス | Google Cloud 公式ブログ

                                                  ※この投稿は米国時間 2022 年 12 月 1 日に、Google Cloud blog に投稿されたものの抄訳です。 オンラインで、組み立て式のテーブルを注文したとします。ところが、パッケージを開けてみると、組立説明書が入っていません。完成品がどんなものかはわかっていても、それぞれのパーツをどう組み立てればいいのか、まるでわかりません。設計が不十分な API を使うコンシューマ開発者も、同じような経験をしているといえます。適切に設計された API なら、容易に見つけ、検索してアクセスし、使用することができます。高品質の API は、コンシューマ開発者がアイデアをひらめき、新しいユースケースを作り上げる手助けになってさえくれます。 もちろん、API 設計を改善する方法はあります。たとえば、RESTful のプラクティスに従うなどです。しかし、お客様が知らず知らずのうちに、ちょっとした不便

                                                    RESTful のウェブ API 設計で避けるべき 6 つのよくあるミス | Google Cloud 公式ブログ
                                                  • GraphQLはいつ使うか、RESTとの比較

                                                    さぼです、沖縄でWebと設計について考えてます。2023/09/23 に沖縄で行われたTechBaseOkinawa2023 にて上記のタイトルで登壇しました。 今回の内容は GraphQLを設計の観点から考えてみる GraphQLの目的や用途を整理する GraphQLを使う時、または使わない時のヒントを持ち帰ってもらう 最近、GraphQLじゃなくてRESTで良くないと思うケースがなんとなくわかってきたのでそれを共有する という感じで話しました。話した内容を文字に起こし少し改修してZennでも共有することとします。 まえおき 最近はクライアントAppとサーバーAppを分けて実装する事が増えてきた クライアントの環境はますます複雑になっている クライアントとサーバーはWebAPIで通信を行う クライアントが複雑になるのと同時にWebAPIの要求が更に増して来ている APIの要求・応答を効率

                                                      GraphQLはいつ使うか、RESTとの比較
                                                    • 【徹底解説】REST VS GraphQL

                                                      注意:今回の記事で載せているコードは読者に具体的なコードのイメージを持たせる目的で書いている。それ故に、実際にブラウザ上で実行しても動作しない点には注意してほしい。より専門的ににGraphQLとRESTの違いを学びたいならLogRocketの記事とApolloの記事を参考に。 はじめに 今回の記事では、Web APIの開発に重宝されるRESTとGraphQLの違いを解説する。 対象とする読者 これからREST、またはGraphQLを実務で積極的に活用したいひと 両者の違いがわからないひと 個人開発等でWeb APIをつくるひと タイトルを見てなんとなく気になったひと APIとは RESTとGraphQLの議論に入る前に、まずはAPIについて説明する必要がある。 Wikipediaによると、API(Application Programming Interface)は以下のように定義されてい

                                                        【徹底解説】REST VS GraphQL
                                                      • 9ヶ月かけて全ての API を REST から GraphQL にリプレースした話 - がぶちゃんの日記

                                                        サマリー システム構成の変遷 創業フェーズ はじめての API と技術選定 GraphQL 移行直前 GraphQL への移行を決めたきっかけ GraphQL 移行方針 移行期間 ふりかえり 1つ目の方針は正解だった 2つ目の方針は微妙だったかもしれないけど、正解だったかもしれない 3つ目の方針はやはり苦戦した さいごに サマリー サービス開始から3年経った Next.js + Rails なシステム 全ての API を REST から GraphQL にリプレース 約9ヶ月かかりました 早速フロントエンドの都合でバックエンドにも手を入れるということが減って快適です という話です。 システム構成の変遷 創業フェーズ 1人目エンジニアとして入社して、何から手を付けようかなーと考えた結果、事業の肝の部分からシステム化していくことにしました。弊サービス https://moneiro.jp/ は

                                                          9ヶ月かけて全ての API を REST から GraphQL にリプレースした話 - がぶちゃんの日記
                                                        • REST API 設計指針・セキュリティ編

                                                          過去2回の記事でREST API 設計指針をまとめてきました。 REST API 設計指針・認証認可編 REST API 設計指針・通信、パラメーター編 今日は第三回かつ最終回のセキュリティ編です。セキュリティは非常に幅広い概念であり、考慮すべきことは山盛りですが、まずは基本的な考え方から。 加害者と被害者の逆転現象 悪意のある第三者からの攻撃などにより何某かのインシデントが発生して、サービスが停止したり、情報漏洩が起きてしまった場合、サービス事業者はステークホルダーにお詫び、時には直接的な金額による賠償を行うことになります。本来システムを攻撃された被害者側ですが、加害者であるかのような扱いをされるケースがあります。一方インシデントの種別によっては世の中が同情的になるケースもあります。この違いについてですが、一般的によく用いられる対策をとっていたかどうかが大きな分岐点となります。 攻撃され

                                                            REST API 設計指針・セキュリティ編
                                                          • Why, after 6 years, I’m over GraphQL

                                                            GraphQL is an incredible piece of technology that has captured a lot of mindshare since I first started slinging it in production in 2018. You won’t have to look far back on this (rather inactive) blog to see I have previously championed this technology. After building many a React SPA on top of a hodge podge of untyped JSON REST APIs, I found GraphQL a breath of fresh air. I was truly a GraphQL h

                                                            • MCPはAPIではない - 単純変換してはいけない理由 - 吉田の備忘録

                                                              Microsoft Copilot Studio でカスタムのエージェントを最近作り始めた方は、システムとの連携にMCPを利用したり、APIも利用することもあると思います。ありがちな勘違いが、APIをそのままMCPにすればいいじゃないか?という考えを持つこともありますが、MCPの本質を理解し、何が違うのかを理解することで、より良いエージェントを作れるようになります。そこで今回はMCPとAPIの違いについて、触れたいと思います。 MCP ってそもそも何? MCP(Model Context Protocol)は、Anthropic が 2024 年末に公開したオープンプロトコルです。狙いは、大規模言語モデル(LLM)が外部サービスをもっと自然に扱えるようにすることです。 基本的には 3 つの要素があります。 ツール― LLM が実行できる“アクション”。 リソース― ツールが扱う対象物や I

                                                                MCPはAPIではない - 単純変換してはいけない理由 - 吉田の備忘録
                                                              • Go言語で基本的なCRUD操作を行うREST APIを作成 | DevelopersIO

                                                                はじめに Javaのエンジニアだった私がGo言語でREST APIを作る上で学んだことをまとめています。 プロジェクト構成、単体テスト、Dockerイメージの作成など実際にREST APIを開発する上で必要だと思われる要素を盛り込みつつサンプルプロジェクトを作成していきます。 今回はできるだけ外部ライブラリやフレームワークを使わずにGo言語の標準機能のみで開発しました。 これからバックエンドにGo言語を使用することを検討されている方の参考になれば幸いです。 ※この記事は既にGo言語の開発環境をセットアップ済みで基本的な文法を学習済みの方を想定しています。 動作環境 今回使用した動作環境は以下のとおりです。 PC : Mac M1(Apple Silicon)チップ OS : macOS Big Sir 11.5.2 Go : 1.17.1 Docker Desktop : 4.0.0 En

                                                                  Go言語で基本的なCRUD操作を行うREST APIを作成 | DevelopersIO
                                                                • OpenAPI (Swagger) まとめ - Qiita

                                                                  はじめに 自分は実務でReact×TypeScriptを利用したフロント周りとNode.js(Nest)やRailsを用いたバックエンド(API)の開発をしています。 本記事では、OpenAPIを用いたAPI設計の書き方及び、Swaggerの説明と使い方についてまとめていきます。 この記事の対象者 プログラミング初心者から中級者 APIの基礎を理解している人 OpenAPIを用いてサクッとモックサーバーを試したい人 この記事の目標 モックサーバーの環境構築を学ぶ Swaggerの使い方を理解する OpenAPIを用いてAPI設計の具体的な書き方を学ぶ この記事でやらないこと 本記事ではOpenAPIの「書き方」をメインで解説するため、API設計についての細かい解説は省きます。 なおAPI設計については下記の記事でまとめているので、ぜひ参考にしてみてください。 用語解説 OpenAPI 公式

                                                                    OpenAPI (Swagger) まとめ - Qiita
                                                                  • Web API開発実践ガイド | 技術評論社

                                                                    Software Design別冊 Web API開発実践ガイド ―⁠―REST/gRPC/GraphQLからテスト、セキュリティまで 著者 杉本和也,津郷晶也,太⽥佳敬,武田大輝,宮崎将太,福岡秀一郎,武上将樹,渋川よしき,真野隼記,小谷優空,和田祐汰,浦優太,金井祐樹,内山高広,上原拓也,sumiren,川崎庸市,こたうちさんさん,石川朝久,徳丸浩,松本隆則,川村修平 著 定価 2,420円(本体2,200円+税10%) 発売日 2025.8.18 判型 B5 頁数 192ページ ISBN 978-4-297-15062-4 978-4-297-15063-1 概要 『Software Design』特集記事のうち、大好評を博したWeb API特集記事を1冊に収めました。 もはやWebにとって、Web APIこそが要です。Web APIを適切かつ効率的に開発できるかどうかが、Webサー

                                                                      Web API開発実践ガイド | 技術評論社
                                                                    • AI Ready API ─ AI時代に求められるAPI設計とは?/ AI-Ready API - Designing MCP and APIs in the AI Era

                                                                      Presentation slides for Azure OpenAI Service Dev Day 2025 Session title: AI Ready API ─ AI時代に…

                                                                        AI Ready API ─ AI時代に求められるAPI設計とは?/ AI-Ready API - Designing MCP and APIs in the AI Era
                                                                      • ネットスーパーアプリ GraphQL から REST へ移行始めました - every Tech Blog

                                                                        はじめに こんにちは、retail HUBで Software Engineer をしているほんだです。 今回は私が現在着手している事業譲渡されたアプリを社内で持続的なプロダクト開発を行える状態にするリプレイスプロジェクトをどのように行っているか紹介しようと思います。 この記事ではリプレイスを行うにあたってどのようなことを課題に感じてその課題に対してどのような解決策をとったか主にサーバーの実装について説明しています。 ネットスーパーアプリとは 現在弊社ではネットスーパーアプリとして Web アプリとスマホアプリの二つのシステムを提供しています。 Web アプリは販促コンテンツの設定や売り上げの管理・集計を行うことが可能な管理システムと受け取り方法に応じた価格変更や送料変更にも対応し、消費者の柔軟な買い物を実現するお客様向けアプリを 17 の小売り様に、スマホアプリでは Web アプリのお客

                                                                          ネットスーパーアプリ GraphQL から REST へ移行始めました - every Tech Blog
                                                                        • REST API 型安全を目指して 〜スキーマ駆動開発を支える技術〜 | su8ru

                                                                          Previous slideNext slideToggle fullscreenOpen presenter view REST API 型安全を目指して 〜スキーマ駆動開発を支える技術〜 すばる / su8ru 2024-11-29 | 北大合同勉強会 2025 冬 https://slides.su8.run/241129-sdd 自己紹介 すばる / su8ru 北海道大学工学部 情報エレクトロニクス学科 2 年 HUIT / 3D 研 / JagaJaga (Hupass) Twitter: @su8ru_n <- New!! GitHub: @su8ru すきなもの:TypeScript / 初音ミク / 鏑木ろこ / ヰ世界情緒 お仕事でフロントエンドを、趣味でバックエンドを書いています 北大生による、北大生のための時間割アプリ サーバー実装のフルリプレース (および iNA

                                                                            REST API 型安全を目指して 〜スキーマ駆動開発を支える技術〜 | su8ru
                                                                          • Web API設計ガイドライン

                                                                            免責事項 有志で作成したドキュメントである。フューチャーには多様なプロジェクトが存在し、それぞれの状況に合わせて工夫された開発プロセスや高度な開発支援環境が存在する。本ガイドラインはフューチャーの全ての部署/プロジェクトで適用されているわけではなく、有志が観点を持ち寄って新たに整理したものである相容れない部分があればその領域を書き換えて利用することを想定している。プロジェクト固有の背景や要件への配慮は、ガイドライン利用者が最終的に判断すること。本ガイドラインに必ず従うことは求めておらず、設計案の提示と、それらの評価観点を利用者に提供することを主目的としている掲載内容および利用に際して発生した問題、それに伴う損害については、フューチャー株式会社は一切の責務を負わないものとする。掲載している情報は予告なく変更する場合がある はじめに ​本ガイドラインはWeb APIを利用する開発者向けに、RE

                                                                            • RESTful APIの設計、開発、ドキュメント管理を手助けする「RAML」とは

                                                                              APIの開発は複雑でコストがかかる可能性があり、頻繁に更新されることからドキュメントを整備するのも難しい。APIの設計、開発、ドキュメントの整備、管理にまつわる課題と効率さの問題に対処するアプローチが、RESTful API Modeling Language(RAML:RESTful APIモデリング言語)だ。 RAMLコードを使えば、開発者はAPIの動作を説明する仕様を策定してからそのAPIをデプロイするまでのAPIライフサイクルを管理することができる。 RAMLとは RAMLは、RESTful APIを記述することを目的とするオープンソースの記述言語だ。2013年、米国のIT自動化および統合ベンダーであるMuleSoftを中心とする数社の企業によって作成されたRAMLはAPIの開発に大きな役割を果たしてきた。2018年、MuleSoftはSalesforceによって買収され、RAML

                                                                                RESTful APIの設計、開発、ドキュメント管理を手助けする「RAML」とは
                                                                              • Goで作られたシステムをRuby on Railsに移植しています - STORES Product Blog

                                                                                STORES でエンジニアをしている片桐です。 STORES では店舗運営に関するさまざまなプロダクトを提供しています。これらのプロダクトは元々別の会社で運営されてきた完全に異なるプロダクト群で、アカウント体系から全く異なるシステムになっていました。近年はこれらのシステムを本格的に統合する取り組みを進めてきており、その中で統合のためにいくつかのシステムが新たに作成されてきました。 ある程度統合が進み、うまくいったところ・いかなかったところが見えてきた中で、これまでに作ったシステムの技術選定・システムの役割に対する課題感が見えてきました。 現在弊社ではこの課題を解決していくプロジェクトを進めています。その中の1つで、Goで作られたシステムをRuby on Railsで作られたシステムに移植する作業を行なっているので、今回はそれについて紹介させていただきます。 移植元のシステムの課題 今回別シ

                                                                                  Goで作られたシステムをRuby on Railsに移植しています - STORES Product Blog
                                                                                • すべての Web サービス設計者に捧ぐ「RESTful って結局なんなんだ」

                                                                                  誰もがその戦いの背景にある歴史の深淵と人々の覚悟を見誤っていた。開戦初日に決着が付くと高を括って鼻歌混じりに筆を取った私は、気が付けば夏休みの8割を喪失し、すべての指が腱鞘炎で悲鳴を上げる中で参考文献の海に這いつくばっていた。 —— Josh Nobus —— ぜんぜんわからない 俺たちは雰囲気で REST をやっている 何度調べてもなんだかよく分からない概念ランキングの個人的 Top5 に入る言葉。 それが「REST」だ。 いろんな Web サービスの REST API はよく使わせてもらっているし、REST API が何かと聞かれれば「その Web サービスの機能を HTTP リクエストで呼び出せる API エンドポイントのことだよ」みたいにそれっぽくお茶を濁すことはできると思うが、じゃあ自分で RESTful なサービスを作ってみろと言われたら私は作れない。作れなかった。 だってどん

                                                                                    すべての Web サービス設計者に捧ぐ「RESTful って結局なんなんだ」

                                                                                  新着記事