A general overview of the tools available to play and work with RESTful APIs. Featuring Paw, Pawprint, ngrok, Runscope Radar, KONG & Galileo.

1. Intro to dev tools for
RESTful APIs
Micha Mazaheri

3. How to make a REST API?
How to test a REST API?

4. REST
• Back to HTTP roots (RFC 2616)
• Stateless – Each request is an independent transaction
• Resources – Everything is a resource identified by a URI
/{meetup_slug}
/{meetup_slug}/events/{id}
/{meetup_slug}/events/{id}/comments
• CRUD Methods
GET, HEAD, OPTIONS
POST, PUT, PATCH
DELETE

5. Stay RESTful
POST /ParisAPI/events/225897650/
{
"name":"Paris API Rocks"
}
PATCH /ParisAPI/events/225897650/
{
"name":"Paris API Rocks"
}
POST /ParisAPI/events/225897650/set-name
Paris API Rocks

6. Hypermedia
{
"name":"Paris API",
"organizer_id":88226292
}
{
"name":"Paris API",
“organizer":"/ParisAPI/members/88226292/"
}
HATEOAS (Hypermedia as the Engine of Application State)

8. JSON-LD
JSON for Linking Data
http://json-ld.org/

9. JSON Schema
json-schema.org

10. HTTP Clients
Playgrounds for APIs
Paw

11. Pawprint
JSFiddle for APIs

12. Proxy
Runscope
Traffic InspectorCharles HTTP Client RequestBin

13. Local Tunneling
localhost:8080 api.mydomain.com
Secure tunnels to localhost

14. API definition
Think before writing code
Contract for APIs
Make consumers & providers happy together

15. Swagger
• JSON or YAML
• JSON Schema
http://json-schema.org/
• Many integrations
• Most popular (Github stars)

16. Swagger
"paths": {
"/meetups": {
"get": {
"description": "",
"produces": [
"application/json"
],
"parameters": [
{
"name": "tags",
"in": "query",
"description": "Tag your devfloorists",
"required": false,
"type": "array",
"items": {
"type": "string"
}
...

17. Swagger
Swagger UI for documentation

18. Swagger
Swagger Editor for realtime preview

19. RAML

20. API Blueprint

21. API Blueprint
Interactive documentation (Apiary.io SaaS)

22. Monitoring Tools

23. Runscope Radar
• Cloud proxy to debug
Debug staging & prod
• Have assertions & tests

24. KONG & Galileo
• KONG: extension of Nginx
• Galileo: analytics for APIs

25. Oh and…We hire!Bring together API playgrounds & definitions
Encourage best practices
Collaboration platform
and cool customers already…
Stay Tuned

26. Oh and…We hire rockstars!
• React or OS X genius
• Passion for interfaces &
beautiful code
• Startup gal or guy (or cat?)

27. http.cat
https://http.cat

28. Thanks!
Micha Mazaheri
@mittsh
Paw
http://paw.rest
@luckymarmot

29. Questions?
Micha Mazaheri
@mittsh
Paw
http://paw.rest
@luckymarmot

30. 50% off
PARISAPI
Paw
http://paw.rest
@luckymarmot