HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様
今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Problem Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application
Test-Driven Approaches to Documenting RESTful APIs
As presented at Twin Cities Code Camp on April 16, 2016 --------------------- Documentation generated from source code is very popular. Solutions such…
Requirements for Writing Java API Specifications
Requirements for Writing Java API Specifications 1 This document describes the requirements for writing API specifications for the Java platform. The specification for each Java TM platform API library is made up of its Javadoc comments and additional support documentation called out in the doc comments. This document has five sections that correspond to the sections of an API specification; each
Apache commonsが便利な件（commons-configuration編） - 都元ダイスケ IT-PRESS
久々のシリーズ。 今回はcommons-configuration。設定ファイル、ってありますよね。Javaだとproperties、Windosだとiniファイルが使われる事が多い。複雑なものだとXMLで書いたりする。 さて、そんなファイルの読み込み・書き出しってどうしますか。まさかFileInputStreamで自前で読み出すとか、しないですよね。コメント行の処理等、やらなきゃいけないことは結構あります。まぁ、propファイルだったらPropertiesクラスで読み書きできますが、それでも、そうそう便利には出来ていません。 XMLファイルだったりすると、DOM組んで読み書きしますかね。これも結構大仕事。 という時に使うのがcommons-configurationのようです。まぁ、能書きよりコードですかね。 propertiesファイルの場合 foo = hoge foo.bar =
ヤフー、ひらがな文章を漢字に変換するWeb API「かな漢字変換Webサービス」公開：CodeZine
ヤフーは27日、かなやローマ字の混じった文章を文節ごとに区切り、漢字変換候補を提示するWeb API「かな漢字変換Webサービス」を公開した。1日あたり5万アクセスまでなら無償で使用できる。利用にあたってはアプリケーションIDの登録が必要になる。 このWebサービスは、REST形式で変換したい文章を送ると、各文節ごとの変換候補をXML形式で返すというもの。変換はVJE（VACS Japanese Entry）と同じ方式で行われている。 Yahoo!デベロッパーネットワークでは、サンプルURLとして「きょうはよいてんきです。」という文章が提示されている。このサンプルURLを送信すると「きょうは」「よい」「てんきです。」の3つに文節が区切られ、それぞれ漢字変換候補が示される。 http://jlp.yahooapis.jp/JIMService/V1/conversion?appid=Y
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
https://jp.techcrunch.com/2011/07/27/20110726twilio-client-lets-developers-integrate-voip-calling-into-any-application/
