Upgrade to Pro — share decks privately, control downloads, hide ads and more …

API仕様書ってどう運用したらいいの? / api_doc

Avatar for Jun Watanabe Jun Watanabe
August 08, 2017
Programming
0
1.3k

API仕様書ってどう運用したらいいの? / api_doc

presented on PHP BLT #8
https://phpblt.connpass.com/event/61936/

Avatar for Jun Watanabe

Jun Watanabe

August 08, 2017
Tweet

More Decks by Jun Watanabe

See All by Jun Watanabe
Jamf Connect ZTNAとMDMで実現! 金融ベンチャーにおける「デバイストラスト」実例と軌跡 / Kyash Device Trust
Avatar for Jun Watanabe rela1470
1
250
20分1発勝負! 社内Webツールをライブコーディングするぞ! / Live Coding PHPerKaigi 2025
Avatar for Jun Watanabe rela1470
0
10
力技で実現するHR Driven Provisioningとアクセス制御の自動化 / kyash-hr-driven-provisioning
Avatar for Jun Watanabe rela1470
0
1.2k
10分(25分)でつくる社内Webツール / howto-oidc-webpage
Avatar for Jun Watanabe rela1470
0
150
リーグオブ情シス 第二回 / League of Infosys
Avatar for Jun Watanabe rela1470
1
1.4k
Kyashでコーポレートエンジニアを初採用して7ヶ月が経ちましたがお元気ですか / ce-night-kyash
Avatar for Jun Watanabe rela1470
4
3.2k
じこしょうかい2019 / rela1470-portfolio-2019
Avatar for Jun Watanabe rela1470
0
390
255オクテットのドメインはツラみがある! / endless-work
Avatar for Jun Watanabe rela1470
1
5.3k
ヤフーの1on1
Avatar for Jun Watanabe rela1470
0
520

Other Decks in Programming

See All in Programming
詳細の決定を遅らせつつ実装を早くする
Avatar for shimabox shimabox
1
990
퇴근 후 1억이 거래되는 서비스 만들기 | 내가 AI를 사용하는 방법
Avatar for Seungmin 마량 maryang
2
550
複数チーム並行開発下でのコード移行アプローチ ~手動 Codemod から「生成AI 活用」への進化
Avatar for ANDPAD inc andpad
0
120
AI POSにおけるLLM Observability基盤の導入 ― サイバーエージェントDXインターン成果報告
Avatar for ♛Heitor Hirose hekuchan
0
470
The Missing Link in Angular's Signal Story: Resource API and httpResource
Avatar for Manfred Steyer manfredsteyer
PRO
0
100
The Past, Present, and Future of Enterprise Java
Avatar for ivargrimstad ivargrimstad
0
420
Designing Repeatable Edits: The Architecture of . in Vim
Avatar for Satoru Kitaguchi satorunooshie
0
260
Agentに至る道 〜なぜLLMは自動でコードを書けるようになったのか〜
Avatar for mackee mackee
4
530
例外処理を理解して、設計段階からエラーを見つけやすく、起こりにくく #phpconfuk
Avatar for Takuma Kajikawa kajitack
12
5.7k
開発生産性が組織文化になるまでの軌跡
Avatar for ふくすけ tonegawa07
0
140
Verilator + Rust + gRPC と Efinix の RISC-V でAIアクセラレータをAIで作ってる話 RTLを語る会(18) 2025/11/08
Avatar for Ryuji Fuchikami ryuz88
0
340
SidekiqでAIに商品説明を生成させてみた
Avatar for Aki Nakahara akinko_0915
0
130

Featured

See All Featured
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
Avatar for Tammy Everts tammyeverts
55
3.1k
Connecting the Dots Between Site Speed, User Experience & Your Business [WebExpo 2025]
Avatar for Tammy Everts tammyeverts
10
660
What's in a price? How to price your products and services
Avatar for Michael Herold michaelherold
246
12k
Why Our Code Smells
Avatar for Brandon Keepers bkeepers
PRO
340
57k
VelocityConf: Rendering Performance Case Studies
Avatar for Addy Osmani addyosmani
333
24k
Cheating the UX When There Is Nothing More to Optimize - PixelPioneers
Avatar for Stéphanie Walter stephaniewalter
285
14k
JavaScript: Past, Present, and Future - NDC Porto 2020
Avatar for David Neal reverentgeek
52
5.7k
Save Time (by Creating Custom Rails Generators)
Avatar for Garrett Dimon garrettdimon
PRO
33
1.8k
Rails Girls Zürich Keynote
Avatar for Gregor Martynus gr2m
95
14k
Embracing the Ebb and Flow
Avatar for Simon Collison colly
88
4.9k
Documentation Writing (for coders)
Avatar for Carmen Chung carmenintech
76
5.1k
Measuring & Analyzing Core Web Vitals
Avatar for Philip Tellis bluesmoon
9
660

