WebAPIでエラーをどう表現すべき？15のサービスを調査してみた - Qiita
2017-01-05 追記 2016年3月にエラーの標準形式RFC7807「Problem Details for HTTP APIs」が提案され、今日現在proposed standard(標準化への提唱)となっています。こちらも是非ご覧ください。 RFC 7807 - Problem Details for HTTP APIs HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様 最近はREST APIを提供しているサービスが増えてきていますね！また公開されるAPIだけでなく、Microservicesなアーキテクチャを採用して、バックエンドがWeb APIで通信するケースも増えてきているように思います。 APIを使うときはあまり気にしたこともなかったですが、いざAPIを設計してみるとどんなインターフェイスがいいのか、どんな形式がいいのかといった疑問が次々と出てきます。
RESTのベストプラクティス | POSTD
現在ではREST APIはとても一般的な話題です。ほとんどすべてのWebアプリケーションの一部分となっています。シンプルで一貫性があり実際的なインターフェースは必須です。これは皆さんのAPIを他の人が使うことをとても容易にします。皆さんにとってはRESTの実践が日常的に感じられるかもしれませんが、RESTをあまり尊重しない人々もよく見かけます。これがRESTについて投稿するきっかけでした。 この記事にはRESTfulなAPIを設計する時に考慮すべきベストプラクティスがあります。 注意 : ここでのベストプラクティスは、私が過去の経験に基づいて良いと考える事例です。もし違う考えをお持ちであれば、お気軽にメールをくだされば意見交換できると思います。 APIのバージョンを示す APIのバージョンは必須であるべきです。これがあると時間が経ってAPIが変わっても影響を受けません。その方法の1つはUR
「api.rakuten.co.jp」で提供しているAPIの廃止について - 楽天ウェブサービスブログ
日ごろ楽天ウェブサービスをご利用いただきありがとうございます。 「api.rakuten.co.jp」で提供している古いAPIにつきましては、 2014年8月末から、段階的に廃止することを予定しております。 皆様には大変お手数をおかけいたしますが、 「app.rakuten.co.jp」で提供している新バージョンAPIへの利用切り替えをお願いいたします。 今後は新バージョンのAPIにのみ機能追加、新ツールの提供を行う予定です。 ※現在、用意されてないAPIについては順次リリースを行ってまいります。 以下、廃止対象のバージョンを含むAPIのリストです。 ■楽天市場系API 楽天商品検索API Version（2010-09-15）Version（2010-08-05）Version（2010-06-30）Version（2009-04-15）Version（2009-02-03）Versio
APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight
ちょっと前にTwitterでAPIのバージョニングをどうやるかみたいな話をしていたのですが、そのへんもやもやしているので少し整理しておきたいなと。 APIのURLを/api/v1/*とかってやるの、やめたほうがいいとおもうんだけどなぁ。いざv2を作るとなったときに、大量のコピペが発生して後悔するよ、って伝えたい。— Kenn Ejima (@kenn) February 28, 2014 さて、これについて色々と異論・反論も含めた意見が出たのですが、まずは、大昔にURL方式（＝コントローラ分割）でやってきて後悔したぼくが、（5年ぐらい前から）現在はどうやってAPIのバージョンを管理しているか？について紹介します。 基本原理としては、コピペが多発する根っこで分岐（＝コントローラ分割）じゃなくて、必要最小限のところで限局的に分岐するのがいい、という考え方に基づきます。 一言でいうと、「パラメー
【19日目】WebAPIにアクセスして取得できるJSON処理についての3つのTIPS - 40歳からのキャリアチェンジ
この記事はあすとろなんとか@astronaughts さん主催のTitanium Mobile Advent Calendar 2012 向けに書いています。 TitaniumAdvent Calendarもう全部埋まったと思い込んでいたら明日と明後日が空いてるのにちょっとビックリ。「WebAPIにアクセスして取得できるJSON処理についての3つのTIPS」というネタ書こうと思っていたけどTIPが２個しかないからなぁ。。— hiroshi oyamada (@h5y1m141) December 18, 2012 というのが背景にあって、書いてみました。 本題 Twitterに代表されるように最近のWebサービスではそのサービスのリソースにアクセスできるようにAPIが提供されており、WebAPIを活用したiPhoneアプリ開発をすることが比較的多くあるかと思います。 WebAPIを通じて取
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
