CommunityNews

CommunityNews

How to Design Better APIs

How to design better APIs.
15 language-agnostic, actionable tips on REST API design.

Read in full here:

This thread was posted by one of our members via one of our news source trackers.

Most Liked

andrea

andrea

Awesome list. What about for GraphQL APIs? :slight_smile:

dyowee

dyowee

A much welcome article/resource, even if you are designing private/internal APIs.

Exadra37

Exadra37

I want to add a word of caution for the use of this terms…

I work as a Developer Advocate for Mobile and API Security and I see a lot the term of private APIs being used incorrectly. Bear in mind that an API is only private when is not exposed to the world wide web (only works in an intranet), and that is rarely the case.

Just because an API needs a subscription, is only by invite, and/or is not documented anywhere, etc, doesn’t make it private. From the moment that a mobile app or web app uses the public internet to reach the API server, your API is public not private, because all it takes is to reverse engineer the mobile app or the web app to discover the API endpoints and then workout how they work in order to automate exploits against it.

Open source tools also exist to scan all domains and their sub-domains in order to find hidden APIs and then try to automatically fuzz them in order to try to find a way in, and you can assert this by deploying an online server with a public domain pointing to it and then tail the logs and you will see that just after a few seconds/minutes you can see strange entries in your logs.

Where Next?

Popular General Dev topics Top

New
First poster: dimitarvp
skiftOS is a simple, handmade operating system for the x86 platform, aiming for clean and pretty APIs while keeping the spirit of UNIX. s...
New
First poster: bot
Last night I re-read this Steve Yegge article about learning to type as a programmer. I can touch type, but I don’t usually manage to bre...
New
First poster: AstonJ
We engineered a wearable microphone jammer that is capable of disabling microphones in its user’s surroundings, including hidden micropho...
New
First poster: Maartz
This Keyboard Lets People Type So Fast It’s Banned From Typing Competitions. A new peripheral lets you keep typing without ever lifting ...
New
First poster: bot
sqlglot/python_sql_engine.md at main · tobymao/sqlglot. Python SQL Parser and Transpiler. Contribute to tobymao/sqlglot development by c...
New
CommunityNews
9 fintech engineering mistakes. Read this list unless you want to build a money dissappearing system
New
First poster: AstonJ
On the benefits of learning in public. Learning in public helps me grow as an engineer and seems to benefit others too. Here’s why I sho...
New
First poster: joeb
The new frameworks will continue until morale improves.
/js
New
New

Other popular topics Top

AstonJ
A thread that every forum needs! Simply post a link to a track on YouTube (or SoundCloud or Vimeo amongst others!) on a separate line an...
New
AstonJ
If it’s a mechanical keyboard, which switches do you have? Would you recommend it? Why? What will your next keyboard be? Pics always w...
New
PragmaticBookshelf
Ruby, Io, Prolog, Scala, Erlang, Clojure, Haskell. With Seven Languages in Seven Weeks, by Bruce A. Tate, you’ll go beyond the syntax—and...
New
AstonJ
You might be thinking we should just ask who’s not using VSCode :joy: however there are some new additions in the space that might give V...
New
AstonJ
Biggest jackpot ever apparently! :upside_down_face: I don’t (usually) gamble/play the lottery, but working on a program to predict the...
New
New
PragmaticBookshelf
Develop, deploy, and debug BEAM applications using BEAMOps: a new paradigm that focuses on scalability, fault tolerance, and owning each ...
New
AstonJ
This is a very quick guide, you just need to: Download LM Studio: https://lmstudio.ai/ Click on search Type DeepSeek, then select the o...
New
NewsBot
Node.js v22.14.0 has been released. Link: Release 2025-02-11, Version 22.14.0 'Jod' (LTS), @aduh95 · nodejs/node · GitHub
New
mindriot
Ok, well here are some thoughts and opinions on some of the ergonomic keyboards I have, I guess like mini review of each that I use enoug...
New