Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
@windley
The University API
Phillip J. Windley, Ph.D.
Brigham Young University
http://www.windley.com
@windley
@windley
@windley 4
Software is Eating the World!
More and more major businesses and
industries are being run on software and
deliv...
@windley
@windley
@windley
{“answer”: “University API”}
@windley
@windley
Googlehttp:/ / facebook.com
Web Page Title
1.Lorem ipsum dolor sit amet consectateur
nonummy lorenzino.
2.Interdu...
@windley
Googlehttp:/ / facebook.com
Web Page Title
1.Lorem ipsum dolor sit amet consectateur
nonummy lorenzino.
2.Interdu...
@windley
API
Googlehttp:/ / facebook.com
Web Page Title
1.Lorem ipsum dolor sit amet consectateur
nonummy lorenzino.
2.Int...
@windley
@windley
@windley
@windley
@windley 16
Bake your business model
into your API
- John Musser
Founder, Programmable Web
“
”
Principle #1: Design Busine...
@windley
@windley
/students
/instructors
/courses
/classes
/locations
/programs
/colleges
/departments
@windley
@windley
Principle #2: Ensure interfaces are open,
extensible, and published
@windley
GET /students
GET /students?major=CS
GET /students/:id
GET /students/:id?fieldset=transcripts
@windley
POST /students
{id: ...
first_name: ...
last_name: ...
...
}
@windley
@windley
Principle #3:
Support student and faculty choice.
@windley
@windley
@windley
Principle #4: Access Control Happens at the API
@windley
User
Policy
Administrator
PEP
PDP
PAP
Enforce
Policy Enforcement Point
Decide
Policy Decision Point
Manage
Policy...
@windley
@windley
@windley
Authorization
Server
Owner
Client
5. code
TOKEN
4. code
2. redirect
1. use
3. authorize
6.
data
request
TOKEN
Res...
@windley
@windley
Principle #5:
Keep workflow
below the API
@windley
@windley
@windley
HATEOAS
Hypertext as the Engine of Application State
@windley
An ever expanding range of
computing platforms are needed
to reach students
@windleySource: Morgan Stanley Mobile Internet Report (12/09)
@windley
Hundreds, even thousands of developers
who don’t work for you
must be convinced
to adapt your product
to the dyna...
@windley
@windley
@windley
Principle #7: Cloud First
@windley
@windley
Principle #8:
Security is Too Important to Not Outsource
@windley
@windley
@windley
Principle #9: Focus on What’s Core
@windley
@windley
Principle #10: APIs First
@windley
API Client
API Manager / ESB / etc.
Service Composition
Throttling
Attribute Based Access Control
Authentication
...
@windley
@windley
Principle #11:
Start Where You Are
@windley
@windley
Principles for Starting an API Initiative
1. Design business-oriented APIs
2. Ensure interfaces are open, extensi...
@windley
Resources
• Mashup Corporations’
• The Phoenix Project
• Implementing Domain Driven Design
• Kin Lane on Universi...
@windley
Join us on this journey
• @UniversityAPI
• University API Workshops
• Utah, Feb 28-Mar 1, 2017 (http://bit.ly/UAP...
@windley
The University API
Phillip J. Windley, Ph.D.
Brigham Young University
http://www.windley.com
@windley
Other issues
• Other university APIs: services like lockers, vending machines, health,
payments, HR, calendars, a...
A University API
Upcoming SlideShare
Loading in …5
×

A University API

378 views

Published on

Provides 11 principles for designing, deploying, and promoting a University API at your university.

Published in: Education
  • Be the first to comment

  • Be the first to like this

A University API

  1. 1. @windley The University API Phillip J. Windley, Ph.D. Brigham Young University http://www.windley.com
  2. 2. @windley
  3. 3. @windley
  4. 4. @windley 4 Software is Eating the World! More and more major businesses and industries are being run on software and delivered as online services—from movies to agriculture to national defense. Many of the winners are Silicon Valley-style entrepreneurial technology companies that are invading and overturning established industry structures. Over the next 10 years, I expect many more industries to be disrupted by software, with new world-beating Silicon Valley companies doing the disruption in more cases than not. - Marc Andreessen “ ”
  5. 5. @windley
  6. 6. @windley
  7. 7. @windley {“answer”: “University API”}
  8. 8. @windley
  9. 9. @windley Googlehttp:/ / facebook.com Web Page Title 1.Lorem ipsum dolor sit amet consectateur nonummy lorenzino. 2.Interdum volgus videt, est ubi peccat. 3.Si veteres ita miratur laudatque poetas 4.Ut nihil anteferat, nihil illis comparet, errat. 5.Si quaedam nimis antique • Alpha • Bravo • Charlie • Delta • Echo • Foxtrot • Golf • Hotel • India • Juliet • Kilo • Lima • Mike • November • Oscar • Papa • Quebec • Romeo • Sierra • Tango • Uniform • Victor • Whiskey • X-Ray • Yankee • Zulu
  10. 10. @windley Googlehttp:/ / facebook.com Web Page Title 1.Lorem ipsum dolor sit amet consectateur nonummy lorenzino. 2.Interdum volgus videt, est ubi peccat. 3.Si veteres ita miratur laudatque poetas 4.Ut nihil anteferat, nihil illis comparet, errat. 5.Si quaedam nimis antique • Alpha • Bravo • Charlie • Delta • Echo • Foxtrot • Golf • Hotel • India • Juliet • Kilo • Lima • Mike • November • Oscar • Papa • Quebec • Romeo • Sierra • Tango • Uniform • Victor • Whiskey • X-Ray • Yankee • Zulu Carrier 12:00 PM 1. Lorem ipsum dolor sit amet consectateur nonummy lorenzino. 2. Interdum volgus videt, est ubi peccat. 3. Si veteres ita miratur laudatque poetas 4. Ut nihil anteferat, nihil illis comparet, errat. 5. Si quaedam nimis antique API
  11. 11. @windley API Googlehttp:/ / facebook.com Web Page Title 1.Lorem ipsum dolor sit amet consectateur nonummy lorenzino. 2.Interdum volgus videt, est ubi peccat. 3.Si veteres ita miratur laudatque poetas 4.Ut nihil anteferat, nihil illis comparet, errat. 5.Si quaedam nimis antique • Alpha • Bravo • Charlie • Delta • Echo • Foxtrot • Golf • Hotel • India • Juliet • Kilo • Lima • Mike • November • Oscar • Papa • Quebec • Romeo • Sierra • Tango • Uniform • Victor • Whiskey • X-Ray • Yankee • Zulu Carrier 12:00 PM 1. Lorem ipsum dolor sit amet consectateur nonummy lorenzino. 2. Interdum volgus videt, est ubi peccat. 3. Si veteres ita miratur laudatque poetas 4. Ut nihil anteferat, nihil illis comparet, errat. 5. Si quaedam nimis antique API Carrier 12:00 PM 1. Lorem ipsum dolor sit amet consectateur nonummy lorenzino. 2. Interdum volgus videt, est ubi peccat. 3. Si veteres ita miratur laudatque poetas 4. Ut nihil anteferat, nihil illis comparet, errat. 5. Si quaedam nimis antique
  12. 12. @windley
  13. 13. @windley
  14. 14. @windley
  15. 15. @windley
  16. 16. @windley 16 Bake your business model into your API - John Musser Founder, Programmable Web “ ” Principle #1: Design Business-Oriented APIs
  17. 17. @windley
  18. 18. @windley /students /instructors /courses /classes /locations /programs /colleges /departments
  19. 19. @windley
  20. 20. @windley Principle #2: Ensure interfaces are open, extensible, and published
  21. 21. @windley GET /students GET /students?major=CS GET /students/:id GET /students/:id?fieldset=transcripts
  22. 22. @windley POST /students {id: ... first_name: ... last_name: ... ... }
  23. 23. @windley
  24. 24. @windley Principle #3: Support student and faculty choice.
  25. 25. @windley
  26. 26. @windley
  27. 27. @windley Principle #4: Access Control Happens at the API
  28. 28. @windley User Policy Administrator PEP PDP PAP Enforce Policy Enforcement Point Decide Policy Decision Point Manage Policy Administration Point
  29. 29. @windley
  30. 30. @windley
  31. 31. @windley Authorization Server Owner Client 5. code TOKEN 4. code 2. redirect 1. use 3. authorize 6. data request TOKEN Resource Server Client
  32. 32. @windley
  33. 33. @windley Principle #5: Keep workflow below the API
  34. 34. @windley
  35. 35. @windley
  36. 36. @windley HATEOAS Hypertext as the Engine of Application State
  37. 37. @windley An ever expanding range of computing platforms are needed to reach students
  38. 38. @windleySource: Morgan Stanley Mobile Internet Report (12/09)
  39. 39. @windley Hundreds, even thousands of developers who don’t work for you must be convinced to adapt your product to the dynamic environment of various apps
  40. 40. @windley
  41. 41. @windley
  42. 42. @windley Principle #7: Cloud First
  43. 43. @windley
  44. 44. @windley Principle #8: Security is Too Important to Not Outsource
  45. 45. @windley
  46. 46. @windley
  47. 47. @windley Principle #9: Focus on What’s Core
  48. 48. @windley
  49. 49. @windley Principle #10: APIs First
  50. 50. @windley API Client API Manager / ESB / etc. Service Composition Throttling Attribute Based Access Control Authentication Authorization Address Abstraction Monitoring Policy Enforcement Data Transformation Protocol Transformation CFramework PeopleSoft Alfresco BusinessObjects ServiceNow CustomServices Java,PHP,etc. OtherCampusContributors (Library,Bookstore,etc) Domain APIs SOAP XML RPC SOAPSOAPXML RPC REST REST Domains University API (REST)
  51. 51. @windley
  52. 52. @windley Principle #11: Start Where You Are
  53. 53. @windley
  54. 54. @windley Principles for Starting an API Initiative 1. Design business-oriented APIs 2. Ensure interfaces are open, extensible, and published 3. Support student and faculty choice. 4. Control access at the API 5. Keep workflow below the API 6. Make developers the customer 7. Be cloud first 8. Security is too important to not outsource 9. Focus on what’s core 10. Buy and build API first 11. Start where you are
  55. 55. @windley Resources • Mashup Corporations’ • The Phoenix Project • Implementing Domain Driven Design • Kin Lane on University APIs • windley.com
  56. 56. @windley Join us on this journey • @UniversityAPI • University API Workshops • Utah, Feb 28-Mar 1, 2017 (http://bit.ly/UAPI2017) • Chicago Summer 2017
  57. 57. @windley The University API Phillip J. Windley, Ph.D. Brigham Young University http://www.windley.com
  58. 58. @windley Other issues • Other university APIs: services like lockers, vending machines, health, payments, HR, calendars, assets, library, collections

×