Your bookmarks

Loading your bookmarks

Latest updates

New courses, skills, book chapters, and site improvements will appear here.

Create free accountSign upDashboardDashboard

Endpoint

  • Standard term
2 steps

An endpoint is one specific address in a service where a program sends requests about one kind of thing, such as tasks, and gets a reply back under agreed rules.

A program calls an endpoint by sending its address an action word, the details it expects, and a key showing who is calling. One address often takes several actions. At /tasks, GET (fetch) lists tasks and POST (send something new) adds one. The service runs the matching code and replies with data and a status code, a number saying whether it worked.

Where you’ll meet it

Your coding agent adds password reset to your app. The reset emails arrive, but new passwords never save. The agent wrote the save step from memory, and it calls an address the sign-in service retired last year.

What to do

  1. Find the sign-in service's current documentation page for password reset.
  2. Send your agent the link, and have it check each endpoint it calls against that page.
  3. Reset a test account's password, then sign in with the new one.

Easy to mix up

An API is a service's whole set of entries and the rules for using them. An endpoint is one entry inside it, such as the address that handles tasks.

Check yourself

Your agent writes a script to add a task to your to-do service. It sends the new task's details to /tasks, and each time the reply is your full task list, with nothing new saved. What is the likelier cause?

Go deeperServices publish their endpoints and retire old versions on announced dates

Many services publish their endpoints in an OpenAPI file, a machine-readable list of every address, action, required field, and possible reply. Tools can generate the calling code from that file, and tests can check each call against it, so a misspelled or retired address fails in testing before any user meets it.

Endpoints change in versions, often marked in the address, as in /v2/tasks. A service usually announces a retirement date for an old version and keeps it running until then, so a call that works today can stop on a known day. In IT security the word names something else, a device such as a laptop or phone on a company's network, which "endpoint protection" software guards.

Practice Build Basics

Or take the learning quiz on a mix of every set