How to Design a REST API That Doesn’t SUCK| Issue #10


Hi there,

Want to improve your REST API design? Then this week’s video is for you! 🌟

I’ll share 6 easy tips for creating user-friendly, consistent, and easily integrated REST APIs.

We’ll dive into often-overlooked aspects of REST API design, including:

  • Following standards like OpenAPI specs and OAuth for authentication 🛠️
  • Ensuring consistency in formats and naming conventions 📏
  • Keeping things simple with sensible defaults, and much more! ✨

Even big companies sometimes miss these crucial details, making their APIs harder to use. 😅

Stick around until the end for BONUS tips! 🎁

Enjoy the video and happy coding! 🚀

Cheers,

Arjan

video preview

# News

Secure Python Projects

This week, learn how to securely manage configurations and sensitive information using environment variables and dotfiles.

Protect your API keys, manage database connections, and centralize configurations effortlessly. Click here to read the blog and enhance your workflow. 🔗

Understanding Code Coverage 🧑‍💻

Marcus Buffett recently published an insightful blog post exploring the nuanced role of abstractions in programming. 🖥️

He breaks down how abstractions can make code safer and more flexible, but also warns about potential downsides like fragility and complexity.

This article is a must-read for developers looking to master the balance between abstraction and practical coding. Click here to find out more. 🛠️

# Community

Curious about the pros and cons of type hinting and static typing? 💭

Our community recently had an engaging discussion on this topic, exploring insights from industry experts and sharing personal experiences. The conversation covers how type hints can improve code clarity, support from IDEs, and reduce the need for extensive documentation. There’s also a lively debate on whether type annotations adhere to the DRY (Don’t Repeat Yourself) principle or add unnecessary redundancy.

Dive into the full discussion and enhance your understanding of type hinting! Read the full thread here. 📚


Do you enjoy my content on YouTube and would you like to dive in deeper? Check out my online courses below. They've helped thousands of developers take the next step in their careers.

🚀 The Mindset Online Course Series

The goal of this series is to help junior developers grow their skills to become senior developers faster.

💥 Other Courses

💡 If you’re part of a development team at a company, I offer special packages for companies that give your team the tools to consistently write high-quality code and dramatically increase your team's productivity.

🪄 Learntail

My team and I created an AI quiz generator designed to accelerate your learning, called Learntail. You can try it for free or unlock even more capabilities and features with the monthly subscription. Take a look here.

Unsubscribe | Send by ArjanCodes

Wolvenplein 25, Utrecht, UT 3512 CK

The Friday Loop

Every Friday, you'll get a recap of the most important and exciting Python and coding news. The Friday Loop also keeps everyone posted on new ArjanCodes courses and any limited offers coming up.

Read more from The Friday Loop

Hi there, You’ve probably noticed this by now: LLM prototypes are easy to build. But as soon as you try to turn them into actual production LLM systems… a lot more goes into it. In this week’s video, I walk through how to structure AI agents in Python using design patterns like Chain of Responsibility, Observer, and Strategy. I’ll build a fully functional travel assistant using Pydantic AI and explore how to make your agent pipelines more maintainable, testable, and modular. Hope you enjoy...

Hi there, I have to admit, I often forget how powerful the Python standard library is. Whenever I'm working on some project, I have to remind myself to consider whether something I need is already there, ready for me to use. So, in this week’s video, I’m looking at 10 of the most useful and underrated modules in Python’s standard library, including pathlib, heapq, graphlib, and more. These tools can help you write cleaner, faster, and more maintainable code without adding a single dependency....

Hi there, If you’ve been experimenting with trying to integrate AI into your code, you’ve probably run into the same problem I have: unstructured, unpredictable output. And the other way around: how do you let AI agents interact with your own code? That’s where Pydantic AI comes in. In this week's video, I show how to use Pydantic AI to embed an LLM agent directly into your Python app: with structured input, validated output, and access to real business logic. What I love about this approach...