Essential REST Tools

Tools you need to build better REST APIs,

more quickly and with more fun.

 
 
Watch the course

Design

Collaborative Design Tools

Integrate early and often - use a centralized design tool to document your API and encourage collaboration.

Apiary

  •  API Documentation
  •  Stub API endpoint
  •  Open markdown format
  •  Easy for whole team to use
  •  Doesn't model failure paths

- or -

RAML

  •  API Documentation
  •  Stub API endpoint
  •  Open markdown format
  •  More formal markdown
  •  Steeper learning curve
 

Testing

Black box API testing

REST APIs are easy to test. Do entry-point testing with dedicated REST or HTTP clients.

Postman

  •  REST client Chrome extension
  •  Save and share collections
  •  Execute API calls easily
  •  Supports full HTTP stack
  •  Requires Chrome

- or -

CURL

  •  HTTP command line tool
  •  Detailed output
  •  Easy to integrate
  •  Custom HTTP stack
  •  No client cache
 

Debugging

See what's happening under the hood

Diagnose problems by inspecting traffic with HTTP debuggers and packet sniffers.

Burp

  •  Cross-platform HTTP debugger
  •  Proxy to intercept & modify
  •  Spider to crawl links
  •  Security attack testing
  •  Unfriendly UI

- or -

Wireshark

  •  Cross-platform packet sniffer
  •  Record network traffic
  •  Verify SSL & GZIP
  •  Can decrypt SSL
  •  Only occassionally needed
 

HTTP

The protocol that powers REST APIs

HTTP has features which support massive scale, fault tolerance and high performance. Maximise the use of them in your API.

Caching

  •  Improve performance
  •  Reduce client bandwidth
  •  Reduce server requests
  •  Risk stale data

DNS

  •  Segregate traffic
  •  High Availability
  •  Disaster Recovery
  •  Management overhead

SSL

  •  Secure traffic
  •  Protect user data
  •  Some performance cost
  •  Certificate admin
 
Expiration and Validation Caching
DNS CNAMEs
SSL Traffic

Load Testing

Know how your API performs

Do load, soak and stress testing to understand your API's performance profile. Cloud-based tools can fire huge numbers of concurrent client requests and make it easy.

loader

  •  Simple UI
  •  Up to 100K requests
  •  Management API
  •  Free tier
  •  Limited analytics

- or -

Blitz

  •  Fancy UI
  •  Multiple client regions
  •  Platform SDKs
  •  Detailed reporting
  •  No free tier
 

Monitoring

Know the health of your API

Instrument your API and capture the results centrally, for easy and powerful analysis and diagnostics.

loggly

  •  Cross platform
  •  Logging framework integration
  •  Rich filter and search
  •  Cost of sending remote entries

- and -

NewRelic

  •  Seamless app integration
  •  OS and platform monitoring
  •  Detailed stats capture
  •  Cost of recording stats
 

Watch the Course

See the tools in action

This website accompanies the Pluralsight course Five Essential Tools for Building REST APIs, by Elton Stoneman.

What's in the course

  •  A walkthrough of the five essential REST tools
  •  Cross-platform, use with Node, ASP.NET, Ruby etc.
  •  See where the tools fit in the delivery process
  •  Exploration of alternative tools

 

Very impressed - an excellent course all round. Lots of very interesting information, beautifully presented and clearly taught

- Pluralsight peer review