Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

API Endpoint Semantics

Tags:

api-design

Is an API endpoint the 'method', like https://api.foursquare.com/v2/venues/ or the full URL including non-query-string parameters like https://api.foursquare.com/v2/venues/5104

In other words, are these two separate endpoints or considered the same endpoint? http://myapi.com/somemodel/1
http://myapi.com/somemodel/2

like image 213
Derek Dahmer Avatar asked Feb 17 '11 20:02

Derek Dahmer


People also ask

What is a semantic API?

Semantic API determines the meaning and context of your information. Since we use language in our everyday lives to communicate ideas and their meaning we take for granted its complexity. Semantics is the study of “meaning” in language.

How do you describe API endpoints?

An API endpoint is a point at which an API -- the code that allows two software programs to communicate with each other -- connects with the software program. APIs work by sending requests for information from a web application or web server and receiving a response.

What is API endpoint example?

An API Endpoint is the URL for a server or a service. These APIs operate through responses and requests — that is you make a request and the API Endpoint makes a response. A simple example of this is this particular Websites and article. The Websites is Medium, and your Web Browser makes a request for the content.


1 Answers

According to this Wikipedia article, the endpoint is a web service, defined by a WSDL file, and

does nothing more than define the address or connection point to a web service. It is typically represented by a simple HTTP URL string.

Microsoft uses the term endpoint in various contexts, but they all amount to the same thing: the endpoint is the entire interface, not one particular method.

In the context of a REST endpoint, the endpoint would contain the requisite GET, PUT, POST and DELETE methods (as applicable).

like image 87
Robert Harvey Avatar answered Sep 21 '22 03:09

Robert Harvey