Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
freee Public APIはプロダクトの拡大にどう立ち向かうか? / How does ...
Search
freee
June 05, 2024
1
2.2k
freee Public APIはプロダクトの拡大にどう立ち向かうか? / How does the freee Public API stand up to product expansion?
freee
June 05, 2024
Tweet
Share
More Decks by freee
See All by freee
品質の高速フィードバックへの取り組み / Commitment to Fast Quality Feedback
freee
3
790
組織作りに「プロダクト開発のエッセンス」 を取り入れ、不確実性に向き合い続ける / Incorporating the “essence of product development” into organizational development and continuing to face uncertainty
freee
0
1.2k
LGBTQ__support_WOMEN_女性として働くということ_DEI
freee
2
420
QAエンジニア_Summer Internship説明会(26卒)
freee
0
220
権限管理基盤の開発とQAの今 / Authority Management Infrastructure Development and QA Now
freee
1
2.3k
国籍と専門性を超えてのコラボレーション / Collaboration across nationalities and specialties
freee
1
2.2k
デザインリサーチの広げ方 〜XDの姿勢・態度・思考〜 / How to Expand Design Research 〜˜XD's Attitude, Attitude, and Thinking
freee
1
2.2k
グローバルなQAエンジニア・・・ってナニ!? / Global_QA_Engineer..._What_s_that.pdf
freee
1
2.2k
ぶきっちょPMによるfreeeのカルチャーとプロダクトのつながりについて / The Connection Between Freee's Culture and Product by a Clumsy PM
freee
1
2.2k
Featured
See All Featured
Music & Morning Musume
bryan
46
6.1k
実際に使うSQLの書き方 徹底解説 / pgcon21j-tutorial
soudai
167
48k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
131
32k
Creatively Recalculating Your Daily Design Routine
revolveconf
217
12k
Fontdeck: Realign not Redesign
paulrobertlloyd
81
5.2k
Ruby is Unlike a Banana
tanoku
96
11k
Code Review Best Practice
trishagee
62
16k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
29
2.2k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
4
110
Understanding Cognitive Biases in Performance Measurement
bluesmoon
26
1.3k
Building Applications with DynamoDB
mza
90
6k
GraphQLとの向き合い方2022年版
quramy
43
13k
Transcript
freee Public APIはプロダクト の拡⼤にどう⽴ち向かうか? prpr 2024年5⽉31⽇
▼略歴/Brief History 2017.03 ~ ⾼校卒業 2017.10 ~ 都内ヘアメイクサロン 2018.05 ~
株式会社U-NEXT 2023.01 ~ freee株式会社 ▼趣味/Hobby ‧バイク: 愛⾞⇨YAMAHA SR400 ‧お⾵呂‧サウナ: ‧愛猫: さくら(マンチカン♀) 2 prpr / ぷるぷる API基盤チーム Engineer
freee の Public API を知っていますか?
会計分野では30超のAPIで広範なシステム構築が可能 ‧⼀部この表で表現できな いエンドポイントについて 省略 ‧最新情報はAPIリファレン スにて随時更新中 https://developer.freee.co. jp/reference/accounting/r eference
他にも以下のプロダクトで提供中
freeeのAPIを活⽤したデータ連携 公開済のAPIエンドポイントを利⽤すれば、様々な業務連携/⾃動化が可能です 他サービス/ ⾃社のツール freee Public API • freeeに会計データを登録(受発注、請求、取引関連情報など)
• freeeに勤怠データを登録(打刻、勤怠時間、有給取得など)
freeeのAPIを活⽤したデータ連携 公開済のAPIエンドポイントを利⽤すれば、様々な業務連携/⾃動化が可能です 他サービス/ ⾃社のツール freee Public API • freeeの会計データを同期(⼊出⾦データ、勘定科⽬、取引先など)
• freeeの⼈事マスタデータの同期(従業員情報、給与情報など)
アプリストアから連携アプリを連携しよう!
便利な連携アプリがイロイロ 👀 POS・EC 購買・支払 人事マスタ・勤怠
まだまだ増える連携アプリ アプリストア掲載数 173件 ※2024年4月末時点
Public API 専⾨のチームがいます! プロダクトを横断してAPIの⼀貫性を保つことを⽬的に専任チームで開発を担ってき ました。 みんなで写真をとるゾ
プロダクトの拡⼤に伴ってAPIチームがぶつかった問題 • Webギャップ起因のハッピー(バグ)が増加 ◦ APIを提供している既存機能のWeb側の改修をキャッチアップ しきれない ◦ Webギャップ(WebではできるけどAPIではできないこと。また その逆もしかり)が起きる状況に
• 新規APIの開発が追いつかない ◦ Webで新機能が増える⼀⽅で、APIの開発が追いつかない ◦ ユーザーからAPIでも出来るようにしてほしい!と要望を 頂いていながら、なかなかリリースすることができなかった
プロダクトの拡⼤に伴ってAPIチームがぶつかった問題① Webギャップ起因のハッピー(バグ)が増加 • APIチームがWebと同時に開発することが限界 • Webギャップ(WebではできるけどAPIではできないこと。 また、その逆もしかり)が起きる状況に
Webギャップの例 取引先の電話番号の上限問題 • 事象 ◦ Webでは、取引先の電話番号は20桁までしか設定できないのに、 APIでは256桁の電話番号まで⼊⼒できてしまっていた。 ◦ 最⼤133⽂字のWebでは⼊⼒し得ない桁数の電話番号を取引先に
設定していた • 発⽣原因 ◦ Webのバリデーションがフロントにしか実装されていなかった。 ◦ Web側で上限がつけられたタイミングで、APIチームが変更を キャッチアップできておらず、バリデーションがかからないことに 気付けなかった
プロダクトの拡⼤に伴ってAPIチームがぶつかった問題② 新規APIの開発が追いつかない • Webで新機能が増える⼀⽅で、APIの開発が追いつかない • ユーザーからAPIでも出来るようにしてほしい!と 要望を頂いていながら、なかなかリリースすることができなかった
新規APIの開発に時間がかかってしまった例 仕訳帳APIの新CSVに対応 • 要望を2022年8⽉にいただく ⇩ • 2023年04⽉にようやく対応! 8ヶ⽉近くかかってしまった…。
おさらい • Webギャップ起因のハッピー(バグ)が増加 ◦ APIチームがWebと同時に開発することが限界 ◦ Webギャップ(WebではできるけどAPIではできないこと。また、そ の逆もしかり)が起きる状況に •
新規APIの開発が追いつかない ◦ Webで新機能が増える⼀⽅で、APIの開発が追いつかない ◦ ユーザーからAPIでも出来るようにしてほしい!と 要望を頂いていながら、なかなかリリースすることができなかった
API開発を APIチーム主導→プロダクトチーム主導へ! • Web側の開発といっしょにAPIも開発‧改修をしてもらう ◦ Webギャップ防⽌につながる ◦ APIを開発する⼈を増やして新機能をどんどんリリース ◦
「こんなAPIがあるべき」ということは、Web側の開発を⾏う⼈も 戦略を考えるべき • APIチームはAPI基盤チームとしての動きを強化する ◦ 「他チームがAPIを保守‧開発しやすいための開発」にフォーカス することで、結果的に全体としてのAPI開発を促進していく
どうしたらAPIも開発してもらえるか? APIチーム以外でAPI開発がどう捉えられているか、を確認するために ユーザーインタビューを実施 • PM向け ◦ API開発積極的に⾏っているAPIチームじゃないPM ◦ API開発これから⾏いそうなPM
• Eng向け ◦ API開発積極的に⾏っているAPIチームじゃないEng ◦ API開発これから⾏いそうなEng
ユーザーインタビュー(PM編) 課題 ◦ API開発は、APIチームじゃなくてもやってよいという事を知らない ◦ コミュニケーションチャネルがわからない ◦ 開発の流れがわからない ◦
APIはユーザー数がわからず、優先度が上がりにくい ◦ APIに関する声がAPIチームにしか届いていない (プロダクトFB等)
ユーザーインタビュー(Eng編) 課題 ◦ API追加する場合は、この辺りに加える必要がありますよ っていうことがわからない ◦ API⽣やしたい、と考えた時にどうやって話をもっていけば いいのかわからない ◦
破壊的変更かどうかが判断できない ◦ 開発環境構築の仕⽅がわからない
スタートブックを作成 ポイント • PublicAPIってなんだ?から解説! • PM⽬線での開発の流れ、つまづきやすい 破壊的変更と開発者告知について詳解! • API/アプリ利⽤状況を簡単に
調べられるクエリ付き!
スタートブックを作成 ポイント • 開発時の⼿をいれる箇所、流れを 既存エンドポイントの改修と 新規エンドポイントに分けて解説! • スキーマ駆動開発や破壊的変更などPublicAPI ならではの考え⽅を詳解!
• 環境構築の⼿引や困ったときの 連絡先の明記などしっかりとフォロー!
Developer向け配信で発信 • freee APIの⺠主化と題して、 プロダクトチームにもAPIの開発 を積極的に⾏ってほしいと訴求! • ここまで語ってきた課題感の共有 •
スタートガイドの案内 APIteam AJM APIteam マネージャー
API検定を実施 APIteam PdM
API検定を実施 • Bizも含めたfreees全員が 受けられる検定 • この検定をクリアすれば こんなことがちょっと分かる ◦ APIとは?
◦ freee APIの価値 ◦ APIでできること • SalesからAPIに関する案件で苦 戦するという要望を受けて作成 • API初⼼者を精⼀杯フォロー!
検定受講者からのFB 受講者90.7%は検定を経てAPIの解像度が上がった。
検定受講者からのFB • 思った以上にAPIの利⽤は簡単で、⼀定のITリテラシーがあれば活⽤可能 であるとイメージでき、また具体的な事例やアプリ数も知れた • APIの提案をすることがあるので⾃分で操作したことがあることは⼤きな 助けになる • freee
developer communityから実際にAPIを試すことができるのは初め て知ったのでQAとしてもハードルが下がりそうだなとおもいました!!
おさらい • ユーザーインタビューを実施 ◦ ⺠主化に向けての課題を明確化 • スタートブックを作成 ◦ APIチーム外が開発するときに⼿引となるDocを作成して
API開発へのハードルを下げる • Developer向け配信で発信 ◦ 全体周知して社内ムーブメントを起こす! • API検定を実施 ◦ Bizも巻き込んでAPIへの意識を⾼める🔥 ◦ API初⼼者もしっかりフォロー
今年度の「他チームによる会計APIのプルリク数」が 昨年度のAPIチームの総プルリク数を突破!🎉🎉🎉 196
今後の展望 • ドメインチームがより開発しやすい環境づくり ◦ API開発を簡単に⾏えるライブラリの作成 ◦ 破壊的変更を⾒逃さない仕組み ◦ スキーマの⼀貫性を保つ仕組み
• QAの⺠主化 ◦ API独⾃のテスト観点をプロダクトチームへ展開 ◦ テストしやすい環境整備
freee Public APIの進化に乞うご期待! • ぜひfreee Public APIを活⽤して効率的なバックオフィス業務を! ◦ 続々と機能追加が⾏われています!
◦ (もちろんプロダクトチームが開発してくれてます!!!) • さらなる新機能の追加、使いやすさの向上にご期待ください!
None