[B! API] n314のブックマーク

HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様

今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための︵レスポンスボディに載せられる︶標準的な形式が、RFC7807 Probl em Details for HTTP APIsで定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application

n314 2017/01/05

HTTP
API

リンク

LINE DEVELOPER DAY 2016 開催のお知らせ « LINE Engineers' Blog

LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog saegusa2017-04-16Yoshihiro was a network engineer at LINE, responsible for all levels of LINE's infrastructure. Since being named Infra Platform Department manager, he is finding ways to apply LINE's techno logy and business goals to the platform. こんにちは。LINEでネットワークやデータセンターを担当している三枝です。2017年1月にJANOG39で登壇する機会を頂きましたので、今回

n314 2016/10/13

API
LINE

リンク

HTTP API の設計方向

Twitter の TL に Dropbox が API v2 で REST をやめたという内容がかかれている記事が流れてきた。

n314 2016/10/07

RESTって非正規化禁止のDBみたいな感じがする。

API

リンク

持続的なプラットフォームのための難しい決断

先日フォーラムでお知らせいたしましたが、今まで提供してきたツイートボタンとフォローボタンのデザインを一新すると同時に、今後はツイートボタンにツイート数を表示しなくなります。変更は2015年11月20日までに完了する予定です。Twitterでは、開発上のトレードオフが生じることが度々あります。今回の変更もそのような事情によるもので、ここではその背景を説明いたします。 Twitterの目標の一つは、皆様のウェブサイト、アプリケーション、ビジネスにとって、信頼のおけるプラットフォームを作ることです。また、このプラットフォームがTwitter エンジニアリングチームに確実にサポートされていることも重要です。その結果、APIを廃止することによって生じる問題を抑えるために、永続的なデザインを選択することにしました。多くの皆様と同様にTwitterの開発リソースにも限りがあり、どのプロダクトやパブリックA

n314 2015/10/07

リンク

APIのエラーハンドリングを見直そう - WebPay Engineering Blog

ここ数ヶ月にわたって、WebPayはAPIのエラーにまつわる変更を少しずつ行ってきました。それに付随してドキュメントも拡張しましたが、変更の背景について十分に説明できていない部分がありました。この記事では、最近のエラーに関連した変更の背景を紹介し、今後どのようにエラーをハンドルすべきか説明します。記事の内容は執筆時点のものであり、今後同じようにエラーやAPIの変更を行うことがあります。変更があっても記事の内容はその時点の内容を保持し、ウェブサイトのドキュメントのみ更新します。必ずウェブサイトのドキュメントを合わせて参照し、手元で動作確認を行ってください。エラーはなぜ起きるのか WebPayのAPIは、リクエストされた操作ができなかったときにエラーを返すように設計しています。可能なかぎりエラーにならないような設計、実装を心がけていますが、エラーは絶対に避けられません。例えば、

n314 2014/12/14

決済
API

リンク

APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight

ちょっと前にTwitterでAPIのバージョニングをどうやるかみたいな話をしていたのですが、そのへんもやもやしているので少し整理しておきたいなと。 APIのURLを/api/v1/*とかってやるの、やめたほうがいいとおもうんだけどなぁ。いざv2を作るとなったときに、大量のコピペが発生して後悔するよ、って伝えたい。— Kenn Ejima (@kenn) February 28, 2014 さて、これについて色々と異論・反論も含めた意見が出たのですが、まずは、大昔にURL方式︵＝コントローラ分割︶でやってきて後悔したぼくが、︵5年ぐらい前から︶現在はどうやってAPIのバージョンを管理しているか？について紹介します。基本原理としては、コピペが多発する根っこで分岐︵＝コントローラ分割︶じゃなくて、必要最小限のところで限局的に分岐するのがいい、という考え方に基づきます。一言でいうと、﹁パラメー

n314 2014/03/06

API
設計

リンク

日本の全エンジニアに捧ぐ！現在公開されているAPI一覧【2013年版】 | Find Job ! Startup

2013年のいま、API界隈が熱い！今年に入り、官公庁の統計データやNHKの番組情報など、今までなかなか利用できなかったデータがAPIとして扱えるようになってきました。このエントリでは現在公開されているAPIを一覧でまとめます。いま使えるAPIはこれだけ読めば大丈夫。2013年の最新マッシュアップ事情をあますとこなく網羅します！ HOT! API 総務省次世代統計利用システム︵国勢調査、人口推計、就業構造、企業統計、物価統計 etc.︶ NHK番組表︵※未公開︶行政・自治体・公共サービス郵便番号郵便番号検索API︵郵便番号 → 住所︶郵便専門ネット︵郵便番号 → 住所、郵便番号の簡易存在チェック︶ぽすたん︵郵便番号 → 住所、住所 → 郵便番号︶ IW3 PROJECT︵郵便番号 → 住所、住所 → 郵便番号︶宇宙 Google+ JAXA PR︵※現在一部の学生に限定公開

n314 2013/07/10

API

リンク

はてなブックマーク

タグ

関連タグで絞り込む (6)

APIに関するn314のブックマーク (7)

お知らせ

今週のはてなブックマーク数ランキング（2024年6月第3週）

今週のはてなブックマーク数ランキング（2024年6月第2週）

月間はてなブックマーク数ランキング（2024年5月）

公式Twitter

キーボードショートカット一覧

はてなブックマーク

公式Twitter

はてなのサービス