HATEOAS corpus (Friends)

The Changelog: Software Development, Open Source

Jerod is back with another “It Depends” episode! This time he’s joined by Kris Brandow from Go Time and they’re talking all things API design. What makes a good API? Is GraphQL a solid choice? Why do we do REST wrong? And WTF does HATEOAS mean, anyway?

Join the discussion

Changelog++ members save 10 minutes on this episode because they made the ads disappear. Join today!

Sponsors:

• Neon – The fully managed serverless Postgres with a generous free tier. We separate storage and compute to offer autoscaling, branching, and bottomless storage.
• Sentry – Get $100 towards your error monitoring with Sentry! Use the code changelog.
• Fastly – Our bandwidth partner. Fastly powers fast, secure, and scalable digital experiences. Move beyond your content delivery network to their powerful edge cloud platform. Learn more at fastly.com
• Fly.io – The home of Changelog.com — Deploy your apps and databases close to your users. In minutes you can run your Ruby, Go, Node, Deno, Python, or Elixir app (and databases!) all over the world. No ops required. Learn more at fly.io/changelog and check out the speedrun in their docs.

Featuring:

• Jerod Santo – GitHub, LinkedIn, Mastodon, X
• Kris Brandow – GitHub, X

Show Notes:

• PHP: a fractal of bad design
• PostGraphile Instant GraphQL API
• HATEOAS
  The Tech Behind the New Grooveshark
• OpenAPI Spec
• HTTP Specifications
• Roy Fielding Dissertation on REST
• Mike Amundsen

Something missing or broken? PRs welcome!

Chương

1. Let's talk! (00:00:00)

2. Kris Depends (00:00:38)

3. Today's topic: APIs (00:03:59)

4. Programming level APIs (00:06:48)

5. What makes an API good? (00:09:14)

6. Pass in a [hash|map|dict|struct] (00:11:41)

7. It's all context (00:14:11)

8. Actually being diligent (00:16:44)

9. Guessability (00:17:38)

10. PHP: a fractal of bad design (00:20:17)

https://eev.ee/blog/2012/04/09/php-a-fractal-of-bad-design/

11. What a good language looks like (00:22:18)

12. Types are annoying (00:23:38)

13. Sponsor: Neon (00:27:20)

https://neon.tech

14. Web service APIs (00:32:40)

15. Never GraphQL? (00:34:30)

16. GraphQL's appeal (00:40:12)

17. Hypermedia APIs (00:42:02)

18. What is HATEOAS? (00:43:10)

19. The idea behind REST APIs (00:44:50)

20. Restful APIs are not REST (00:47:21)

21. Why we don't write hypermedia APIs (00:48:04)

22. Sponsor: Sentry (00:51:27)

https://sentry.io/welcome/?utm_source=changelog&utm_medium=paid-community&utm_content=site&utm_campaign=changelog2023&code=changelog

23. Jerod's Grooveshark story (00:55:39)

24. Straying from REST (00:59:28)

25. API vs web URLs (01:03:35)

26. Hypermedia APIs in the wild (01:05:25)

27. GraphQL: the good parts (01:07:27)

28. How do we move forward? (01:12:39)

29. The answer: LLMs (01:13:31)

30. Ready to adopt! (01:16:02)

31. The web is REST (01:17:20)

32. Where are the HATEOAS folks? (01:19:44)

33. An It Depends Hypothetical (01:23:38)

34. Kris' elevator pitch (01:27:14)

35. HTTP is more ABI than API (01:29:51)

36. There's a lot to HTTP! (01:34:41)

37. Best learning resources (01:37:29)

38. Bye friends! (01:40:56)

39. Coming up next (01:42:43)

https://jerodsanto.net/2010/12/the-tech-behind-the-new-grooveshark/