Home / Knowledge hub / REST API
Knowledge hub
REST API
A common web API style where URLs name things and HTTP verbs act on them.
What it means
A REST API is a way of building a web API in which each thing, such as a customer or an order, has its own address, and standard HTTP verbs act on it. GET reads, POST creates, PUT or PATCH changes and DELETE removes. Data usually travels as JSON.
REST is a design style, not a security feature or a strict standard. Two APIs can both call themselves REST and still behave quite differently. That is why security checks must look at what each individual API actually does, route by route and verb by verb.
Why it matters
Most modern products expose a REST API to their web app, mobile app and partners. Because the addresses are predictable, such as /orders/123, they are easy to explore and easy to misuse. One missing check on one verb can expose a whole collection of records.
The frequent failures are well known: a record returned to the wrong account, an admin function open to ordinary accounts, and responses that carry more fields than the screen shows. Each is a business problem as well, because the data in question belongs to your customers.
How it shows up
You meet a REST API in browser network traffic, in mobile app calls and in the documentation you give partners. Typical mistakes include checking authorisation on GET but forgetting PUT or DELETE, trusting an id in the URL, and allowing verbs nobody intended. See function-level authorisation and BOLA.
To review one, list every route and verb, then test each with accounts that should be refused. Compare what each response returns against what the screen needs. Check that errors reveal little, that limits exist, and that old versions are gone or protected the same way as the new.
Questions people ask
REST API, answered
Is REST more secure than other API styles?
No. REST is a way of organising an API, and it has no built-in security. The risks depend on the checks you write.
The same ownership and role checks are needed whether you use REST, GraphQL or something else.
What is the difference between REST and GraphQL?
A REST API exposes many addresses, each returning a fixed shape. GraphQL usually exposes one address where the caller asks for the fields it wants.
Both need object-level and function-level authorisation on the server.
Does HTTPS make a REST API safe?
It protects traffic in transit from being read or changed on the way. It does not decide who may see what.
A request over HTTPS from the wrong account still gets the data if the server forgets to check.
Which verbs are most often left unprotected?
PUT, PATCH and DELETE, because teams test the read path most and forget the rest. Verbs the app never uses in the interface are also commonly left open.
Test every verb on every route.
How do we find all the endpoints?
Use your routing code, your API description file, gateway configuration and traffic captures, then compare them.
Anything in traffic but not in your list is an undocumented route, and a likely place for gaps.
Related
Terms that sit next to this one
API
The part of your application other software talks to, not a person.
OWASP API Security Top 10
The OWASP list of the most serious risks specific to APIs.
HTTP verb tampering
Switching a request's method to reach a path that only checks other methods.
BOLA
An API returns a record just because you asked for it by number.
GraphQL
One API endpoint where the client asks for exactly the fields it wants.
Is every verb checked, not just GET?
REST gaps hide in the verbs and routes nobody tested. We exercise your API and report only what we proved, with the request, the response and, in white-box mode, the line of code. Book a pilot on one app.
Or start with a $199 pilot on one application: thirty days, success criteria agreed before day one, credited against the annual if you convert.