---
title: "Discussion on \"REST API Design Best Practices\" | Hashnode"
description: "Discussion on \"REST API Design Best Practices\". Core Principles\n\nDesign APIs that are:\n\nEasy to read and work with\n\nHard to misuse\n\nComplete and concise\n\n\n\n\nNaming and URL Structure\nResource Naming\n\nUse nouns to represent resources, not verbs\n\nGood: /items, /employees\n\nBad: /createItems, /getEmplo..."
url: "https://hashnode.com/posts/rest-api-design-best-practices/6781128c75418dcaadd69096"
---

[Feed](https://hashnode.com/feed) /

Discussion

# [REST API Design Best Practices](https://tigerabrodi.blog/rest-api-design-best-practices?utm_source=hashnode&utm_medium=feed)

Core Principles Design APIs that are: Easy to read and work with Hard to misuse Complete and concise Naming and URL Structure Resource Naming Use nouns to represent resources, not verbs Good: /items, /employees Bad: /createItems, /getEmplo...

Jan 10, 2025 · 4 min read · tigerabrodi.blog  
Read the article

-   [#web-development](https://hashnode.com/tag/web-development)
-   [#webdev](https://hashnode.com/tag/webdev)
-   [#backend](https://hashnode.com/tag/backend)
-   [#apis](https://hashnode.com/tag/apis)

## Written by

[Tiger Abrodi](https://hashnode.com/@tigerabrodi)

@tigerabrodi · Germany

  
[View profile](https://hashnode.com/@tigerabrodi)

Obsessed with crafting software.

Just a guy who loves to write code and watch anime.

## Responses 3

Markdown supported · ⌘↵ to post

[Oliver Ramstedt](https://hashnode.com/@oliverramstedt)

[Feb 7, 2025](https://hashnode.com/posts/rest-api-design-best-practices/6781128c75418dcaadd69096/comment/67a5c128d0fb02f75abf9133)

Great read! I'll have all new REST API devs read this before letting them loose haha.

One change i would make though is regarding documentation. As this is a 'best practice' guide i would not suggest OpenAPI specifically as there are many ways to document API's. I think the important lesson is to just document the endpoint in a way that makes sense in the dev environment.

[Stephen metriqe](https://hashnode.com/@stv-thevar)

[Feb 6, 2025](https://hashnode.com/posts/rest-api-design-best-practices/6781128c75418dcaadd69096/comment/67a4782904616a9863fd9a40)

Nice

[Mary](https://hashnode.com/@dev08)

[Jan 28, 2025](https://hashnode.com/posts/rest-api-design-best-practices/6781128c75418dcaadd69096/comment/6798cc19e19ac6b80f3286c6)

It's useful. Thanks!