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

Running a Public API Do's and Don'ts

Running a Public API Do's and Don'ts

Sibiu Web Meetup

October 18, 2019
Tweet

More Decks by Sibiu Web Meetup

Other Decks in Programming

Transcript

  1. Running a Public API Running a Public API Do's and

    Don'ts Do's and Don'ts Sibiu Web Meetup #7 - Oct 18, 2019 Jakob Cosoroabă
  2. Jakob Jakob Cosoroabă Cosoroabă Full Stack Developer Product Developer VP

    of "git blame" Tsar of "wait what?" the smarter platform for legal intelligence
  3. What this talk is NOT about What this talk is

    NOT about SOAP vs REST vs GraphQL JSON vs XML vs GRPC JsonAPI vs WDSL
  4. What is a public API What is a public API

    used by 3rd parties public documentation
  5. Avoid NIHS Avoid NIHS Not Invented Here Syndrome Not Invented

    Here Syndrome use api gateways/proxy instead of coding yourself all the basic stuff
  6. free thinking free thinking API endpoints don't have to follow

    API endpoints don't have to follow internal structure internal structure
  7. do not use a browser do not use a browser

    for testing too much for testing too much magic magic ♂ ♂ ♂ ♂ ♂ ♂ https://www.ietf.org/rfc/rfc3986.txt
  8. Our API Business hours are from 9 - 12, Our

    API Business hours are from 9 - 12, 13-17 Monday to Friday except Public 13-17 Monday to Friday except Public holidays holidays
  9. API Testing API Testing curl insomnia postman API Proxy API

    Proxy Kong Tyk.io Express Gateway AWS/Azure Gateway
  10. API Definitions API Definitions RAML API Blueprint (apiary) OpenAPI Specification

    API Starter Kits API Starter Kits Node Laravel Rails https://github.com/feredean/node-api-starter https://github.com/joselfonseca/laravel-api https://guides.rubyonrails.org/api_app.html