翻訳: WebAPI 設計のベストプラクティス - Qiita
これは Enchant の開発者である Vinay Sahni さんが書いた記事「Best Practices for Designing a Pragmatic RESTful API」1を、ご本人の許可を得て翻訳したものです。 RESTful な WebAPI を設計しようとすると、細かなところで長考したり議論したりすると思います。また、他の API に倣ってやってはみたものの、本当にそれでいいのか、どうしてそうしているのか分からない、何てことも少なくはないと思います。 この記事では、そのようなハマリどころについて Vinay さんなりの答えを提示し、簡潔かつ明快に解説してくれています。 今後 WebAPI を設計される方は、是非参考にしてみてください。 なお、誤訳がありましたら編集リクエストを頂けると幸いです。 まえがき アプリケーションの開発が進むにつれて、その WebAPI を公
WebAPIリクエスト仕様書としてcurlコマンドのご提案 - Qiita
WebAPIの仕様を記述する方法はいくつかあると思う。 普通に日本語で記述する JSON Hyper-Schema、WADL、RAML、Swaggerなどを使う 仕様書の代わりにプログラムを書く HTTPメッセージそのものを記述しておく でも、文法にばらつきがあったり、読みにくかったり、ツールのセットアップが面倒だったり、どれもイマイチな所があって、手軽な方法が欲しいと思っていた。 何気なくcurlコマンドのオプションを調べていたら、「もうこれでAPIドキュメント扱いにしちゃえばいいんじゃね？」と思えてきたのでメモしておく。 curlコマンドのおさらい curlコマンドはlibcurlの付属コマンドで、最近のUnix系OSなら大抵最初から入っていると思う。コマンドの詳細はmanを読んでいただければ。 cURL - How To Use （マニュアルページ日本語訳） curlコマンドのオプシ
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など使う人が限定され
WebAPIの拡充によりIoT市場の成長を促す - インテルの組込市場に向けた挑戦
Intelの日本法人であるインテルは6月9日、同社のWebAPIへの取り組みについての説明会を行い、日本におけるWebAPIビジネスに向けた方向性などを示した。 モバイル機器の増加とクラウドサービスの増加に伴い、そうしたサービスの元となるAPIを活用するユーザーが増加している。中でもWebAPIは年々増加を続けており、APIを提供する企業側としても、単なるソフトウェアプラットフォームの1形態を技術的に示す、という意味合いではなく、それが実際にビジネスの成功に直結するようになってきた。 そうした背景から、Intelもこの数年で複数のWebAPIベンダや関連企業の買収を進めてきた。例えば2013年には「MASHERY」や「Aepona」、MASHERYのAPIを活用してハッカソンなどを行っている「Hacker League」などを買収。これにより、現状、従来から提供している「Intel Exp
JSONP WebAPIを爆速で使いこなせるフレームワーク
ヤフー株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。LINEヤフー Tech Blog Yahoo!デベロッパーネットワークの中野(@Hiraku)と申します。 「WebAPIの魅力を存分に宣伝せよ」という使命を受けまして、これから何度かTechblogを書くことになります。以後、お見知りおきを。 さて、Yahoo! JAPANが公開しているWeb APIはたくさんありますが、JSONPに対応しているものがいくつかあります。ショッピング、オークション、YOLP、震災関連情報などです。 JSONPについて詳しくは過去記事を見てください。 他の形式に比べると、サーバーを準備しなくてもブラウザーだけで動かすことができ、古いブラウザーでも動くという、JSONPにしかないメリットがあります。夢のような形式！なのです。 …そのは
今どきのWebディレクターなら避けては通れないAPIの勘どころ : LINE Corporation ディレクターブログ
こんにちは。ライブドアのモリウチです。突然ですがWebディレクターのみなさん、「WebAPI」を使った企画や設計をしていますか？ APIとは「Application Programming Interface」の略で、特にWebAPIとはあるプログラムが、別のシステム (Webサービス) が持っているデータのCRUD (読み書き削除) や、一連の処理 (機能) の利用を可能にするための技術です。 WebAPIの活用の普及に貢献したのは2005年のGoogleMapのAPIでしょう。 WebAPIは、登場当初は地図情報や、都道府県やジャンルなどの静的な情報を取り出して利用することが主流でしたが、最近ではTwitterやFacebookのように利用ユーザーからの許可を受けてユーザーの個人データやソーシャルグラフを取り出して利用したり更新したりできるようなWebAPIが一般化してきました。そして
Facebook APIのつかいかた (OAuth 2.0) - Censorable log
FacebookのAPI、以外と日本にまとまった文献が少ない。 日本語版が少ないのと、コロコロ仕樣が変わっているせいだ。 「Facebook Connect API」なんかで検索しても、ぜんぜんいいページに辿りつかないので書く。 Twitterにくらべて、FacebookのOauth2.0 APIは、すごく簡単にできている。 Twitterもそうだが、「認証して見れるデータ」と「認証しなくても見れるデータ」の２種類がある。 認証しなくても見れるデータのほうが、セキュリティも低いし、入力もプログラムもカンタン。 ■認証しない系 たとえば、ぼくの基本情報は、 https://graph.facebook.com/hiroki.nakamura https://graph.facebook.com/●●●● こんだけ。 これで、基本情報がJSON形式で、充分とれる。 さらに、 https://g
はてブ Web HookとGAEで「[これはすごい] in リアルタイム」を作った - 医者を志す妻を応援する夫の日記
はてなブックマーク上でのイベントを他のWebアプリにHTTPで通知する、はてなブックマーク Web Hook。遅ればせながら、使ってみました。 (開発者さま向け) はてなブックマーク Web Hook 機能を公開しました - はてなブックマーク日記 - 機能変更、お知らせなど はてなブックマーク Web Hookとは - はてなキーワード naoyaの日記 - naoyaグループ あらかじめ、自作Webアプリ（CGIとか）のURLを登録しておきます。で、はてブしたときに、そのURLに情報をPOSTしてくれるわけですね。 すぐに思いつくのが、Twitterへの投稿。 はてブの Web Hook で Twitter を更新する - IT戦記 さすが、id:amachang。仕事がはやい。 私は、趣向を変えて、こんなのを作ってみました。 Error 404 (Page not found)!!1
日本語解析エンジン「なずき」 | NTTデータ
なずき感性抽出APIは、ブログ記事など日本語で書かれたテキスト情報に含まれる感性を抽出するAPIです。本APIを利用することによって、指定されたテキスト情報内から、「好評」や「苦情」、「要望」といった感性情報を、その表現とともに抽出することが出来ます。また、同時にテキスト情報を形態素に分割し、品詞、読みかなといった情報を取得できる形態素解析や、形態素に分割された単語の係り受け関係情報を取得できる構文解析の機能も提供します。 この度は、多数ご応募いただき、誠に有難うございました。( 応募作品一覧はこちらでご確認頂けます。) なずき感性抽出APIを利用された作品から、最優秀賞を受賞された「SocialCombat V」をはじめ、「UNIQLO NOW」、「Tmeeting(仮)」など、多数受賞作品が選ばれました。その中から、なずきの特長を一番表現出来ているという理由から、NTTDATA賞として
Javaでmixiのエコーにポスト | 第四工廠
■mixiにログイン Twitterとmixiのエコーの両方にポストできるようなのが欲しくなったので挑戦。 エコーはTwitterみたくAPIを公開してないので無理やりがんばって解析しなきゃなりません。 まずはログイン。 Twitterみたいに適当にBASIC認証で入ろうとするも、あえなく失敗。 ログインページのソース（フォーム部分）を見ると、 /login.pl というURLに、 next_url、email、password、stickyという4つのパラメータを送っているっぽい。 メソッドはPOST。 とりあえず送ってみて、戻ってくるデータを読む。 URL url = new URL("http://mixi.jp/login.pl");HttpURLConnection conn = (HttpURLConnection) url.openConnection();conn.setR
テキスト解析:キーフレーズ抽出API - Yahoo!デベロッパーネットワーク
指定されたURLは存在しません。 URLが正しく入力されていないか、このページが削除された可能性があります。
CA1677 – 図書館によるAPIの公開－PORTAの事例から－ / 中嶋晋平
図書館によるAPIの公開－PORTAの事例から－ はじめに 最近、GoogleやAmazonをはじめ、多くのウェブサービスがAPI（Application Programming Interface）を公開している。図書館界においても、OCLCが検索用API(1)や、メタデータ間のクロスウォーク（CA1552参照）を行うことのできるAPI(2)を公開するなど、その動きが少しずつ広まっている。 一方で、APIがどのようなものであり、何が便利なのかについては、日本の図書館界ではまだあまり知られていないのではないかと思われる。 そこで、本稿ではAPI、その中でも特にWeb APIについて簡単に紹介するとともに、国立国会図書館デジタルアーカイブポータル（PORTA）の外部提供インタフェースについて述べ、Web APIの公開の意義について考察する。 Web APIとは そもそもAPIとは、あるプ
【YQL 速攻レビュー】米 Yahoo! が SQL っぽく色んなデータを取ってこれるAPIを出した - てっく煮ブログ
米 Yahoo! が Yahoo! Pipes みたいに自由度が高くて、またちょっと毛色が違うサービスが出てきた。題して、Yahoo! Query Language。YQL と呼ぶようだ。SQL 風の言語を REST で投げて、結果を XML や JSON で受け取ることができる。具体的にやってみないと分かりにくいので、とりあえず試してみた。RSS からデータ取得YQL を使って RSS から最新のタイトル10個を取ってきてみる。こんな YQL になるらしい。 select title from rss where url='http://d.hatena.ne.jp/nitoyon/rss' rss テーブルに対して select を発行している。実際にこの YQL を試すには YQL 用の console を利用するとよい。（※要ログイン）console の左上に YQL を入力して
YOLP(地図):ローカルサーチAPI - Yahoo!デベロッパーネットワーク
指定されたURLは存在しません。 URLが正しく入力されていないか、このページが削除された可能性があります。
グラフ作成やデータ可視化を楽に美しくできる便利なサービス22個まとめ | Web担当者Forum
このコーナーでは、ネットビジネスを強力に支援する製品について、それを支える技術や市場動向を説明し、さらに各社から提供されている製品を紹介する。競合商品がひしめく市場で、他社に差を付けるための武器として、ぜひ導入を検討してみてほしい。今回は、「グラフ作成・データ可視化」サービスだ。 売り上げの推移、業界におけるシェア、自社製品の出荷数内訳などなど…。「顧客の説得のため、ウェブサイトでもグラフ要素を掲載したい」といったケースは増えている。大手企業では、PHPを使いデータベースと連動させて動的に最新グラフを表示させる、といった仕組みを用意できる場合もあるが、たいていは「エクセルで作成したグラフを画像として貼り付け」といった、手作業感あふれるものだった。 だが、昨年末にGoogle Chart APIが登場して以降、さまざまなサービスや独自APIが増加し、選択肢がグッと増えてきた。無料で利用できる
Mextractr/Mextractr個人情報フィルタ（プライバシ・フィルタ）
Mextractr Webサービスでは、RapidSSLの SSLサーバ証明書を使用してお客様の個人情報を保護しています。 2008-08-26:Mextractr個人情報フィルタを発表しました。[報道発表資料] 先着100社様に、試供版ページを30日間無償でご利用いただくサービスを開始しています。 詳細は個人情報フィルタのページをご覧下さい。 Mextractrブランドのコア技術：メタデータ抽出エンジン Mextractrメタデータ抽出エンジンは、プレーンテキストからメタデータを抽出します。 *Mextractr WebAPI メタデータ抽出エンジンの機能の一部をMextractr WebAPIとして無償公開しています。 Mextractr WebAPIは、イベント（出来事）のメタデータ自動抽出APIです。 当WebAPIの詳細については、ドキュメントをご覧下さい。サンプルコ
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GData APIでGoogleスプレッドシートを参照するには
Google ビジネス プロフィール
Decommission of online tidy service