JSON Web Token（JWT）のClaimについて · なるはやで いい感じの 動作確認
REST APIなどを開発すると、避けては通れないものに認証があります。 最近はOAuth2 Providerを実装することが多いのですが、発行するアクセストークンにJSON Web Token（JWT）を利用しています。 JWTは名前の通り、RFC7519によって定義されたスキーマを持つJSONです。 JSONの各キーとして、RFCで定義されている標準的なキーと値のペア（Claim）を取ることにより、標準的な取り扱いが可能になります。 本記事では、JWTのClaimについて、OAuth2 Providerでのアクセストークンを発行する立場から、備忘録的にまとめたいと思います。 なお、JWTにはJOSE Headerのような、Claimとは別の仕様も含まれていますが、本記事ではClaimのみを対象とします。 アクセストークンとしてJWTを利用することの利点 JWTは単なるJSONのため、ア
API開発・テスト便利ツール Postmanの使い方メモ - Qiita
基本的に直感的に使えるPostmanですが、Collection、Test、環境変数、Pre-request Scriptの使い方とかあまり理解してなかったの調べたメモ。 やりたいこと 私がやりたいことはおおよそ下記のようなものです。 基本操作（済み） Collectionの使い方を調べる Testのやり方を調べる 環境および環境変数の使い方を調べる Pre-request Scriptの使い方を調べる その他 準備 postman postmanのページから自分のプラットフォームに合ったものをダウンロードします。 その他詳細は、他のページに譲ります。 テスト用APIの用意 ローカルに環境を用意します。環境変数によるURL変更等をテストするために下記2つのURLを用意します。 api.phpの内容は一旦同じです。 http://localhost/test/api.php http://l
Rails API Testing Best Practices
Writing an API is almost a given with modern web applications. I’d like to lay out some simple guidelines and best practises for Rails API testing. We need to determine what to test and why it should be tested. Once we’ve established what we will be writing tests for, we will set up RSpec to do this quickly and easily. Basically we’ll be sending HTTP requests and testing that the response status c
Rails でつくる API のテストの書き方（RSpec + FactoryGirl） - おいちゃんと呼ばれています
最近 Rails で API をつくりはじめました。1か月テスト書きまくって、だいたい書き方が落ち着いてきたので共有します。 もっとこうした方が良くない？というのをコメントまたははてブコメントしてくださったら泣いて喜びます！ 環境は下記のとおりです。 * rails 4.0.0 * rspec-rails 2.14.0 * factory_girl_rails 4.2.0 もくじ Rails でつくる API のテストの書き方（RSpec + FactoryGirl） 1. ベストプラクティス 2. RSpec の Request spec で書く 3. Capybara は使わない 4. GET のテスト例 1（データを 1件取得） (1) ステータスコードの明示 (2) モデルの個別の内容を返すときは、属性を列挙して確認 5. GET のテスト例 2（データを一覧取得） (1) 属性を
認証を含む API 開発で検討すべきこと - ボクココ
ども、@kimihomです。 API に関する基礎的な話で、なぜ API が重要なのか、APIの実装で注意する点について記述した。 今回はAPI開発において最も頭を悩ます、認証の問題について考えてみたい。 API における認証 よくあるログインが必要なページを考えてみていただきたい。 通常のWebアプリケーションであれば、Cookieという仕組みを使って毎回Webサーバーにアクセスするときにsession idというものを送信し、それとユーザー情報を紐付けたデータを取ってくることで、どんなユーザーからリクエストが来たのかをWebアプリケーション側で判断することができる。これにより、私たちはいつも閲覧しているWebアプリケーションが自分専用の画面として見れるようになっている。 これがAPIになると話は違ってくる。Cookieという仕組みが使えないのである。ということで、なんとかしてAPIにア
結婚式でLINE Message APIを使った写真共有サービスを作った話 - tomoima525's blog
先日結婚式を挙げました。式中ご参列いただいた方と簡単に写真を共有したいなと思い、そういうマイクロサービスを作ってみました。ここではどのように実装していったのかを記憶が薄れぬうちに書いていこうと思います。 着想と仕様 自分が結婚式に参列する時、写真を撮るものの、主賓に送りそびれることがよくあって、だったらそのままさくさく送れたら楽じゃんねーと思っていました。で送りっぱなしだとグルーブ感がないので、出来たらその場でシェア出来たらよいかもと考えていました。それを踏まえて仕様としては、 その場でサクサク送れる 送った写真をリアルタイムに共有できる ことを目指しました。 全体構成 全体構成は以下のようになっています。 LINE Message APIを使ってLINEのチャンネルを参列者に登録してもらい、そこから写真を投稿してもらいます。webhookを介して画像データをサーバーに渡し、CDNに保存し
Web API 設計のベストプラクティス集 "Web API Design - Crafting Interfaces that Developers Love" - フリーフォーム フリークアウト
移転しました http://please-sleep.cou929.nu/20130121.html
Automation Accountパターン - 世界線航跡蔵
コンテキスト あなたが開発しているサービスはユーザー向けにAPIを提供している。そして、APIを利用するにはユーザーは短寿命の認可情報(たとえばOAuth2トークン)を提示しなければならない。 ユーザーは認可情報が紐付いているアカウントの権限でリソースを読み取ったり、作成したり、所有したり、編集または削除したりする。 ここで、ユーザーは人間(が操作するユーザーエージェント)であることもあるが、人間の手を離れてバックグラウンドで自動実行されるプログラムかもしれない。 また、あなたは悪用目的でアカウントが大量登録されるのを防ぐためにCaptchaを利用したいと思っている。 さらに、課金目的で請求書送付先を登録させたいとも思っているかもしれない。 問題 プログラムが利用するアカウントを安全に管理するのがユーザーにとって困難である。 プログラムは自分でCaptchaを解いたりEメールを受け取るのが
The GitHub GraphQL API
EngineeringThe GitHub GraphQL APIGitHub announced a public API one month after the site launched. We've evolved this platform through three versions, adhering to RFC standards and embracing new design patterns to provide a clear and consistent interface. GitHub announced a public API one month after the site launched. We’ve evolved this platform through three versions, adhering to RFC standards an
BacklogのAPIのRubyラッパーbacklog_v2_4rを公開(オレが使うAPIの分だけ) - コンユウメモ @kon_yu
数あるIssue管理システムがたくさんあるが、JIRAだの、Redmineだなの、Trelloだのあるし、 Github issueにZenHubを利用するのが最近のホットなツールかも知れないね。 うちの会社では、非エンジニアでも入力しやすさを重視して、Backlogを利用している。 Backlogは、RedmineっぽいののSaaSを会社で使っている それのバーンダウンチャートがどうも会社で使っている方式と合わない。 おまけにバーンダウンチャートは高めのプランでしか使えない、 そこでいままでGem作ったこともなかったしラッパーライブラリを作って自前でバーンダウンチャートを作ることにした。 幸いRESTFulなWebApiをサービスの開発者とのNulabさんが公開している。 Backlog APIドキュメント これを薄くラップしたものを作成した。 Gemの公開方法は一つ前のポスト kony
翻訳: WebAPI 設計のベストプラクティス - Qiita
これは Enchant の開発者である Vinay Sahni さんが書いた記事「Best Practices for Designing a Pragmatic RESTful API」1を、ご本人の許可を得て翻訳したものです。 RESTful な WebAPI を設計しようとすると、細かなところで長考したり議論したりすると思います。また、他の API に倣ってやってはみたものの、本当にそれでいいのか、どうしてそうしているのか分からない、何てことも少なくはないと思います。 この記事では、そのようなハマリどころについて Vinay さんなりの答えを提示し、簡潔かつ明快に解説してくれています。 今後 WebAPI を設計される方は、是非参考にしてみてください。 なお、誤訳がありましたら編集リクエストを頂けると幸いです。 まえがき アプリケーションの開発が進むにつれて、その WebAPI を公
RailsでAPI作成とAPIのテストのまとめ - Rails Webook
Photo by Gonzalo Baeza | Flickr - Photo Sharing! RailsでJSONを返すAPIを作成し、また、APIのテスト方法も説明します。 JSONを返すAPIは、RailsのActiveSupportより拡張されたto_jsonメソッドとDMMが開発したjbuilderというGemを使います。 APIのテストにはおなじみのRSpec3を使います。 動作確認 Rails 4.1.7 jbuilder 2.2.6 rspec-rails 3.1.0 factory_girl 4.5.0 目次 1. 前提条件 2. APIの作成 2.1. 1つのコントローラーでHTMLやJSONを返すAPI 2.2. JSONのみを返すAPI 2.3. APIのバージョニング 3. APIのテスト 3.1. テストファイルの準備 3.2. 一覧(index)APIのテス
Rails + Grape + API Key Authentication
When adding a Grape API to an existing Rails application you have a few options for user authentication. Probably the simplest and most basic way to authenticate an API is by issuing API keys to your users. How it works…User submits their Username/Password to the API.API authenticates the user and returns an API Key.For all subsequent API requests, the user submits the key with their request. This
Lambda+GItHub+Travis CIで全自動サーバーレスAPI
2016/06/11のフロントエンドカンファレンスのLTで発表した資料です。
駅とか路線のマスターデータの入手方法 - Qiita
背景 WEBサービスで駅とか路線のマスター情報とか使いたいときが結構あると思います。自分でマスター管理するのは大変なので、どこかにお願いしたいですよね。そんな時はこちら。 無料 駅データ.jp 無料（有料プランもあり） 事業者マスタ、路線マスタ、駅マスタ、接続駅マスタがCSVで提供されます APIでの提供も用意されています 商用利用やデータの改変についても制約がなく使い勝手が良さそうです 有料契約すると取得できる情報がちょっと詳細になります リクルートWEBサービス 無料 APIでの情報提供になりますが、沿線マスタAPIで全件取得できますので、それをもとにAPIをぐるぐる回せば自分で駅マスターは作れそうです ただ利用者としてリクルート社のコンテンツをマッシュアップしてサービス提供したい人向けのようなので、全く無関係のシステム・サービスで利用しようとしている場合は利用許可がでないかもしれませ
Rails::API について発表した - おもしろwebサービス開発日記
FiNC さんの社内マイクロサービス勉強会と、表参道.rb にて、そろそろリリースされそうな Rails 5 におけるメジャーフィーチャの一つ Rails::API について話しました。 雑感 スライド読むと分かるように、Rails::API は API サーバを作る時の銀の弾丸でもなんでもなくて、条件に合致したときに使うとちょっとだけ速くなりますよ、軽くなりますよという機能なのでした。 Rails::API の機能面としてはそれだけなのだけど、Rails は Rack Middleware や ActionController::Base 内の Module が疎になっていて、着脱が簡単なんですよというのを示す良い例にもなっていると思います。使っていない Middleware や Module を外すことで、手軽にちょっぴり速く／軽くできるので、API サーバに限らず不要なものがある場合
はてなブログ API 用の gem を書いた - kymmt
はじめに はてなブログの AtomPub API 用の Ruby gem が意外にも存在しなかったので書きました。 kymmt90/hatenablog hatenablog | RubyGems.org | your community gem host 概要 Ruby スクリプトから、はてなブログのエントリ取得やブログへの投稿ができるようになります。 require 'hatenablog' # デフォルトでは 'conf.yml' から OAuth 設定を読み込む Hatenablog::Client.create do |blog| # 最新 7 件のエントリの内容を出力する blog.entries.each do |entry| puts entry.content end # 新しいエントリを投稿する posted_entry = blog.post_entry('Entry
10年を超えたサービスの改善を加速する土台作り - Pepabo Tech Portal
これはAPIにPOSTした結果が正常応答ではない場合に、開発者のメーリングリストに対して、エラーメールを送信する実装です。Webhookやログ解析ツールの発達した昨今では、こういった通知はSlackなどのチャットツールへ送るか、もしくはログを出力し、その内容を元に通知することが多いと思います。この通知をメールで行う場合の起こりえる問題として下記が挙げられます。 履歴管理がしにくい、情報を蓄積しづらい 検索に適していない(メーラー依存) 基本的にメールは個人で見るものなので、エラーの自分事化がしづらい 特に3. 基本的にメールは個人で見るものなのでエラーの自分事化がしづらいについてはエラーメールを受信した際に、その対応をいつまでに、誰が、どういった方法でやるのかを管理しづらいという問題があります。こういった幾つかの問題を技術的に解決する方法について説明していきます。 ログを集める ムームード
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
How do you post markdown using confluences rest API?
https://github.com/Microsoft/api-guidelines/blob/master/Guidelines.md