Transcript

  1. API࢓༷ॻ͕ ؾ͍ͮͨΒ Excelʹͳͬͯͨ

  2. API࢓༷ॻ͕ ؾ͍ͮͨΒ Excelʹͳͬͯͨ

  3. ͍ͬͯ͏ ጻչΛ͠·͢

  4. ղܾͯ͠·ͤΜ

  5. Twitterͱ͔࠙਌ձͰ ͥͻͥͻ

  6. API࢓༷ॻͬͯ Ͳ͏ӡ༻͢Ε͹ྑ͍ͷ? 2017/08/08 PHP BLT #8 Jun Watanabe

  7. Jun Watanabe @rela1470 • ORATTA, Inc. Chief Engineer • PHPer

    • αʔόʔνʔϜͰ޷͖উख • http://rela.red/

  8. https://www.asuka-zero.jp/

  9. ʲલఏ৚݅ʳ ৽ن։ൃҊ݅ PCιʔγϟϧήʔϜ(PWA) αʔόʔ3ਓ+ωΠςΟϒ3ਓ REST API

  10. 2016೥4݄ (ϓϩδΣΫτ࢝ಈ)

  11. ๭API υΩϡϝϯτ ʹײಈ

  12. http://docs.powerbi.apiary.io/

  13. ೖग़ྗ͕ Θ͔Γ΍͘͢ ·ͱ·͍ͬͯΔ

  14. ϞοΫαʔόʔ ࣮ࡍʹୟ͚Δ

  15. Debugging Proxy ࣮ࡍͷAPIΛhookͯ͠ ݁ՌΛҰཡදࣔ

  16. None
  17. None

  18. εΩʔϚΛఆٛͨ͠Β ͦͷܕʹ߹Θͤͨ μϛʔσʔλΛฦͯ͘͠ΕΔ

  19. None

  20. yamlͰΰϦΰϦॻ͘ or Ξϊςʔγϣϯʹॻ͍ͯม׵

  21. ΊΜͲ͍͘͞…

  22. ͋ͱͰ΍Ζ͏ͱ ࢥͬͯ·ͨ͠

  23. apiaryΛॻ͍͔ͨͲ͏͔ νΣοΫ͢Δද͕ग़དྷͨ

  24. ΋ͬͱΊΜͲ͍͘͞…

  25. 2016೥10݄ (6ϲ݄໨)

  26. ୭΋ߋ৽͠ͳ͘ͳͬͨ

  27. PHPॻ͘Ҏ֎ͷ͜ͱ͸ ΍Γͨ͘ͳ͍

  28. PHPॻ͍ͨΒ ࣗಈͰυΩϡϝϯτੜ੒ ͢Ε͹ྑ͍ͷͰ͸

  29. phpDocumentor 2 https://www.phpdoc.org/

  30. ApiGen http://www.apigen.org/

  31. None

  32. ࢓༷มߋ͞Εͯ΋ phpDoc͸ݹ͍··…

  33. ঃʑʹ๨ΕڈΒΕΔ

  34. 2016೥12݄ (8ϲ݄໨)

  35. None

  36. Excelӡ༻։࢝

  37. ਖ਼͘͠͸ Google εϓϨουγʔτ

  38. ಉ࣌ߋ৽OK मਖ਼ཤྺ΋෼͔Δ ௚ײͰૢ࡞͠΍͍͢

  39. ϚΫϩ৬ਓ͕ ࢓༷ॻ͔ΒίʔυΛ ࣗಈੜ੒

  40. ݱࡏਐߦܥ

  41. 2017೥5݄ (13ϲ݄໨)

  42. None
  43. None

  44. 2017೥6݄ (14ϲ݄໨)

  45. Insomnia Teams ܖ໿

  46. None

  47. ౴͑͸ݟ͔ͭͬͯ·ͤΜ

  48. Twitterͱ͔࠙਌ձͰ ͥͻͥͻ