アノテーションとAPIレスポンスをアサーションできるライブラリ作った - gong023の日記
概要 アノテーションと API レスポンスをアサーションできるようにするPHPのライブラリを作った。 gong023/swagger-assert アノテーションは、swagger のフォーマットを基準にしている。 swagger の説明は別に書いた ので、必要であれば参照してほしい。 インストール composer からインストールする "require-dev": { "gong023/swagger-assert": "dev-master" } なお、PHP5.4 以上必須。 実例 以下の様な API があり、そこに swagger のフォーマットでアノテーションが書かれていたとする。 swagger-assert を使うと、/plain のレスポンスが、swagger の記述どおり id と name キーを持っているかをアサーションできる。 <?php ** * @SWG\Re
アノテーションからドキュメントを作れるswaggerの使い方 - gong023の日記
swagger の概要と、基本的な使い方をサンプルを交えて書く。 なお、終始 PHP なので気をつけて下さい。 swagger の概要 開発ドキュメントをどうやって書くかという話題は常々ある。そして一番素直なアプローチを取ると、大抵 wiki みたいなアプリケーションを用意して、そこにドキュメント書こうぜという話になる。しかし、この管理は割とすぐ破綻してしまう。 理由はいろいろあるが、最新のコードに追従できなくなるとか、統一されたフォーマットを保証できず書き手によっては何を書いているのか全くわからないとかそういうケースが多い。 前者について、 swagger はアノテーションでドキュメントを書けるので違いは起きづらくなる。（ それでも不足だが自分でライブラリ作って補った ） また後者に関していえば、swagger は API の仕様を記述するためのフォーマットを提供してくれる。 つまり、s
DMMアフィリエイト | 初心者でも簡単！高収入を目指してはじめよう
ただいま登録サイトの審査を行っております。 審査完了後、成果レポートなどを確認できる管理ページの閲覧が可能となります。審査完了まで今ましばらくお待ちください。 なお、審査中でもサービスや商品の購入は可能となっております。
APIを探そう。国内外のインデックスサービスまとめ | NTT Communications Developer Portal
APIとAPIを組み合わせてマッシュアップサービスを作ろうと思った場合、まず自分が欲しいデータを提供しているAPIを探す必要があります。今回はそんなAPIのディレクトリを提供しているサービスをまとめて紹介します。 PublicAPIs 執筆時点で5,330のAPIから検索ができるAPIインデックスサービスになっています。名前やAPI名などを入れることで、新しいAPIの登録申請もできるようになっています。 PublicAPIs | Directory of public APIs for web and mobile API For That 検索、ソーシャル、ファイナンスなど約20のカテゴリに分かれて登録されています。約300種類くらいのAPIが登録されています。 API For That | An API Directory Zapier IFTTTのビジネス版と言った雰囲気のサービスに
YOLP(地図) - Yahoo!デベロッパーネットワーク
Yahoo! Open Local Platform（YOLP）は、Yahoo!マップがデベロッパー向けに提供する地図・地域情報のAPI・SDKです。ウェブページの制作はもちろん、スマートフォン向けアプリケーションの開発においても、多彩な地図表示、店舗・施設検索、ジオコーディング、ルート検索、標高データ取得などの豊富な機能をご活用いただけます。 お知らせ 地図・地域情報の検索 Yahoo!ローカルサーチAPI 全国の店舗、イベント、クチコミ情報などの地域・拠点情報を検索できます。 Yahoo!ジオコーダAPI 住所をキーワードとして検索し、その位置情報を提供します。 Yahoo!リバースジオコーダAPI 指定の地点の住所情報を取得する機能を提供します。 その他の便利ツール 気象情報API 指定した緯度経度の降水強度実測値と予測値を取得できます。 郵便番号検索API 郵便番号を指定して、位置
Pokemon APIなんてのがあった - pixyzehn blog
ポケモンなつかしい。 ポケモンの情報を返してくれるAPIというものを発見しました。 http://pokeapi.co/ 以下引用です。 This website provides a RESTful API interface to 54,363 objects related to Pokémon. We specifically cover the video game franchise, though we'd like to cover the card game too. Using this website you can consume information on Pokémon, their moves, abilities, types, egg groups and much much more. 最近のpokemonの情報は、ぜんぜん追えていなくてポケットモンス
全てがJSONになる - ✘╹◡╹✘
TL;DR JSON Schemaを使ってこういうことが実現可能になった。 ダミーAPIサーバの提供 ドキュメントの自動生成 APIクライアントの動的定義 APIサーバのバリデータの動的定義 APIサーバのレスポンスの自動テスト JSON Schemaとは JSON SchemaというのはあるJSONのデータ構造を記述するための方法および書式の仕様で、 JSON SchemaもJSONで記述される。 これを利用すれば、リソースベースの(=RESTfulライクな)APIの仕様が簡便に記述できる。 例えば、我々のAPIはレシピとユーザというリソースを扱っていて、 それぞれCRUDのAPIを備えており、レシピはidとtitleとdescriptionという属性を持つ、 という旨をJSON Schemaで表現できる。 なんで最近ちょっと流行ってんの Mobile First、 Service Or
APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight
ちょっと前にTwitterでAPIのバージョニングをどうやるかみたいな話をしていたのですが、そのへんもやもやしているので少し整理しておきたいなと。 APIのURLを/api/v1/*とかってやるの、やめたほうがいいとおもうんだけどなぁ。いざv2を作るとなったときに、大量のコピペが発生して後悔するよ、って伝えたい。— Kenn Ejima (@kenn) February 28, 2014 さて、これについて色々と異論・反論も含めた意見が出たのですが、まずは、大昔にURL方式（＝コントローラ分割）でやってきて後悔したぼくが、（5年ぐらい前から）現在はどうやってAPIのバージョンを管理しているか？について紹介します。 基本原理としては、コピペが多発する根っこで分岐（＝コントローラ分割）じゃなくて、必要最小限のところで限局的に分岐するのがいい、という考え方に基づきます。 一言でいうと、「パラメー
W3C、ゲームコントローラ対応の標準仕様「Gamepad API」のドラフトを公開
入力デバイスとしてマウスやキーボード、タッチとは別に、ゲームマシンのコントローラのようなデバイスに対応する仕様として、W3Cは「Gamepad」仕様のワーキングドラフトを公開しました。 この仕様がどういうものなのか、Introductionのところで次のように説明されています。 Currently, the only way for a gamepad to be used as input would be to emulate mouse or keyboard events, however this would lose information and require additional software outside of the user agent to accomplish emulation. 現在のところ、インプットデバイスとしてゲームパッドを利用するにはマウスかキ
Boombox.js·HTML5のオーディオ系APIを一つに集約 MOONGIFT
HTML5は多彩な機能をWebにもたらしてくれますが、機能が多彩でブラウザによってサポートされている機能が異なるなどまだまだ課題も多いのが実情です。しかしその課題こそプログラミングによって解決できる余地がある部分でもあります。 今回はオーディオ系APIを一つにまとめて提供してくれるライブラリBoombox.jsを紹介します。 Boombox.jsのデモ 実行中です。 Boombox.jsはHTMLAudio/WebAudio/HTMLVideoの3つのAPIを透過的にサポートするライブラリです。さらにブラウザが非アクティブな時には音を消したり、同時に複数の音を鳴らすのもサポートしています。 ミックスもサポートされています。 単純な再生、停止はもちろんのこと途中から再生したりループ再生、ボリュームの調整もできます。フィルタリングもサポートされています。サポートブラウザとしてはiOS/Andr
Apiary - r7kamura per second
API(とそれに携わる開発者)の規模が拡大してくると、ドキュメントの整備や、仕様と実装の一貫性の維持、 クライアントとの知識の共有など、考慮すべき問題が沢山出てくる。 これらの問題に対する現実的な解決策を探るため、 ApiaryというAPI開発支援用のサービスを簡単に俯瞰することにした。 ここでは紹介しないが、他に RAML、 JSON Schema、 Swagger、 WADL、 Autodoc などが関連するものとして挙げられる。 Apiary http://apiary.io/ Apiaryは、API Blueprintと呼ばれる言語でAPIのインターフェース仕様書を記述する、という開発方法を提唱している。 API BlueprintはMarkdownを拡張した言語で、特殊な記述を用いて幾つかのメタ情報を付与出来る形になっている。 Markdownを採用することで人間にとって読み書き
Processing 1.0 _ALPHA_ （日本語版） Reference
言語（API）Processingは、簡単に洗練された視覚や概念的な構造を創造できるようにデザインされている 他の外国語を選択 : 英語 この日本語リファレンスは旧バージョン(Alpha)用です。 Beta版リファレンスは英語サイトをご覧ください。日本語訳に関する質問はTetsu Kondoまで。 size() (サイズ) ; (セミコロン) = (アサイン) () (括弧) , (コンマ) // (コメント) /* */ (マルチラインコメント) void ボイド setup()（セットアップ） loop()（ループ） new（新規） {} (波括弧) [](配列アクセス) . (ドット) width（幅） height（高さ） framerate()（フレームレート） delay()（ディレイ） smooth()（スムーズ） noSmooth()（スムーズなし） cursor()（カー
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
API Ref ｜ Bjin.Me
150,000以上の英単語の意味、類義語などの情報が取得できる「Words API」が公開
Moves APIの使い方まとめ(サンプルコード付き)
Yahoo!デベロッパーネットワーク
Tumblr APIでwebサービスを作りたい全ての人に向けて書きました
はてブAPIでwebサービスを作りたい全ての人に向けて書きました
https://apitip.com/
【Rails 高速化】ペパボのフリマアプリ「kiteco（キテコ）」の API を高速化したときのことを詳しく書いてみた - 彼女からは、おいちゃんと呼ばれています
