Skip to content

Api design

API Design: Basics to Best Practices

A comprehensive guide to building scalable and maintainable APIs. It covers fundamental architectural principles and provides a roadmap for transitioning from basic implementation to professional-grade service design.

  • Design Philosophy: Focus on simplicity, consistency, and resource-oriented modeling (REST).
  • Core Standards: Proper utilization of HTTP methods (GET, POST, PUT, DELETE) and status codes.
  • Operational Essentials: Strategies for versioning, pagination, filtering, and caching (e.g., Redis).
  • Security & Reliability: Implementation of JWT-based authentication, structured error handling, and comprehensive logging.

Microservice API Patterns

A comprehensive pattern language for the design, specification, and evolution of APIs in microservice architectures. It provides a structured vocabulary for solving recurring problems in distributed system communication and API contract management.

  • Design Patterns: Detailed solutions for endpoint roles, data representation, and client-side interactions.
  • API Evolution: Proven strategies for versioning and managing breaking changes in a microservices ecosystem.
  • Quality Attributes: Patterns focused on improving the performance, security, and maintainability of service interfaces.
  • Vocabulary: Establishes a standard language for architects and developers to discuss API design decisions.

Key Data Engineering File Formats

A reference guide to the most common storage formats used in data pipelines, categorized by their structural strengths and use cases.

  • Text-Based (Interoperability): * CSV: Simple tabular data for basic exchange.
  • JSON: Semi-structured data, ideal for APIs and configurations.

  • XML: Hierarchical markup for specialized data interchange.

  • Columnar (Analytics & Big Data):

  • Parquet: Optimized for efficient I/O and compression in Spark/Hadoop.

  • ORC: Highly efficient storage specifically for Hive workloads.

  • Serialization (Distributed Systems):

  • Avro: Binary format supporting schema evolution; standard for Kafka.
  • Thrift: Cross-language serialization for microservices communication.

The Valley of Code

A comprehensive, handwritten library of over 1,600 lessons covering the full spectrum of software development. It is designed as a progressive journey, starting from web fundamentals and moving into specialized backend and systems programming.

  • Web Development: Deep dives into HTML5, CSS3, and Modern JavaScript, including advanced frameworks like React, Next.js, and Astro.
  • Backend & Languages: Specialized tracks for Go, Python, C, PHP/Laravel, and Node.js.
  • Systems & Tools: Practical guides on Linux, Docker, Git/GitHub, and macOS power-user workflows.
  • Networking & Databases: Fundamentals of HTTP/TCP, REST APIs, GraphQL, and database management (PostgreSQL, SQLite, Firebase).
  • Project-Based Learning: Lessons focus on building real-world tools, from CLI applications to full-stack deployments on platforms like Vercel and Fly.io.

Build Your Own X

A curated list of step-by-step tutorials for building your own technology from scratch. It is designed to help developers understand the inner workings of the tools they use every day through practical implementation.

  • Systems Programming: Learn to build your own Operating System, Docker, or Git.
  • Language Internals: Guides on creating Compilers, Interpreters, and Virtual Machines.
  • Databases: Tutorials for building a Key-Value Store, Relational Database, or Search Engine.
  • Networking: Build your own HTTP Server, Network Stack, or BitTorrent Client.
  • Graphics: Step-by-step implementation of Ray Tracers and Game Engines.