apiに関するbaca-aho-dojiのブックマーク (9)
-
-
Web APIを使って開発を行っていると必要になるのがWeb API用のクライアントアプリになるでしょう。Web APIを細かな条件をつけて実行し、その結果を確認したり、JSONなどをフィルタリングできるのがポイントです。開発効率を向上させるのに必須の存在です。 そんなWeb API、今回はREST APIのクライアントソフトウェアがInsomniaになります。クラスプラットフォームで動くのがポイントです。 Insomniaの使い方 メイン画面です。 ヘッダー情報を確認できます。 Cookie。 タイムラインはより細かく確認できます。 OAuth2にも対応しています。 データフォーマットとしてはXML/JSON、フォームデータを送信できます。 InsomniaはElectronで作られているのでマルチプラットフォームで動作します。より直感的なインタフェースを目指しているとのことで、使いこな
-
﹁翻訳: WebAPI 設計のベストプラクティス﹂を読んで色々と思うところがあったので書きました。 上記の記事は訳文でありますので、正しくは﹁Best Practices for Designing a Pragmatic RESTful API﹂に対する所感と述べた方が良いのかもしれませんが、日本語で通して読めるようQiitaに投稿された訳文に対する所感として書いています。 以下では﹁翻訳: WebAPI 設計のベストプラクティス﹂並びに﹁Best Practices for Designing a Pragmatic RESTful API﹂は﹁当該記事﹂と表現します。 観点 当該記事では﹁○○とした方がよい﹂との意見に対してそうすべき理由が明らかになっていないか、もしくは表現が曖昧な場合が目立っていると感じました。設計は実装のようにプログラム言語仕様が制約を与えられないため、意図
-
これは Enchant の開発者である Vinay Sahni さんが書いた記事﹁Best Practices for Designing a Pragmatic RESTful API﹂1を、ご本人の許可を得て翻訳したものです。 RESTful な WebAPI を設計しようとすると、細かなところで長考したり議論したりすると思います。また、他の API に倣ってやってはみたものの、本当にそれでいいのか、どうしてそうしているのか分からない、何てことも少なくはないと思います。 この記事では、そのようなハマリどころについて Vinay さんなりの答えを提示し、簡潔かつ明快に解説してくれています。 今後 WebAPI を設計される方は、是非参考にしてみてください。 なお、誤訳がありましたら編集リクエストを頂けると幸いです。 まえがき アプリケーションの開発が進むにつれて、その WebAPI を公
-
API設計を学ぶべき背景と前提知識、外部APIと内部API、エンドポイント、レスポンスデータの設計やHTTPリクエストを送る際のポイントについて解説する。おまけでAPIドキュメント作成ツール4選も。 ︻0分︼API設計を学ぶべき背景 APIの公開が増えている 最近、自社で保有するデータや、システム、アプリケーション、Webサービスの機能を﹁API︵Application ProgrammingInterface︶﹂として公開する企業が、増えてきています。これに伴い、﹁API経済圏︵APIエコノミー︶﹂という新たなビジネスモデルが確立されつつあります︵参考‥5分で絶対に分かるAPIマネジメント、API経済圏︶。 ﹁ProgrammableWeb﹂というAPIに関するニュースサイトや、さまざまな企業が提供するAPIのリンクがまとまったサイトもあり、APIの普及はものすごいスピードで進んでいる
-
お詫び(2015.6.29 12:38追記) はてなアカウントでのログインの際にwrite権限を要求していましたが、ご指摘の通りこの仕組では全く必要ないものなので削除しました。申し訳ありませんでした。 また、自分が表示されてしまう不具合があるようなのですが、原因が分かり次第修正いたします。 動機 はてブでブクマしたりコメントしてると、﹁この人自分がブクマする時よく見るな……﹂っていう人いますよね? それはダジャレの人とかカッコいいメガネの人のように目立つ人だけじゃなく、有名ブックマカーではなくても似たような嗜好の人はいるわけです。 ところで、はてブにはよく使われているとはあまり言えない﹁お気に入り﹂機能があるわけで、逆にそういった人達をお気に入りに登録していけば﹁人気エントリ﹂や﹁新着エントリ﹂よりも更に自分向けの情報が流れてくるのではないか?という思いから、このwebアプリを作ってみまし
-
こんにちは丸山@h13i32maruです。 昨日、ESDocというツールをリリースしました。GW中になんとかリリースできて一息ついているところです。今回はそのESDocというツールについて紹介します。あと最後に雑談と宣伝があります。 ESDocとは? ESDocとはJavaScript(ES6)向けのAPIドキュメントツールです。JavaScript界隈ではJSDocがデファクトスタンダードであり、ESDocもJSDocに触発されて作りました。なのでタグの使い方はなるべく互換性を持たせています。とはいえ不要だなと思うタグもかなりあったのでそれらは実装していません。 ESDocの特徴(主にJSDocに比べて)としてはこんな感じです。 詳細なドキュメントを生成する ドキュメントカバレッジを計測する テストコードとドキュメントを関連付ける ES6のclass, import/exportを使った
-
はじめに この記事は、 JavaScript/ES6 promisesについてを理解するために読んだ方がよいと思われる記事やスライド等を紹介しています。 PromisesやDeferredといった言葉を非同期処理の話などで聞いた事があるかもしれませんが、 現在Promisesは次のECMAScriptの言語仕様として策定が進められています。 ECMAScript Language Specification ECMA-262 6th Edition – DRAFT domenic/promises-unwrapping まだES6は策定段階ですが、既にPromisesについてはpolyfillとして利用できるライブラリ等もあり、また他のライブラリ内でもjQuery.Deferred()やAngularの$q等類似する実装が存在します。 そのため、Generators等に比べると今すぐ使える
-
きんモザが終わる。 毎週楽しみにしていたきんモザが。 寂しい。 アリスと会えなくなることが、寂しい。 寂しいので、アリスのgif画像を取得できるAPIを作った。 http://mogashi.com/alice/ クエリストリング無しでアクセスするとランダムで Content-Type: image/gif な画像が降ってくる。 クエリストリングに使える有効なパラメータは以下の通り。 パラメータ説明id画像を一意に識別するID。これを指定すると ep, no の指定は無効化される。ep話数。ep=1 なら第1話。noと一緒に指定して使う。なお作者は第6話のたこ焼きのシーンを作成して満足したため第7話以降のgif画像は存在しない。 10/5追記‥11話のアリスの泣き顔に心を打たれたためgif画像を追加した。ついでに12話まで作成した。no話数の中の順番。no=1 に近いほど序盤のシーンに
-
1