Upgrade to Pro — share decks privately, control downloads, hide ads and more …
Sign up for free

API specifications

Avatar for Michael Schmidt-Voigt Michael Schmidt-Voigt
February 27, 2018
Programming
20
0

API specifications

Lightning talk, PHP UserGroup Wellington

Avatar for Michael Schmidt-Voigt

Michael Schmidt-Voigt

February 27, 2018

More Decks by Michael Schmidt-Voigt

See All by Michael Schmidt-Voigt
Collection Pipelines
Avatar for Michael Schmidt-Voigt m165437
0
35

Other Decks in Programming

See All in Programming
Long Living Tokens, Die, Die, Die! (or: The One Ring is Banned in Modern)
Avatar for sylph01 sylph01
0
300
AI主導のプログラミング学習アプリを作ってみた
Avatar for econanringo econanringo
0
180
Herb in Rails 8.2: Your ERB views, now HTML-aware @ Kaigi on Rails 2026, Tokyo, Japan
Avatar for Marco Roth marcoroth
2
220
ChromeでローカルLLM
Avatar for ryu ryu1013
0
140
Unity6 URPによる海底をテーマにしたVJシステムの解説 | Unity Shader 完全に理解した 勉強会
Avatar for がむ gam0022
0
370
IBM Bob でAI駆動開発『QC-Playbook』
Avatar for 1kano ichirokano2
0
110
Everything will be SERVERLESS — 信じて運用した10年の経験値 / Everything Will be Serverless — Lessons Learned from 10 Years of Operational Experience
Avatar for shiro seike seike460
PRO
1
1.1k
Event is what happens
Avatar for MOROHASHI Kyosuke moro
2
770
Starting & Sustaining Code-Based E2E Testing for Non-Coding QA Teams( #jasstniigata )
Avatar for teyamagu teyamagu
PRO
1
1k
Jetpack Compose Mechanisms
Avatar for Jaewoong skydoves
3
820
R8 の設定見直しでアプリサイズ削減
Avatar for ANDPAD inc andpad
0
220
PumaからFalconに移行したRailsアプリケーションでの実践
Avatar for Hayato OKUMOTO falcon8823
0
170

Featured

See All Featured
Crafting Experiences
Avatar for Bethany Jepchumba bethany
1
380
Fireside Chat
Avatar for paigeccino paigeccino
43
4.1k
The Language of Interfaces
Avatar for Des Traynor destraynor
162
27k
ReactJS: Keep Simple. Everything can be a component!
Avatar for Pedro Nauck pedronauck
666
130k
技術選定の審美眼（2025年版） / Understanding the Spiral of Technologies 2025 edition
Avatar for Takuto WADA twada
PRO
120
120k
Unsuck your backbone
Avatar for Amy Palamountain ammeep
672
58k
Keith and Marios Guide to Fast Websites
Avatar for Keith Pitt keithpitt
413
23k
jQuery: Nuts, Bolts and Bling
Avatar for Doug Neiner dougneiner
66
8.6k
Sharpening the Axe: The Primacy of Toolmaking
Avatar for Bryan Cantrill bcantrill
46
3k
Lessons Learnt from Crawling 1000+ Websites
Avatar for Charles Meaden charlesmeaden
PRO
1
1.6k
Skip the Path - Find Your Career Trail
Avatar for Mark Kilby mkilby
1
260
Deep Space Network (abreviated)
Avatar for Tony Rice tonyrice
0
370

Transcript

  1. API specifications Lightning talk PHP UserGroup Wellington

  2. Documentation Specification

  3. Documentation for humans Specification

  4. Documentation for humans Specification for devs/machines

  5. Up front planning One source of truth Ecosystem & tools

  6. Popular standards

  7. Swagger/OpenAPI (YAML/JSON) RAML (YAML) API Blueprint (Markdown)

  8. # GET /message + Response 200 (text/plain) Hello World!

  9. Ecosystem & tools

  10. Editors, Linters, Generators, Mock-Servers, Parsers, Renderers, Testing

  11. Laravel Blueprint Docs https://github.com/M165437/lara vel-blueprint-docs

  12. Thank you @m165437 [email protected]