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
API仕様書ってどう運用したらいいの? / api_doc
Search
Jun Watanabe
August 08, 2017
Programming
0
1.3k
API仕様書ってどう運用したらいいの? / api_doc
presented on PHP BLT #8
https://phpblt.connpass.com/event/61936/
Jun Watanabe
August 08, 2017
Tweet
Share
More Decks by Jun Watanabe
See All by Jun Watanabe
Jamf Connect ZTNAとMDMで実現! 金融ベンチャーにおける「デバイストラスト」実例と軌跡 / Kyash Device Trust
rela1470
1
240
20分1発勝負! 社内Webツールをライブコーディングするぞ! / Live Coding PHPerKaigi 2025
rela1470
0
7
力技で実現するHR Driven Provisioningとアクセス制御の自動化 / kyash-hr-driven-provisioning
rela1470
0
1.2k
10分(25分)でつくる社内Webツール / howto-oidc-webpage
rela1470
0
150
リーグオブ情シス 第二回 / League of Infosys
rela1470
1
1.4k
Kyashでコーポレートエンジニアを初採用して7ヶ月が経ちましたがお元気ですか / ce-night-kyash
rela1470
4
3.2k
じこしょうかい2019 / rela1470-portfolio-2019
rela1470
0
380
255オクテットのドメインはツラみがある! / endless-work
rela1470
1
5.2k
ヤフーの1on1
rela1470
0
520
Other Decks in Programming
See All in Programming
AIで開発生産性を上げる個人とチームの取り組み
taniigo
0
130
Advance Your Career with Open Source
ivargrimstad
0
360
明日から始めるリファクタリング
ryounasso
0
120
止められない医療アプリ、そっと Swift 6 へ
medley
1
120
AI Coding Meetup #3 - 導入セッション / ai-coding-meetup-3
izumin5210
0
610
実践AIチャットボットUI実装入門
syumai
7
2.5k
GraphQL×Railsアプリのデータベース負荷分散 - 月間3,000万人利用サービスを無停止で
koxya
1
1.2k
After go func(): Goroutines Through a Beginner’s Eye
97vaibhav
0
240
CSC509 Lecture 02
javiergs
PRO
0
410
Cloudflare AgentsとAI SDKでAIエージェントを作ってみた
briete
0
120
デミカツ切り抜きで面倒くさいことはPythonにやらせよう
aokswork3
0
200
Domain-centric? Why Hexagonal, Onion, and Clean Architecture Are Answers to the Wrong Question
olivergierke
1
260
Featured
See All Featured
Rails Girls Zürich Keynote
gr2m
95
14k
What’s in a name? Adding method to the madness
productmarketing
PRO
23
3.7k
How to train your dragon (web standard)
notwaldorf
96
6.3k
Put a Button on it: Removing Barriers to Going Fast.
kastner
60
4k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
30
2.9k
Code Review Best Practice
trishagee
72
19k
Practical Orchestrator
shlominoach
190
11k
Designing Experiences People Love
moore
142
24k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
36
2.5k
Building Flexible Design Systems
yeseniaperezcruz
329
39k
How to Ace a Technical Interview
jacobian
280
24k
It's Worth the Effort
3n
187
28k
Transcript
API༷ॻ͕ ؾ͍ͮͨΒ Excelʹͳͬͯͨ
API༷ॻ͕ ؾ͍ͮͨΒ Excelʹͳͬͯͨ
͍ͬͯ͏ ጻչΛ͠·͢
ղܾͯ͠·ͤΜ
Twitterͱ͔࠙ձͰ ͥͻͥͻ
API༷ॻͬͯ Ͳ͏ӡ༻͢Εྑ͍ͷ? 2017/08/08 PHP BLT #8 Jun Watanabe
Jun Watanabe @rela1470 • ORATTA, Inc. Chief Engineer • PHPer
• αʔόʔνʔϜͰ͖উख • http://rela.red/
https://www.asuka-zero.jp/
ʲલఏ݅ʳ ৽ن։ൃҊ݅ PCιʔγϟϧήʔϜ(PWA) αʔόʔ3ਓ+ωΠςΟϒ3ਓ REST API
20164݄ (ϓϩδΣΫτ࢝ಈ)
API υΩϡϝϯτ ʹײಈ
http://docs.powerbi.apiary.io/
ೖग़ྗ͕ Θ͔Γ͘͢ ·ͱ·͍ͬͯΔ
ϞοΫαʔόʔ ࣮ࡍʹୟ͚Δ
Debugging Proxy ࣮ࡍͷAPIΛhookͯ͠ ݁ՌΛҰཡදࣔ
None
None
εΩʔϚΛఆٛͨ͠Β ͦͷܕʹ߹Θͤͨ μϛʔσʔλΛฦͯ͘͠ΕΔ
None
yamlͰΰϦΰϦॻ͘ or Ξϊςʔγϣϯʹॻ͍ͯม
ΊΜͲ͍͘͞…
͋ͱͰΖ͏ͱ ࢥͬͯ·ͨ͠
apiaryΛॻ͍͔ͨͲ͏͔ νΣοΫ͢Δද͕ग़དྷͨ
ͬͱΊΜͲ͍͘͞…
201610݄ (6ϲ݄)
୭ߋ৽͠ͳ͘ͳͬͨ
PHPॻ͘Ҏ֎ͷ͜ͱ Γͨ͘ͳ͍
PHPॻ͍ͨΒ ࣗಈͰυΩϡϝϯτੜ ͢Εྑ͍ͷͰ
phpDocumentor 2 https://www.phpdoc.org/
ApiGen http://www.apigen.org/
None
༷มߋ͞Εͯ phpDocݹ͍··…
ঃʑʹΕڈΒΕΔ
201612݄ (8ϲ݄)
None
Excelӡ༻։࢝
ਖ਼͘͠ Google εϓϨουγʔτ
ಉ࣌ߋ৽OK मਖ਼ཤྺ͔Δ ײͰૢ࡞͍͢͠
ϚΫϩ৬ਓ͕ ༷ॻ͔ΒίʔυΛ ࣗಈੜ
ݱࡏਐߦܥ
20175݄ (13ϲ݄)
None
None
20176݄ (14ϲ݄)
Insomnia Teams ܖ
None
͑ݟ͔ͭͬͯ·ͤΜ
Twitterͱ͔࠙ձͰ ͥͻͥͻ