HTTP status codes used by world-famous APIs
statuses.md API Status Codes Twitter 200, 304, 400, 401, 403, 404, 406, 410, 420, 422, 429, 500, 502, 503, 504 Stripe 200, 400, 401, 402, 404, 429, 500, 502, 503, 504 Github 200, 400, 422, 301, 302, 304, 307, 401, 403 Pagerduty 200, 201, 204, 400, 401, 403, 404, 408, 500 NewRelic Plugins 200, 400, 403, 404, 405, 413, 500, 502, 503, 503 Etsy 200, 201, 400, 403, 404, 500, 503 Dropbox 200, 400, 401,
RailsでAPI開発する前に知っておくべき４つのこと - Qiita
$ bin/rails g scaffold user name:string mail:string password:string invoke active_record create db/migrate/20151214145437_create_users.rb create app/models/user.rb invoke test_unit create test/models/user_test.rb create test/fixtures/users.yml invoke api_resource_route route resources :users, except: [:new, :edit] invoke scaffold_controller create app/controllers/users_controller.rb invoke test_un
9isというサービスをリリースした - 画竜点睛を衝く@mapyo
https://9is.xyz [追記] URLが変わって、https://9is.partyになりました。 こんなサービスをリリースしました。 （１月９日に） さぁ、クイズをはじめよう！みんなでもっとおもしろくできる。 https://t.co/QARqL52v9Q #9isxyz— 9is_party (@9is_party) January 8, 2016 気がついたらもう１週間がたってしまっている。。。 きっかけ 会社のお産合宿というイベントが去年の９月にあったのですが、その時に作りました。 お産合宿自体は１泊２日なのですが、その時にゼロから作ったのではなくて、２〜３ヶ月前からゆるい感じで準備を始めて、当日に最後の追い込みをした感じです。 そして、お産合宿からかなり時間がたちましたが、多少の修正を加えた後、何かしら期限を決めてリリースしないといけないよね。という事でリリースしました
マーケティングツールの開発に使えるAPI | CINC Marketing Blog
最近ではWebマーケティング関連のAPIも充実しており、これらAPIを利用する事で手軽にWebマーケティングツールを構築出来るようになりました。 この様なWebマーケティング系APIを利用すれば、自社の専用管理ツールや代理店のレポート生成ツールとしても利用出来そうですね。 今回は、そんなマーケティング系APIを紹介したいと思います。 Ginzametrics API オンラインSEO管理ツール「Ginzametrics」のAPIサービスです。 主に検索エンジンの順位やソーシャルシグナル、ランディングページURLなどの情報をJSON形式で取得できます。 基本的にはGinzametrics内で閲覧できるデータをAPIで取得する形となっている為、全く新しいキーワードをリクエストするだけでは検索順位は取得出来ないようです。 現在、Ginzametricsを利用されており、他のデータと統合して閲覧す
SimilarWeb APIを使ってみた(後日参照用のメモ偏)
2. SimilarWeb • 大きく3通りくらい使い方はある。 (1) トップページで 調べたいサイト名を入力する (2) APIで、サイトのいろいろな情報を得る(有料) ← (3) SimilarWeb PROを使う(有料) • 本文書では、特に記載の無い限り、 (2)の場合の話とする。 (1) http://www.similarweb.com/ (2) http://developer.similarweb.com/ (3) http://www.similarweb.com/pro 4. 初めに(1/4) • クレジットカードなどでAPIを使う権利を購入した場合、有効期限は、月 末まで。購入してから1ヶ月ではない。 • API は少なくとも21個用意されている。 • similarweb.com でサイト名を入力して現れる情報は全て取れる。 • それらは、Traffic, Con
SimilarWeb APIを使った、競合分析に役立つ4つのスプレッドシートツール | SimilarWeb日本公式ブログ
SimilarWeb APIを使った、競合分析に役立つ4つのスプレッドシートツール 2014/12/3 API・他ツール連携 前回、SimilarWebの競合情報をグーグルスプレッドシートに出力できる便利なアドオン「SimilarWeb for Sheets」についてご紹介しました。 実は、アドオン以外にもAPIに紐づいたスプレッドシートツールをSimilarWebでは提供しています。そこで、今回はSimilarWebが提供している4つのスプレッドシートツールの、機能と使い方までを紹介します。 ※今回、紹介するスプレッドシートツールはSimilarWeb APIを使っているため、利用には以下からサインアップが必要になります。まだしていない方は以下からサインアップ後、ご利用ください。 SimilarWeb<dev> Sign Up 目次 Email Lead Qualification To
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を設計してみるとどんなインターフェイスがいいのか、どんな形式がいいのかといった疑問が次々と出てきます。
Web APIを作るときに考えること。 - パルカワ2
この記事はPepabo Advent Calendar 2014の11日目の記事です。 前日は、tnmtさんのVagrantのshell provisionerでApacheのビルド済tarボールをOSバージョン毎に作る術でした。 はじめに 今回は、Web APIを作るときに考えることをまとめました。 本当は、社内向けに資料を作っていて、社内の勉強会とかで話せればいいか〜って考えていたんですが、アドベントカレンダーのネタが本当になくて困っていたのでこれを使います。 対象者 APIを作る時、と書いてますが、クライアント側の人にとっても知っておく必要があることなので、サーバ側の人・クライアント側の人両方が対象者です。 APIを作るときに考えること 「APIを作るとき」と言っても、色んな状況があります。 まずはそれを絞ります。 APIの種類 プライベートAPI アプリのAPIなど使う人が限定され
APIのエラーハンドリングを見直そう - WebPay Engineering Blog
ここ数ヶ月にわたって、WebPayはAPIのエラーにまつわる変更を少しずつ行ってきました。 それに付随してドキュメントも拡張しましたが、変更の背景について十分に説明できていない部分がありました。 この記事では、最近のエラーに関連した変更の背景を紹介し、今後どのようにエラーをハンドルすべきか説明します。 記事の内容は執筆時点のものであり、今後同じようにエラーやAPIの変更を行うことがあります。 変更があっても記事の内容はその時点の内容を保持し、ウェブサイトのドキュメントのみ更新します。 必ずウェブサイトのドキュメントを合わせて参照し、手元で動作確認を行ってください。 エラーはなぜ起きるのか WebPayのAPIは、リクエストされた操作ができなかったときにエラーを返すように設計しています。 可能なかぎりエラーにならないような設計、実装を心がけていますが、エラーは絶対に避けられません。 例えば、
Web API: The Good Parts
Web APIの設計、開発、運用についての解説書。APIは設計次第で使いづらいものになってしまうだけでなく公開後の保守運用も難しくなってしまいます。そのためAPIを美しく設計することがとても重要です。本書では「設計の美しいAPIは、使いやすい、変更しやすい、頑強である、恥ずかしくない」という考えのもと、APIをどのように設計し運用すればより効果的なのか、ありがちな罠や落とし穴を避けるにはどういう点に気をつけなければいけないのかを明らかにします。ターゲットは、URIにアクセスするとXMLやJSONなどのデータが返ってくるシンプルなタイプ――XML over HTTP方式やJSON over HTTP方式――のAPIです。読者は、Web API設計の考え方と手法を知ることができます。 はじめに 1章 Web APIとは何か 1.1 Web APIの重要性 1.1.1 APIでの利用を前提とした
REST APIのドキュメントに書かれているもの - Qiita
もし急にAPIドキュメントを書く必要が発生したら、何を参考にしたら良いのか。REST APIを提供しているサービスがどういった開発者向けドキュメントを提供しているのかについて調べた。今回対象としたサービスは、GitHub、Twitter、Square、DigitalOceanの4つのサービス。 https://developer.github.com/v3/ https://dev.twitter.com/docs https://developers.digitalocean.com/ https://connect.squareup.com/docs/api なお以下の文章の中では、個々のアクセス可能なメソッドとURLの組み合わせを指して「API」という言葉を使うことがある。例えば、GET /gists/:id という特定の投稿を取得するAPIや GET /gists/:gist_id
APIドキュメントを書くのが楽になるツールまとめ - Qiita
さいきんREST APIのドキュメントを書いていて、wiki使うのだるいし他に良い方法ないかな〜と調べてた時に見つけたツール群をまとめてみます。 追記: こちらも便利そうなので参考にどうぞ。 REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita swagger Swagger: A simple, open standard for describing REST APIs with JSON | Reverb for Developers デモ: Swagger UI ソースコード中にAPIの概要を書いておくと、それを元にドキュメントを自動生成してくれる。wikiやmarkdownで書くのと決定的な違いは、↓のようにドキュメント上のformからAPIコールを試すことができる点。 様々な言語のWAFに対応したライブラリも開発されてる。 Home ·
グルーブテクノロジー株式会社 - Web サービス：郵便番号検索API
郵便番号検索API このAPIは、郵便事業株式会社様（旧日本郵政公社）が公開している郵便番号のデータを取得する機能を提供します。 郵便番号から住所、住所から郵便番号の取得が可能です。 お知らせ 【重要】郵便番号検索APIサービスの終了について リクエストの構築 リクエストは、「REST」を用いて行います。 URLの構築は、リクエストURLにリクエストパラメータを「引数=値」という形式で指定します。複数のリクエストパラメータを指定する場合は、「&」を用いてつなげます。 例： http://api.postalcode.jp/v1/zipsearch?zipcode=33200&callback=callback リクエストURL http://api.postalcode.jp/v1/zipsearch? リクエストパラメータ パラメータ値説明
日本の全エンジニアに捧ぐ！現在公開されているAPI一覧【2013年版】 | Find Job ! Startup
2013年のいま、API界隈が熱い！ 今年に入り、官公庁の統計データやNHKの番組情報など、今までなかなか利用できなかったデータがAPIとして扱えるようになってきました。このエントリでは現在公開されているAPIを一覧でまとめます。いま使えるAPIはこれだけ読めば大丈夫。2013年の最新マッシュアップ事情をあますとこなく網羅します！ HOT! API 総務省 次世代統計利用システム（国勢調査、人口推計、就業構造、企業統計、物価統計 etc.） NHK番組表（※未公開） 行政・自治体・公共サービス 郵便番号 郵便番号検索API（郵便番号 → 住所） 郵便専門ネット（郵便番号 → 住所、郵便番号の簡易存在チェック） ぽすたん（郵便番号 → 住所、住所 → 郵便番号） IW3 PROJECT（郵便番号 → 住所、住所 → 郵便番号） 宇宙 Google+ JAXA PR（※現在一部の学生に限定公開
Rails4に対応したgem doorkeeperついて調べてみた。 - Qiita
Ruby on Rails Advent Calendar 2日目遅れました(^o^) -- タイトルの通りですが、以前ブログに書いた事がある自社サービスの機能を簡単にAPIで提供出来てしまう！gem doorkeeperが凄い。 という記事を書いて1年以上経ちました。 doorkeeperも大分進化しており、Rails4対応もしている様なので再度検証してみることにしました。 下記作業ログになります。 検証環境 ruby 2.0.0p353 Rails 4.0.1 Gemfileにdoorkeer追加 Gemfileにdoorkeeperを追加します。 GET /oauth/authorize/:code(.:format) doorkeeper/authorizations#show oauth_authorization GET /oauth/authorize(.:format) d
自社サービスの機能を簡単にAPIで提供出来てしまう！gem doorkeeperが凄い。 - @camelmasaの開発日記
自社サービスにAPIを実装する事ってあまりないですよね。 kamadoのプロダクトも現在はAPIは公開してません。 もし提供するのであれば、簡易的な方法ですが、ユーザーテーブルにtokenカラムを追加して、API用のルーティングを作成する…という方法が考えられると思います。 しかし、その実装時間でより良いAPIが実装出来るとしたら素晴らしいですよね。 そこで紹介したいのがgem doorkeeperです。 日本語の記事が見当たらなかったので記事にしました。 github https://github.com/applicake/doorkeeper gem doorkeeperってどんな機能があるのか？ 簡単に説明すると、 ・アプリケーションの管理機能 ・アプリケーションの承認管理 ・スコープの設定 いってしまえば、Facebook API(に近い実装)そのまま実装出来ます。 しかもOAu
NetflixのAPI最適化
先月1ヶ月間に渡って、Netflixは同社が1年以上前に始めたAPI最適化に関する話を発表した。当初は通信を少なくしペイロードのサイズを小さくすることで性能の最適化しようとしていた[1]が、1年にわたる再設計の結果、APIの開発と運用を分散化しサービス層は非同期になった。再設計の第一の特徴はクライアントとサーバの責任の境界[2]を再定義したことだ。こうすることでコンテンツのフォーマッティングなどきめ細かいカスタマイズが可能になり、Netflixに接続する多様なクライアントデバイス間の差異(メモリ、キャパシティ、ドキュメント配信、モデル、ユーザインターフェース)に対処できる。 InfoQはNetflixのシニアソフトウエアエンジニアであるBen Christensen氏に設計の詳細について話を聞いた。 InfoQ: 1年前、性能最適化を始めたころのNetflix APIのアーキテクチャを教え
APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight
ちょっと前にTwitterでAPIのバージョニングをどうやるかみたいな話をしていたのですが、そのへんもやもやしているので少し整理しておきたいなと。 APIのURLを/api/v1/*とかってやるの、やめたほうがいいとおもうんだけどなぁ。いざv2を作るとなったときに、大量のコピペが発生して後悔するよ、って伝えたい。— Kenn Ejima (@kenn) February 28, 2014 さて、これについて色々と異論・反論も含めた意見が出たのですが、まずは、大昔にURL方式（＝コントローラ分割）でやってきて後悔したぼくが、（5年ぐらい前から）現在はどうやってAPIのバージョンを管理しているか？について紹介します。 基本原理としては、コピペが多発する根っこで分岐（＝コントローラ分割）じゃなくて、必要最小限のところで限局的に分岐するのがいい、という考え方に基づきます。 一言でいうと、「パラメー
例えば OSFA な API をやめる - @kyanny's blog
OSFA == one-size-fits-all 単一の API で全てをカバーするのをやめたらどうか、ということ。 APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight @kenn 最近はRESTfulなエンドポイントは完全に後方互換なまま、クライアントごとにオーケストレーション層(radical versionin)を設けるという方向にシフトしようとしている。詳しくは http://t.co/zODm7mFr5B— Tatsuhiko Miyagawa (@miyagawa) February 28, 2014 この話のポイントとはちょっとずれてる && Podcast 聴いてないのですが。 Quipper プラットフォームで内部的に利用されている API も、 /v1 というパスの下にはえててごく一部のエンドポイントだけ /v2 がある、み
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Apiary | Platform for API Design, Development & Documentation
