このエントリーをはてなブックマークに追加

5月

12

API Blueprint速習会@Wantedly

Organizing : Wantedly

Registration info

参加枠1

Free

Standard (Lottery Finished)
12/15

Description

概要

Wantedlyが内部向けにやっている勉強会に15名様だけご招待。

APIのドキュメントをどうするか、なかなか頭の痛い問題ですよね。JSON Schema, Swaggerもいいですが、今回はAPI Blueprintを紹介します。 WantedlyはMicroservice化を進めるにあたり、言語に依存せずに、APIドキュメントがとそれの整合性を保つためのテストが書けるAPIフレームワークを探していました。その中で一番良さそうとなったのが、Markdown形式でドキュメントを書いていく、API Blueprintです。API Blueprintは、apiaryという一つの会社がしっかりやっていることもあり、テストやエディタなど生態系が他のものよりも速いスピードで整ってきている印象があります。今回はこのAPI Blueprintの基本的な書き方、ドキュメント生成、テスト生成を行い、時間に余裕があればRailsのscaffoldのタイミングでAPI Blueprintの雛形を作ってくれるgemの紹介をします。

対象

  • APIドキュメントを書く事に苦労をした経験のあるWeb, Mobileエンジニア

この速習会でできるようになること

  • APIドキュメントを書く選択肢としてAPI Blueprintを使えるようになる
  • API Blueprintを元にしたテストを行えるようになる

参加要件

  • 最新のnode, railsをインストールしたPCを持参でいること
    • nodeはnpm install aglio dredd api-mockができればOK
    • railsはrails new hoge --apiが使えればOK

事前準備

Sync(グループチャットサービス)で質問受付るので事前ログインお願いします https://sync.wantedly.com/s/1Wi7YDj

懇親会

  • 速習会のあと、軽食をご用意してあります。

Presenter

Media View all Media

If you add event media, up to 3 items will be shown here.

Feed

kawasy

kawasy さんが書き込みました。

2016/05/09 13:57

今週木曜にやります!

AzusaYamamoto

AzusaYamamoto published API Blueprint速習会@Wantedly.

05/09/2016 13:50

API Blueprint速習会@Wantedly を公開しました!

Group

Wantedly

ビジネスSNS「Wantedly」の開発チーム主催のエンジニア・デザイナ向けイベントです

Number of events 88

Members 3107

Ended

2016/05/12(Thu)

19:30
21:00

Registration Period
2016/05/09(Mon) 13:30 〜
2016/05/12(Thu) 18:00

Location

ウォンテッドリー白金台オフィス

東京都港区白金台5-12-7 MG白金台ビル4階

Attendees(12)

tommy_nezy

tommy_nezy

API Blueprint速習会@Wantedly に参加を申し込みました!

honda

honda

API Blueprint速習会@Wantedly に参加を申し込みました!

seiyakubo

seiyakubo

API Blueprint速習会@Wantedlyに参加を申し込みました!

kneeprayer

kneeprayer

API Blueprint速習会@Wantedlyに参加を申し込みました!

ShigekiYamanaka

ShigekiYamanaka

API Blueprint速習会@Wantedly に参加を申し込みました!

mochan_tk

mochan_tk

API Blueprint速習会@Wantedly に参加を申し込みました!

iSwift

iSwift

API Blueprint速習会@Wantedly に参加を申し込みました!

YukiOya

YukiOya

API Blueprint速習会@Wantedly に参加を申し込みました!

amanuma

amanuma

API Blueprint速習会@Wantedly に参加を申し込みました!

decoch

decoch

API Blueprint速習会@Wantedlyに参加を申し込みました!

Attendees (12)

Canceled (12)