API:Suomi Hackathon qtip.me by Aseem Shakuntal

Presentation given in API:Suomi Hackathon in Helsinki

Transcript

1. APIs,  Developers  and  More   A  human  perspec-ve  to  crea-ng  apps  around  APIs  and  a  use-­‐case  study  of  q-p.me  
3. What  is  API   ì  Informa-on   ì  In  and  Out     Enabling  so?ware  to  talk  
4. Example  (s)   ì  login.api     ì  IN:  username,  password   ì  OUT:  yes/no,  session_key   ì  Facebook  share   ì  TwiJer  share   ì  q-p.me  nearby  offices  
5. What  is  qtip.me  
6. qtip.me:  an  APIs  perspective   ì  Internal  APIs   ì  Client  APIs  (iOS,  Android,  WP)   ì  Member  APIs   ì  Admin  APIs   ì  Customer  APIs   ì  Easy  integra-on  to  customer’s  apps  /  websites   ì  3rd  Party  App  Developer  APIs  
7. Examples  from  qtip.me   ì  getoffices.api   ì  IN:  laUtude,  longitude,  access  key,  …     ì  OUT:  {status:  0,  [{office1},  {office2}…]     ì  getqueues.api   ì  IN:  office_id   ì  OUT:  {status:  0,  [{queue1},  {queue2}…]   ì  take-cket.api   ì  IN:  push_no-fica-on_id,  office_id,  queue_id,  …   ì  OUT:  {status:  0,  -cket_number:  xx,  people_ahead:  yy}  
8. Best  practices   ì  Naming  conven-on   ì  For  APIs   ì  For  parameters   ì  Error  handling  and  troubleshoo-ng   ì  Documenta-on   ì  Simple  examples   ì  Simple  explana-on     ì  Who  reads  full  documenta-on?  
9. Announcement!   ì  hJps://developer.q-p.me   ì  3rd  party  developers  can  register   ì  Create  apps  around  q-p.me  APIs  
10. Questions?   ì  Thank  you!   ì  Aseem[dot]Shakuntal[at]codemenders.com     ì  twiJer:   ì  aseemshakuntal   ì  codemenders   ì  q-p_me   ì  #q-pme,  #apihackfinland