Everything you need to know about REST to get real work done. No gatekeeping. No jargon. Mercifully short.
I can't finish a single REST tutorial without wanting to flip a desk!
You don't need to become the world's leading expert on HTTP, you just need to learn how to make APIs that other developers will understand. But every time you try, the tutorials make you feel like you're not smart enough to work as a developer. They make you feel like a fraud! They might as well be written in a language from half way around the world. And worst of all, some people will put you down and ignore your questions simply for having the nerve to ask them.
You are not a fraud, you're just using bad tutorials.
First you were scared to learn REST because it seemed like there was SO MUCH to learn. What is an RFC, anyway? Who is Roy Fielding, and why does that matter? What's a mime type? What am I going to have to know before this will make sense?
But everyone says REST is simple, so you set your fear aside and face the challenge.
You start one tutorial, and another, and another, but the unexplained jargon is enough to drive even Mr. Rogers into a sweater-ripping, trolley-kicking, shoe-throwing rage! They start talking about nouns and verbs and you're left wondering what 3rd grade reading class has to do with making APIs.
Either you gave up completely, or you gave up trying to learn the academics and best practices and did the best you could by feeling around in the dark. That experience could be helpful in deciphering one of those tutorials you hated, but do you really want to go back to that dark place?
There has to be a better way.
And there is.
My short ebook skips the academic "you have to learn every detail!" approach and teaches the vocabulary in simple terms. Learn only what you need to know to make functional, secure REST APIs. And best of all, you can learn it all in just a couple of hours.
- Master the vocabulary with simple explanations.
- Get to work today: Fundamentals first, clearly, and succinctly.
- Everything you need to know about securing APIs.
- Packed with best practices learned from more than a decade of experience.
- It's mercifully short! Just because it's a book doesn't mean it should take a week to read.
Having decided to read the first chapter now, just to see what I'm getting myself into, I read the whole thing. I absolutely could not put this book down. It's refreshing to see a book focusing on pragmatism over dogma.
Will this book finally make it click?
When something is supposed to be simple, but the explanation doesn't make sense, it's incredibly frustrating! You wonder, "Is the tutorial to blame, or am I?" Everyone feels this way sometimes, but it's not your fault. It's definitely the tutorial!
Explaining things well is hard, especially after you're good at them! It's called the Curse of Knowledge: Once you master a topic, your brain packages up the concepts and allows you to think in abstractions. When you later try to explain those concepts it's hard to see that you're using an abstraction, because your brain automatically unpacks it for you without you ever noticing it was there. This is what makes so many tutorials —for everything— so infuriating!
When you feel like a paragraph was accidentally deleted from a tutorial, that's the curse of knowledge showing its ugly face. There is something missing and the author is either unaware, or worse, unwilling to add it.
If you hit a moment like that in my book then I have failed at its one mission. Tell me about your frustration with my explanation of a concept (just reply to the confirmation email!), and I will work with you to improve it and publish an update. If I can't do that then I will refund your money.
I've been selling this book since 2014, and nobody has ever asked me for a refund.
A very straightforward explanation of all things REST that was easy to understand and more than once had me chuckling. It's a well thought out quick read with great examples from a true industry professional.
Learn REST without flipping any desks
REST Assured teaches you:
- You're already doing some REST, you just didn't know it.
- The fundamentals, explained simply.
- Security: Basic Auth, SSL, API keys, OAuth, JWT, CORS, and JSONP.
- Best practices for functional, clean, secure, and standards-compliant APIs. Too many to list here!
In addition to teaching you what makes an API RESTful, I'll also teach you why we do things the way we do them. Spoiler alert: the answer is almost always "don't reinvent the wheel."
And just in case you want a deep dive too, there are two appendices to satisfy your curiosity: One with the history of REST, and one that explains raw REST HTTP requests and responses in great detail.
I frequently used to ask, "How is REST any better? I just don't understand." Adam answers that question in a very clear and concise manner, with the right amount of humor to keep it interesting. Anyone who builds APIs, or will, needs this book on their shelf.
Finally! REST for the rest of us! Adam has produced a straight-forward, concise, and pragmatic explanation of one of those concepts that everybody thinks they know, but very few take the time to really understand. He takes the concepts from "perfect world" academic REST to, "How do I make that work with the %^[email protected]! mess that is my data source?"
If you were standing in a bookstore and you had spent this much time looking at a book, by now you would have looked at the table of contents to decide whether or not this book might be useful to you. So here's the table of contents.
Chapter 1: What is REST, Anyway? (And why is it so popular?)
Chapter 2: TL;DR: Don't Reinvent the Wheel
Chapter 3: Security (Basic Auth, API Keys, OAuth, JWT, CORS, JSONP)
Chapter 4: Best Practices
Chapter 5: HATEOAS (Spoiler alert: I don't love it)
Chapter 6: Concrete Examples with Taffy
Appendix 1: Common HTTP Statuses
Appendix 2: Some History, If You Want It - A brief history of REST
Appendix 3: Close to the Metal Inspecting raw HTTP requests and responses
You May Be Wondering...
What kind of files will I get?
MOBI, EPUB, and PDF. That means you can read it just about anywhere. You can read it on your Kindle or other eReader, your computer, your iPad or phone.
Does it have any DRM?
Nope. I believe that DRM is the wrong solution to the problem of piracy, and I have released this book without any form of protection other than this reminder that if you share this file you are taking money out of my pocket, which is a jerk move.
Does the eBook get updates?
Updates are sent by email, free of charge, when I publish them. The book is currently at version 2.0.
Is there a print edition?
Yup! You can order a paperback right here.
Hi! I'm @AdamTuttle, engineer and CTO at AlumnIQ. I've been teaching and mentoring for more than 20 years. I share what I've learned on my blog, I present at and have helped organize conferences, and contribute to training courses and magazines, and appeared on podcasts — almost always to talk about REST.
I created Taffy, the most popular REST framework for CFML, back when CFML was still significantly relevant, and it continues to be popular in the CFML community today. While working on and supporting it, I learned a lot about teaching the how and the why of REST, and I created this book to compile all of that knowledge in one place.
Copyright © 2015-2020 Adam Tuttle — All Rights Reserved