GitHub - OAI/OpenAPI-Specification: The OpenAPI Specification Repository
The OpenAPI Specification is a community-driven open specification within the OpenAPI Initiative, a Linux Foundation Collaborative Project. The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs. This allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, addit
HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様
今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Problem Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application
VISAがオンライン決済用RESTful APIを一般公開！ - 熟れたC++使いが社会問題と趣味をつぶやく
www.programmableweb.com しばらくオンライン決済系の動向を見ていなかったので、このニュースを見た時には結構驚きました。 これまではPayPalや他のサービスがオンライン決済APIの代名詞のようなものだったのですが、とうとうVISAのようなメジャーが直接公開する運びとなったのですねぇ・・・。 昔はオンライン決済を一般人がやろうと思うと結構ハードルが高いもので、銀行等の金融機関だけのもの、という感じでした。それがPayPal等の登場によりかなり簡単に扱える様になりました。しかしPayPalの問題は、決済を行いたいお客さんが一度PayPalに個人情報やカード情報を入力しなければならないという点でした。つまり、PayPalアカウントを一度作るというちょっとした障壁が残っていたのです。VISA APIによりおそらくこの障壁がなくなると思われるので、この点は大きいのではないでしょ
RESTful APIの記述標準化を目指す「Open API Initiative」をマイクロソフト、Google、IBMらが立ち上げ。Swaggerをベースに
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
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
