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
力技で実現するHR Driven Provisioningとアクセス制御の自動化 / kyash-hr-driven-provisioning
rela1470
0
1.1k
10分(25分)でつくる社内Webツール / howto-oidc-webpage
rela1470
0
130
リーグオブ情シス 第二回 / League of Infosys
rela1470
1
1.4k
Kyashでコーポレートエンジニアを初採用して7ヶ月が経ちましたがお元気ですか / ce-night-kyash
rela1470
4
3.1k
じこしょうかい2019 / rela1470-portfolio-2019
rela1470
0
360
255オクテットのドメインはツラみがある! / endless-work
rela1470
1
5.1k
ヤフーの1on1
rela1470
0
490
15分でわかる!WBMPビューアー実装から始めるPHPバイナリ超初心者入門 / php_wbmp
rela1470
1
2.3k
またブラウザアプリの時代が来る!?ORATTAが考えるこれからのゲーム開発戦略とは / oratta_webapp_pwa
rela1470
0
1.8k
Other Decks in Programming
See All in Programming
Devinで実践する!AIエージェントと協働する開発組織の作り方
masahiro_nishimi
6
2.6k
AIエージェントによるテストフレームワーク Arbigent
takahirom
0
280
Use Perl as Better Shell Script
karupanerura
0
660
TypeScript製IaCツールのAWS CDKが様々な言語で実装できる理由 ~他言語変換の仕組み~ / cdk-language-transformation
gotok365
7
380
少数精鋭エンジニアがフルスタック力を磨く理由 -そしてAI時代へ-
rebase_engineering
0
130
型付け力を強化するための Hoogle のすゝめ / Boosting Your Type Mastery with Hoogle
guvalif
1
230
ts-morph実践:型を利用するcodemodのテクニック
ypresto
1
540
REST API設計の実践 – ベストプラクティスとその落とし穴
kentaroutakeda
2
320
Proxmoxをまとめて管理できるコンソール作ってみました
karugamo
1
410
Feature Flag 自動お掃除のための TypeScript プログラム変換
azrsh
PRO
4
630
技術的負債と戦略的に戦わざるを得ない場合のオブザーバビリティ活用術 / Leveraging Observability When Strategically Dealing with Technical Debt
yoshiyoshifujii
0
160
Practical Domain-Driven Design - Workshop at NDC 2025
mufrid
0
130
Featured
See All Featured
Designing for humans not robots
tammielis
253
25k
YesSQL, Process and Tooling at Scale
rocio
172
14k
Embracing the Ebb and Flow
colly
85
4.7k
Imperfection Machines: The Place of Print at Facebook
scottboms
267
13k
The Language of Interfaces
destraynor
158
25k
Six Lessons from altMBA
skipperchong
28
3.8k
The Illustrated Children's Guide to Kubernetes
chrisshort
48
50k
For a Future-Friendly Web
brad_frost
178
9.7k
Writing Fast Ruby
sferik
628
61k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
252
21k
Intergalactic Javascript Robots from Outer Space
tanoku
271
27k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
32
2.3k
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ͱ͔࠙ձͰ ͥͻͥͻ