モダンなWebアプリについて調査してるとよく出てくるJerseyってなんなのかが気になった。 セットで出てくるJAX-RSってのもついでに調べてみた。 そもそもJAX-RSとは JAX-RS = Java API for RESTful Web Services JavaでつくるリッチなWebアプリのためのAPI（HTTPを直接扱う高水準API） JerseyはJAX-RSのリファレンス実装 RESTっていうWebのアーキテクチャスタイルがあって、 このスタイルに沿って作成されたWebサービスがRESTful Web Service. Javaで作りたい場合、JAX-RSってAPIを使うと幸せになれる。 JAX-RSを参照実装しているJerseyってAPIを使うともっと幸せになれる。 つまり... Jerseyとは、Javaで作るWebアプリをREST対応にするために必要な作業を簡素化でき
REST入門 基礎知識 はじめに RESTサービスを開発するにあたって勉強したことをまとめました。RESTとはなんぞやというところについて書いていきます。実際の開発方法等については当記事では触れません。 RESTとは REST(REpresentational State Transfer)はWebサービスの設計モデルです。RESTなWebサービスは、そのサービスのURIにHTTPメソッドでアクセスすることでデータの送受信を行います。 例としてQiitaのREST APIを利用してみます。下記のURLにアクセスしてみてください。(ChromeかFirefoxでないと*.jsonファイルのダウンロードになる場合があります) https://qiita.com/api/v2/users/TakahiRoyte {}でくくられている文字が表示されたかと思います。これは JSON(JavaScri
Webやスマホアプリ開発に欠かせないRESTful APIとは？ REpresentational State Transferの略であるREST。RESTful APIは、基本的に「RESTの原則」に従って実装されているWebシステムのHTTPでの呼び出しインターフェースのことを指します。そのため、広義には、「REST APIとRESTful APIは同じものである」といっても間違いではありません。では、RESTful APIとは具体的にはどういったものなのでしょうか？ 今回はRESTful APIの概要や原則、そしてRESTful APIを使うことのメリットとデメリットについて紹介します。 RESTful APIの概要、REST、4つの原則とは？ RESTは、HTTPプロトコル作成者の一人であるRoy Fieldingによって2000年頃に提案されたもので、分散アプリケーションを構築す
最近は様々なサービスでWebAPIが提供されています。普段の開発をする中でもシステム連携などでAPIを作る機会が出てくるのではないでしょうか。 WebAPIの中でもREST APIなんてものもよく聞くのかなぁと思います。REST APIの設計は色々と奥が深く、なかなかおもしろい技術です。 今回はそんなREST APIを設計する上でのポイントをご紹介していきます。この記事では実装よりも設計思想的な部分を書いています。次回以降にもう少し実装に近いレベル記事を書いきます！ REST APIは、「Representational State Transfer（表現状態の転送）」というアーキテクチャスタイルに従って設計されたAPIのことです。RESTの概念は2000年にRoy Fieldingによって提唱され、Webアーキテクチャにおける一つの重要な原則として広く認識されています。 じゃあ、REST
次に、HTTP API の場合ですが、VPC リンクの実態は ENI です。 ENI は作成しても追加費用はありませんし、データ処理料金の発生もありません！(AZ 間通信などの通常料金は発生します) REST API の構成図（例） REST API の場合、Private Link による接続ですので、API Gateway 側の ENI は VPC 外ということになります。 HTTP API の構成図（例） HTTP API の場合、API Gateway の基盤ネットワークからターゲットの VPC 内に ENI で延伸することになります。 図を見て解るとおり、HTTP API の各ターゲットリソースとして許可するのは VPC 内に伸びてきた ENI からの通信になります。よって、VPC リンクにアタッチされているセキュリティグループや、サブネットの CIDR を許可すると良いでしょう
見てみると、たしかに Get 系の API だとしても POST を利用しているし、API の URL 設計に get_shared_link_file のようによく言われる REST っぽい設計は使っていなかった。 この方針は同意だ。自分は結構前に REST っぽい API を捨てることにした。だからといって REST API がダメだとかは思っていない。 一般ユーザが使う場合の API は REST API であるほうが慣れ親しんでいる場合が多いからだ。 AWS で利用されている HTTP API 仕様AWS の DynamoDB の Erlang/OTP ドライバーを書いているときに気づいたのだが、AWS の一部のサービスはかなり独特な API の仕様になっている。
今年GitHubがGraphQL APIを正式公開したあたりから、GraphQLが去年とかに比べちょっと流行り始めたように感じる。idobataがGraphQL APIを公開したり、Kibelaも公開APIをGraphQLで作ることを宣言している。 利用者側からすると使えるインターフェースの中から必要なものを調べて使うだけなのであまり考えることはないのだが、自分がAPIを提供する立場になると話は変わってくる。REST APIとGraphQL APIはどちらかがもう一方のスーパーセットという風にはなっておらず、どちらかを選択すると何かを捨てることになるので、要件に応じてどちらを選ぶのが総合的に幸せなのか考える必要がある。 以前趣味でGitHub連携のあるサービスを作っており、それを最近GraphQL API v4を使うように移行し、そこでついでにそのサービスのGraphQL APIを書いてみ
注：単純なデータモデルでさえ、今後の維持や説明が必要になる6つものエンドポイントが含まれています。 あなたがクライアント側の開発者で、movies APIを使い、HTMLとjQueryで単純なWebページを作るとします。そのためには、映画と出演俳優・女優の情報が必要です。APIに必要な機能は揃っているので、データを取得します。 新しくターミナルを開いて以下を実行します。 curl localhost:3000/movies 以下の応答が返ってきます。 [ { "href": "http://localhost:3000/movie/1" }, { "href": "http://localhost:3000/movie/2" }, { "href": "http://localhost:3000/movie/3" }, { "href": "http://localhost:3000/mo
このページでは、Microsoft Graph と OneDrive API を使用するために必要になる手順の概要について簡単に説明します。 詳細な手順については、「Microsoft Graph クイック スタート」を確認してください。 SharePoint Server 2016 を使用して作業する場合、または Microsoft Graph を使用しない場合は、「SharePoint Server 2016 で OneDrive API を使用する」のトピックを参照してください。 1. ユーザー認証とアプリの承認 Microsoft Graph および OneDrive API では、承認に OAuth 2.0 を使用します。 OAuth フローを完了すると、アプリはユーザーの代わりに特定のアクセス許可のセットである Microsoft Grap へのアクセスを提供するアクセス トー
Rakuten Ichiba APIs Rakuten Ichiba Item Search API enables developers to retrieve information of selling items on Rakuten Ichiba excluding those listed on auctions, flea markets, customer to customer auctions (C2C) or joint purchases on Rakuten Ichiba. Developers are allowed to obtain the item information by specifying Keyword as well as to filter the search with Item Code, Shop Name or Genre Name
2016/10/12 社内勉強会で使ったスライドを社外向けに一部加筆訂正したもの
REST APIをテストすることができるデスクトップクライアント「Insomnia 3.0」。現在Mac/Windows/Linux用のデスクトップアプリを無料でダウンロードすることができます(Pricing Plansによると、個人用のデスクトップアプリは無償で利用できるかわりに、チーム・企業向けの有料プランが計画されているようです)。 Insomnia 3.0はChromeアプリとして公開されていたv2.0と異なり、完全なデスクトップアプリとして書き直されています。 REST APIをテストするためのクライアントアプリで、様々なHTTPリクエストを素早く組み立て、リクエストに対するレスポンスを詳細に確認することが可能です。ワークスペースを使用してリクエストを管理し、ドラッグ＆ドロップで整理したり、データをインポート・エクスポートする機能も搭載されています。 APIキーのようなリクエスト
CRUDの操作をRESTで表現すると一対一で対応していないことに気づきます。RはGET、DはDELETEと考えておいて良さそうですが、CとUはPUT、POST、PATCHの3つの選択肢があり、APIを設計していると迷います。整理するためにまとめておきたいと思います。 下記の資料を参考にしました。 http - PUT vs POST in REST - Stack Overflow When to use PUT or POST | - The RESTful cookbook GitHub API v3 基本的な考え方 PUT: リソースの作成、リソースの置換 POST: リソースの作成 PATCH: リソースの部分置換 PUT PUTはPOSTと違い、リソース名を指定して作成または更新をかけるメソッドです。PUT /articles/3421は新規作成かもしれませんし、更新かもしれませ
一昨年からだいたい月1回ぐらいのペースで、Webの基本的な仕組みを基礎から学ぶ「RESTful#とは勉強会」を開催しています。主催はshokolaさんで、私は進行役を担当しています。 2月23日に開催したRESTful#とは勉強会13では、ヴァル研究所さんの協力のもと、駅すぱあとWebサービスをレビューするという企画をやりました。いろんな意見が出てとてもおもしろかったです。みなさんありがとうございました。 RESTful#とは勉強会13 当日の内容とポイント RESTful#とは勉強会13 ツイートまとめ ゲストとして来ていただいた@Keisuke69さんがブログ記事を書いておられたので、これは私も書かなければ、ということで感じたことを書いていきます。 keisuke69.hatenablog.jp 駅すぱあとWebサービスについて、当日思っていて言い忘れたこと トークンをURLのクエリパ
Swagger places API specifications such as OpenAPI, AsyncAPI, and JSON Schema at the core of its architecture, which are crucial for guiding teams through the entire lifecycle of API design and documentation. This strategic focus ensures that our suite, including open source tools and SwaggerHub, delivers unparalleled efficiency and a seamless user experience. Explore the API Specifications Discove
RESTful APIの記述標準化を目指す「Open API Initiative」をマイクロソフト、Google、IBMらが立ち上げ。Swaggerをベースに 10年以上前、XMLの登場に続いてXMLベースのAPIを記述する標準フォーマット「WSDL」が提唱されました。 WSDLにはAPIの仕様がマシンリーダブルな形で記述されており、APIを呼び出すためのプロトコルやデータフォーマットをあらかじめ知ることができます。WSDLを利用することで、APIをコールするためのコードを自動生成することが可能でした。 しかしXMLベースのAPIは期待されたほど普及せず、現在ではよりシンプルなRESTful APIが事実上の標準となっています。 そしてRESTful APIのためのWSDLとも言うべき、RESTful APIのインターフェイスを記述するための標準フォーマットを推進する団体「Open AP
『るびま』は、Ruby に関する技術記事はもちろんのこと、Rubyist へのインタビューやエッセイ、その他をお届けするウェブ雑誌です。 Rubyist Magazine について 『Rubyist Magazine』、略して『るびま』は、Rubyist の Rubyist による、Rubyist とそうでない人のためのウェブ雑誌です。 最新号 Rubyist Magazine 0064 号 バックナンバー Rubyist Magazine 0064 号 Rubyist Magazine 0063 号 Rubyist Magazine 0062 号 Kaigi on Rails 特集号 RubyKaigi Takeout 2020 特集号 Rubyist Magazine 0061 号 Rubyist Magazine 0060 号 RubyKaigi 2019 直前特集号 Rubyist
ApiDoccoはRESTfulなWeb APIのドキュメントを作成できるWebサービスです。 Web APIを使ってWebサービスを作る、またはWebサービスを作ったらWeb APIを提供するというのは当たり前になってきました。その際に必要になるのがドキュメントです。一から作るのは大変ですが、ApiDoccoを使えばある程度手軽に作れるようになりそうです。 トップページです。APIは独自で追加もできます。 APIDoccoのAPIを見ています。RESTfulなメソッドが並んでいます。 GETアクセスの一覧系です。必須パラメータやそのレスポンスが確認できます。 POSTアクセスでも同じように表示されています。 切り替えはスムーズで内容も見やすいです。 ApiDoccoは左側にメソッドの一覧、右側に実行の際のパラメータとレスポンスを記します。その場で実行が出来る訳ではないようですが（将来的に
HTTPでアクセスして、JSONを返すようなWebサーバを書きたいとする。 どんな言語を選ぶか。どんなミドルウェアを選ぶか。どんなライブラリを選ぶか。 たとえば、TIOBE Softwareが公表している「Programming Community Index(PCI)」という指標がある。人気のあるプログラミング言語の数値化。これを見ていて思ったのは、「多すぎだよね、プログラミング言語」ということ。これらのうち、どの言語を勉強し、どの言語をプロジェクトに採用すべきなのか。 その感触を得るために、 「同じ仕様のREST serviceを複数言語で実装したらいいんじゃね？」 と思った。いくつかの言語で実装を起こしてみている。 前提条件 大規模な開発を想定する。ユーザの規模が大規模。トランザクション数が大規模。そして、開発者が大規模。 実用的かつモダンな開発を想定する。プロジェクト毎のバージョン
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
