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
980
20分1発勝負! 社内Webツールをライブコーディングするぞ! / Live Coding PHPerKaigi 2025
Avatar for Jun Watanabe rela1470
0
24
力技で実現するHR Driven Provisioningとアクセス制御の自動化 / kyash-hr-driven-provisioning
Avatar for Jun Watanabe rela1470
0
1.3k
10分(25分)でつくる社内Webツール / howto-oidc-webpage
Avatar for Jun Watanabe rela1470
0
160
リーグオブ情シス 第二回 / League of Infosys
Avatar for Jun Watanabe rela1470
1
1.5k
Kyashでコーポレートエンジニアを初採用して7ヶ月が経ちましたがお元気ですか / ce-night-kyash
Avatar for Jun Watanabe rela1470
4
3.3k
じこしょうかい2019 / rela1470-portfolio-2019
Avatar for Jun Watanabe rela1470
0
400
255オクテットのドメインはツラみがある! / endless-work
Avatar for Jun Watanabe rela1470
1
5.4k
ヤフーの1on1
Avatar for Jun Watanabe rela1470
0
540

Other Decks in Programming

See All in Programming
CDIの誤解しがちな仕様とその対処TIPS
Avatar for futokiyo futokiyo
0
140
RubyとGoでゼロから作る証券システム： 高信頼性が求められるシステムのコードの外側にある設計と運用のリアル
Avatar for free_world21 free_world21
0
130
AHC061解説
Avatar for Shun_PI shun_pi
0
260
2026年は Rust 置き換えが流行る！ / 20260220-niigata-5min-tech
Avatar for girigiribauer girigiribauer
0
210
「やめとこ」がなくなった — 1月にZennを始めて22本書いた AI共創開発のリアル
Avatar for atani atani14
0
330
grapheme_strrev関数が採択されました（あと雑感）
Avatar for てきめん tekimen youkidearitai
PRO
1
190
AIコーディングの理想と現実 2026 | AI Coding: Expectations vs. Reality 2026
Avatar for Tomohisa Takaoka tomohisa
0
780
20260228_JAWS_Beginner_Kansai
Avatar for Takuya Yonezawa takuyay0ne
5
370
AI時代のキャリアプラン「技術の引力」からの脱出と「問い」へのいざない / tech-gravity
Avatar for MinoDriven minodriven
22
8.1k
AI巻き込み型コードレビューのススメ
Avatar for Nealle nealle
2
2.4k
Swift ConcurrencyでよりSwiftyに
Avatar for 野瀬田　裕樹 yuukiw00w
0
210
今、アーキテクトとして 品質保証にどう関わるか
Avatar for Nealle nealle
0
190

Featured

See All Featured
The AI Revolution Will Not Be Monopolized: How open-source beats economies of scale, even for LLMs
Avatar for Ines Montani inesmontani
PRO
3
3.1k
Crafting Experiences
Avatar for Bethany Jepchumba bethany
1
74
The Pragmatic Product Professional
Avatar for Laura Van Doore lauravandoore
37
7.2k
Side Projects
Avatar for Sacha Greif sachag
455
43k
Digital Projects Gone Horribly Wrong (And the UX Pros Who Still Save the Day) - Dean Schuster
Avatar for UX Y'all uxyall
0
550
Discover your Explorer Soul
Avatar for Emna emna__ayadi
2
1.1k
Thoughts on Productivity
Avatar for Jon Yablonski jonyablonski
75
5.1k
BBQ
Avatar for Matthew Crist matthewcrist
89
10k
How to make the Groovebox
Avatar for あそなす asonas
2
2k
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
Avatar for Sam Stephenson sstephenson
162
16k
YesSQL, Process and Tooling at Scale
Avatar for Rocio Delgado rocio
174
15k
Documentation Writing (for coders)
Avatar for Carmen Chung carmenintech
77
5.3k

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ͱ͔࠙਌ձͰ ͥͻͥͻ