Basic認証とOAuthとその辺の情報について整理しておく。OAuthや認証・認可について説明しようとすると、1文字記述するたびに誤りが含まれてしまう可能性があるので、本当に緊張感を持って記述しなければならない。それでもなお、この文章にはたくさんの誤りが含まれている。 UsernameとPasswordを受け取って認証する形式の認証方法。UsernameにはEmailを使うこともある (要は全ユーザの中で一意なことが保証されていてかつ他の人がその値を知っていても特に問題がないという情報であればOK)。Passwordは本人しか知り得ない情報。 OAuthという仕様に則って提供される認可方法。古いOAuth 1.0と、OAuth 1.0の複雑なところなどを改善したOAuth 2.0がある。一般的にはOAuth 2.0を使うことが多いが、例えば幾つかのサービスの提供している認可方法はOAut

内部用APIであるか外部の開発者向けのAPIであるかに関わらず、ドキュメントと実装との乖離は極力避けたいものであるが、注意深く開発を進めない限りこの状況は容易に起こり得る。何が乖離を引き起こし、どうすればこの状況を回避できるのか考えながら、JSON Schemaの利用例を紹介する。なおこの投稿では、HTTP経由でデータの通信を行うような狭義のAPIのことをAPIと呼ぶことにする。 同じ情報源を参照する APIドキュメントと実装が同じ情報源を参照するようにすれば、論理的に関連した要素は統一的に変更され、これらの変更は完全に同期が取れたものになる。つまり、変更時に乖離が生じにくくなる。但し情報の見せ方によって乖離が発生する可能性は十分にだろうし、乖離が発生するのは理解しようとする側の認識の問題であるから、論理的に全く起こり得ないということではない。 この参照の形には、両者が別の情報源を参照する

JsonWorldというGemを使って、JSON Schemaを生成できるモデルクラスをつくります。Qiita API v2のJSON Schemaを公開しました - Qiita Blog の裏側で使っているやつです。 JsonWorldの使い方 JsonWorld::DSL というModuleが提供されているので、これを任意のClassにincludeします。このmoduleをincludeしたClassでは、以下の特異メソッドが利用できるようになります。propertyとlinkを利用してインターフェースを定義し、to_json_schemaでJSON Schemaとしての表現を取り出す、というのがJsonWorldの使い方です。 .property(property_name, options) .link(link_name, options) .to_json_schema Js

2014年8月からBASE株式会社のCTOとして、技術者育成と組織作りに取り組んでいるえふしんこと藤川真一さん。 コードレビュー、リモートワーク、デザイン・ファーストなど、えふしんさん流の仕事やマネジメントの流儀を聞きました。 by 馬場美由紀 （CodeIQ中の人） ネットショップの作成が多彩に、簡単に無料でできるサービス 2014年8月から、ネットショップの開設・運営が無料で簡単にできる「BASE（ベイス）」を展開しているBASE株式会社で、CTOを務めています。BASEは2012年12月創業のスタートアップですが、そのサービスはいまや16万店舗が利用するまでに育ちました。スマホ向けアプリのダウンロードも好調です。 BASEは、私が以前籍を置いていた「paperboy&co.」（現・GMOペパボ株式会社）の創業者である家入一真氏が仕掛けた、モノづくり集団「Liverty（リバティ）」の

ドワンゴでエンジニアの教育も担当している清水(@meso)です。 昨年に引き続き、今年もエンジニアの新人研修を担当いたしましたので、その内容をご紹介いたします。 昨年の内容は http://ch.nicovideo.jp/dwango-engineer/blomaga/ar567236 一昨年の内容は http://ch.nicovideo.jp/dwango-engineer/blomaga/ar246504 今年は、昨年までと異なりエンジニア以外へのプログラミング研修を開催したり、エンジニアへのプログラミング言語の研修を Scala に変更したりしたので、その辺りを重点的にご紹介いたします。 合同プログラミング研修 ドワンゴに入社したエンジニア、デザイナ、企画の新入社員と、KADOKAWAに入社した新入社員の方の全員を対象にしたプログラミング研修を行いました。 プログラミングをバリバリ