| docomo Developer support | NTTドコモAPI共通 ガイドライン ドコモのAPIのご利用にあたって、共通で必要となる情報のご案内です。 よくあるご質問 APIなどの各サービスに関するよくある質問を掲載します。 お問い合わせ 「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。
RESTful Hypermedia API 概要編 | DevelopersIO
モバイルアプリサービス部の五十嵐です。 最近『ハイパーメディアAPI』という言葉を知って、興味が湧いたので調べてみました。これから何回かに分けて、ハイパーメディアAPIとは何か、Ruby on Railsでのサーバ側の実装方法、クライアント側の実装方法などを紹介していきたいと思います。 1回目の本記事では、ハイパーメディアAPIの概要説明として、用語の説明や登場の背景、フォーマットなどを紹介していきます。特に注意がない限りAPIはWeb APIを指します。なお、用語の定義というのは往々にして議論の対象になりやすいですが、ここでで説明するのは厳密な定義ではなく広義の定義と捉えてください。それでも私の認識に誤りがある場合は、そっとご指摘いただけると幸いです。 用語の説明 RESTful APIとは まずはRESTful APIについて簡単におさらいをします。RESTは分散された情報を扱うための
現実世界のJSON Hyper-Schema / Real World JSON Hyper-Schema
Ruby Business User Conference 2015での発表資料です。
IsomorphicとAPIファーストについて #apijp
「Web API Advent Calendar 2014 の５日目の記事です。」 最近、Isomorphicという言葉をよく聞く。 Isomorphicとは、サーバーとクライアントのコードを同時に記述するパラダイムのことだ。 つまり、フロントエンド・バックエンドを曖昧にするようなアーキテクチャである。 私は、IsomorphicはWebのアーキテクチャーに合っていないと思っていて、やはりAPIファーストで設計し、フロントエンド・バックエンドをきちんと分けるべきだと考えている。 この点について詳しく述べたいと思う。 Isomorphicな開発環境が求められる背景 Isomorphicな開発環境が求められる理由としては、こちらのMeteorの記事が大変わかりやすい。(リアルタイムWebアプリケーションフレームワークMeteorについて) 普通のWebでは状態が画面遷移でリセットされてしまうこ
Amazon API GatewayでAPIキー認証を設定する | DevelopersIO
ども、大瀧です。 AWS Summit NewYorkで発表&リリースされたAmazon API Gatewayをいろいろ触っています。API Gatewayの機能の一つとして、認証機構の追加があります。今回はAPI Gatewayがサポートする認証の一つとして、APIキー認証を紹介してみます。 APIキー認証とは API GatewayのAPIキー認証は非常にシンプルで、所定のキー(文字列)を所定HTTPヘッダ(x-api-keyヘッダ)に含めたリクエストであればアクセス許可、無ければアクセス拒否とする機能です。 APIキーは、API Gatewayで生成・管理されるようになっており、セキュアな運用が可能です。 前提の構成 以下の記事のセットアップが完了している状態です。 Amazon API Gateway – API作成から動作確認までやってみる ｜ Developers.IO gr
JSON Schema で Web API のスキマを埋めよう
クライアント実装 サーバ実装 仕様 Web API にありがちなこと API ドキュメント リクエスト レスポンス ぶっちゃけAPI の追加時く らいしか更新していない なぜかドキュメントにない属性が 含まれている 手が滑ってドキュメントと若干違う形式の 属性を含めちゃったけどなんとなく通った クライアント実装 サーバ実装 仕様 いまは API Blueprint で頑張ってる (http://apiblueprint.org/) API ドキュメント リクエスト レスポンス Markdown の スーパーセット (ツラい) API Blueprint (YAML 表現) generate mock validate あんまり嬉しく ない なんか別に JSON Schema 書かない といけない クライアント実装 サーバ実装 仕様 今日話したいこと JSON Schema API ドキ
APIs: A Strategy Guide を読んだ - @kyanny's blog
APIs: A Strategy Guide を読んだ。 この本は API の設計や実装に関する本ではない。もっと大局的な、 API を取り巻くエコシステム全体のあり方を論じる本だった。要するに、開発者視点では得るものが少なかった。とはいえ一ヶ月半近くかけて主に通勤中に、最後のほうはすっとばしながら、無理やり読んだので章ごとのざっくりしたまとめと感想を書く。 Chapter 1 The API Opportunity そもそもなんで API があると良いのかについてビジネス的な視点で触れている。スマートフォンのようなリッチなモバイル端末が世界中で爆発的に普及しているのでさまざまなデバイス向けに素早くコンテンツを提供できるかどうかが重要になる、そこで API ですよ、という流れ。 あと一般に API というと一般に公開してサードパーティの開発者に利用してもらう public API を想像し
[その１] Netflix: APIの改善と継続的デリバリー - ワザノバ | wazanova
http://techblog.netflix.com/2012/07/embracing-differences-inside-netflix.html 北米のインターネットトラフィックの30%以上を占めるNetflixのシステム構成は、UI（デスクトップ、スマホ、タブレット、ゲームコンソール、TV、ブルーレイ再生機）とサービス（Video meta data, search, user, A/B test, personalization）をAPIでつなぐアーキテクチャーになっていて、UIとサービスがそれぞれ独立して早いスピードで改善 & 新機能を投入できるかたちになっています。そのAPI改善から継続的デリバリーの仕組みをつくりあげるまでの昨年からの一連の動きを、４回にわけて紹介します。まず最初はAPIの改善の取組みから。 1) 背景 Web APIとしてはRESTが標準的になっている
swagger-expressを使って簡単にAPIドキュメントを作成する - Qiita
APIドキュメントツールにswaggerというものがあります。 公式のデモ ドキュメントに記載したAPIの一覧を表示し パラメータなどを直接入力してその場で試せるというものです。 facebookのGraph API Explorerや twitterの https://dev.twitter.com/console と同じような位置づけです。 すべて設定するととても便利なのですが、 ドキュメント元となるJSONの作成が必要であったり、 使いこなすのが結構大変だったりします。 ただswagger-expressを使うと 出来るだけ簡単にドキュメント化することができます。 swaggerの構成 ブラウザでの表示のためのindex.htmlやjs,css,imgなどがある、swagger-ui APIの情報がまとめられている 設置の仕方 expressを使ったアプリ sampleApp 上で、
JSON Hyper-Schema からAPIドキュメントとGoのコードを自動生成する | The Wacul Blog
３行で言うと herokuが作ってる prmd を使って、JSON SchemaからAPIドキュメントを出力したよ！ スキーマ定義から、GoのAPI実装コードも出力するツールを作ったらめっちゃ捗るよ！ Goのバリデーション用のライブラリも作ったよ！ 今回作ったものの概要とサンプルコード 概要 以前から、APIを開発する上で、以下のようなことが課題となっていました。 そもそもドキュメント書くのがつらい それもあって、ドキュメントより先にコードが変わってしまう ドキュメントと実装の状況の違いが把握しづらい また、ロジックがそんなに複雑ではないAPIでは、実装の作業は リクエストデータのバリデーション 出力データの整形 (フィルタリング) の２つの作業が大きな割合を占めます。 APIの定義ファイルからドキュメントと、バリデーションや出力データ整形のコードを自動生成できれば、大幅に効率が上がると思
モバイルアプリのユーザ認証方法についてまとめてみた - Qiita
追記 (2018-10-08) 4年以上前に書いた記事ですが、Access Token として JWT を利用することは非推奨なようなので、お詫びして修正致します。 参考: どうしてリスクアセスメントせずに JWT をセッションに使っちゃうわけ？ 概要 みんなやってるはずなんだけど、あまりまとまった情報がなかったので書いてみます。認証周りはセキュリティを気にして、みんな書きたがらないのかな？それとも私の調べ方が悪かっただけ？マサカリお待ちしてます。 認証の基本方針 +--------+ +--------+ | | | | | |----(1) Credential ------------>| | | | | | | |<---(2) Access Token -----------| | | | | | | Client | | Server | | | | | | |----(3)
Qiita API v2のJSON Schemaを公開しました - Qiita Blog
こんにちは、r7kamura です。 最近は主にイカとして活動しており、カラフルな墨を掛け合う日々を送っています。 さて、QiitaおよびQiita Teamでは、Qiita API v2としてデータを操作するためのREST APIを公開しています。これまで開発者向けに APIドキュメント を提供していましたが、今回は主に機械向けのインターフェースとして、JSON Schemaで記述したREST APIのスキーマ定義 (以下スキーマ) を公開することになりました。具体的には、JSON Hyper-Schema draft v4 を利用して定義されています。 http://qiita.com/api/v2/schema Qiita API v2のスキーマの説明Qiita API v2のスキーマの構成について簡単に説明します。スキーマは http://qiita.com/api/v2/sche
API Blueprint | API Blueprint
API Blueprint. A powerful high-level API description language for web APIs. API Blueprint is simple and accessible to everybody involved in the API lifecycle. Its syntax is concise yet expressive. With API Blueprint you can quickly design and prototype APIs to be created or document and test already deployed mission-critical APIs. Tutorial Tools section Focused on Collaboration API Blueprint is bu
API Documentation & Design Tools for Teams | Swagger
API Development forEveryone Simplify your API development with our open-source and professional tools, built to help you and your team efficiently design and document APIs at scale. Find your toolRead the docs Trusted by Empowering API Development Streamline your workflow with unparalleled API specification support Swagger places API specifications such as OpenAPI, AsyncAPI, and JSON Schema at the
ブラウザ操作で簡単にスクレイピングAPIが作れる「kimono」 - それはBooks
「kimono」はウェブサイトをブラウザ操作で簡単にスクレイピングして API 化してくれるサービスです。 kimono - Turn websites into structured APIs from your browser in seconds スクレイピングしたいサイトの URL を入力すると抜き出す要素を選択する画面になります。 最近ページングにも対応したので、ページングのあるサイトも簡単に取得できるようになります。 スクレイピングの頻度もリアルタイムや何時間毎のような設定ができます。 できた API は言語ごとに呼び出し例が用意されているので便利です。こういう所気が効いていますね。 実際に呼び出してみるとちゃんと結果が取得できます。 misc/kimono.rb require 'rest_client' require 'json' require 'pp' respons
Feedly APIメモ - Qiita
多分現在主流のRSSリーダーであるFeedlyが少し前にようやくAPIを公開してくれたので、オレオレリーダーを作る為の下調べをしてみた。最初戸惑ったが色々API叩いてるうちに大体わかってきたのでメモる。 APIドキュメント: http://developer.feedly.com/v3/ IDの種類と形式 userId - user/:userId feedId - feed/:feedUri categoryId - :userId/category/:categoryName 特殊カテゴリ: global.all, global.uncategorized tagId - :userId/tag/:tagName 特殊タグ: global.saved 認証手順 普通のOAuth2.0だが現在はredirect_uriが制限されているためサイト間認証は使えない。 http://local
iOSでOAuth2認証を行う(feedlyクライアントの作成)
The feedly Cloud APIが一般公開されていることはご存知の方は多いと思うが、APIを利用している方は そう多く無いのではないだろうか。 The feedly Cloud APIはsandboxという形式で開発者に開発用環境を提供している。 開発の序盤はこの開発環境を使用してAPIの使用方法やアプリの動作確認を行い、 その後リリースする準備が出来たら本環境で利用可能なクライアントIDを払い出してもらう という流れになると思う。(本環境に対応したクライアントIDの払い出しは別途Emailで申請する必要があるようだ) The feedly Cloud APIを使用するにはまずOAuth2認証が必要だ。これが一番厄介で(昔よりは良くなっている) 認証さえ済ませてしまえば、後はAPIを呼び出して必要な情報を取り出し、好きなように処理すれば良い。 iOS用のOAuth2ライブラリが存在
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
いろいろなサービスのAPIをcurlで叩くときの認証の扱い - Qiita
ホットペッパー | リクルートWEBサービス
kimono : Turn websites into structured APIs from your browser in seconds