--- title: How to design better APIs | daily.dev description: When creating an API from scratch, you need to get many details right. From basic security considerations to using the right HTTP methods, implementing... canonical: https://daily.dev/posts/how-to-design-better-apis-ft5u2bjel twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: How to design better APIs | daily.dev og:description: When creating an API from scratch, you need to get many details right. From basic security considerations to using the right HTTP methods, implementing... og:url: https://daily.dev/posts/how-to-design-better-apis-ft5u2bjel og:image: https://api.daily.dev/og/posts/Ft5u2BJEl.png og:image:alt: How to design better APIs og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # How to design better APIs **[Hashnode](https://daily.dev/sources/hashnode)** · [@rbluethl](https://daily.dev/rbluethl) · 6 min read · 149 upvotes · 13 comments ## Summary When creating an API from scratch, you need to get many details right. From basic security considerations to using the right HTTP methods, implementing authentication, deciding which requests and responses you should accept and return, ... the list goes on. In this post, I'm trying my best to compress everything I know about what makes a good API. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Community discussion Top comments from developers on daily.dev. **@yashbhatti** · 1 upvotes > So... good content !! > > really so nice **@mrgrigri** · 1 upvotes > Very good blog post and very well written. **@carlos\_almeida** · 1 upvotes > Very good article, thank you! **@chrislegaxy** · 1 upvotes > Informative 🙌 **@soumava** · 1 upvotes > This is > great ## Similar posts on daily.dev - [Don’t just attend KubeCon \+ CloudNativeCon, Merge Forward your experience\!](https://daily.dev/posts/don-t-just-attend-kubecon-cloudnativecon-merge-forward-your-experience--l0rpp73x8) · CNCF · 1 upvotes · 0 comments - [Announcing H2 2026 KCDs](https://daily.dev/posts/announcing-h2-2026-kcds-m96goajm1) · CNCF · 1 upvotes · 0 comments - [Two months of Open Community Groups](https://daily.dev/posts/two-months-of-open-community-groups-asf52zhbs) · CNCF · 0 upvotes · 0 comments - [CNCF Unveils Schedule for KubeCon \+ CloudNativeCon Europe 2026](https://daily.dev/posts/cncf-unveils-schedule-for-kubecon-cloudnativecon-europe-2026-ikhcoa5cb) · CNCF · 2 upvotes · 0 comments - [CNCF Debuts KubeCon \+ CloudNativeCon Japan 2026 Schedule](https://daily.dev/posts/cncf-debuts-kubecon-cloudnativecon-japan-2026-schedule-xp5pyudub) · CNCF · 1 upvotes · 0 comments --- [View this post on daily.dev](https://daily.dev/posts/how-to-design-better-apis-ft5u2bjel) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"How to design better APIs","url":"https://daily.dev/posts/how-to-design-better-apis-ft5u2bjel","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/how-to-design-better-apis-ft5u2bjel"},"datePublished":"2022-03-07T02:57:38.997Z","dateModified":"2022-03-20T13:38:00.074Z","description":"When creating an API from scratch, you need to get many details right. From basic security considerations to using the right HTTP methods, implementing...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/91c9e1f9c2cea9b9c1c373eb7cf40fcf","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/91c9e1f9c2cea9b9c1c373eb7cf40fcf","isAccessibleForFree":true,"articleSection":"Hashnode","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Person","name":"Ronald Blüthl","url":"https://daily.dev/rbluethl","image":"https://avatars.githubusercontent.com/u/4116236?v=4","interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"EndorseAction"},"userInteractionCount":110}},"commentCount":13,"discussionUrl":"https://daily.dev/posts/how-to-design-better-apis-ft5u2bjel","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":149},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":13}],"keywords":"","timeRequired":"PT6M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Hashnode","item":"https://daily.dev/sources/hashnode"},{"@type":"ListItem","position":3,"name":"How to design better APIs"}]} {"@context":"https://schema.org","@type":"WebPage","@id":"https://daily.dev/posts/how-to-design-better-apis-ft5u2bjel","comment":[{"@type":"Comment","text":"So… good content !!\nreally so nice","datePublished":"2022-03-26T13:02:28.850Z","url":"https://daily.dev/posts/Ft5u2BJEl#c-UwGmFdjR7","author":{"@type":"Person","name":"Yash bhatti","url":"https://daily.dev/yashbhatti","image":"https://media.daily.dev/image/upload/f_auto/v1648299817/avatars/bUkoyiY95iXafGv5lY3u0"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1}},{"@type":"Comment","text":"Very good blog post and very well written.","datePublished":"2022-03-20T23:39:59.576Z","url":"https://daily.dev/posts/Ft5u2BJEl#c-3n5sYMHdk","author":{"@type":"Person","name":"Michael Richins","url":"https://daily.dev/mrgrigri","image":"https://avatars2.githubusercontent.com/u/4528551?v=4"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1}},{"@type":"Comment","text":"Very good article, thank you!","datePublished":"2022-03-14T00:29:38.980Z","url":"https://daily.dev/posts/Ft5u2BJEl#c-tj-6wBKKE","author":{"@type":"Person","name":"Carlos Daniel","url":"https://daily.dev/carlos_almeida","image":"https://avatars.githubusercontent.com/u/25239841?v=4"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1}},{"@type":"Comment","text":"Informative 🙌","datePublished":"2022-03-21T08:39:27.458Z","url":"https://daily.dev/posts/Ft5u2BJEl#c-sw-33YY7_","author":{"@type":"Person","name":"Chris Legaxy","url":"https://daily.dev/chrislegaxy","image":"https://media.daily.dev/image/upload/f_auto/v1646712038/avatars/KHhZHlPZAGtRpCL3mieJF"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1}},{"@type":"Comment","text":"This is\ngreat","datePublished":"2022-03-20T13:34:39.412Z","url":"https://daily.dev/posts/Ft5u2BJEl#c-Qy_4aKwCh","author":{"@type":"Person","name":"Soumava Paul","url":"https://daily.dev/soumava","image":"https://avatars.githubusercontent.com/u/5659329?v=4"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1}}]} ```