Let's use the Twitter API as an example. My understanding is that we refer to /statuses/update
as an endpoint and we refer to POST
as a HTTP method.
So what would term do you use to refer to the pair of these two things combined, i.e. POST /statuses/update
?
"Endpoint". It seems most conventional to also refer to the combination as "endpoint". See for example: Stripe's documentation of some of its "endpoints" here or this overview page for Twitter. The only problem is when I'm in a verbal conversation with someone saying "endpoint", it is sometimes ambiguous whether I mean just the end path
/statuses/update
or the combinationPOST /statuses/update
."Request method" or "API method". For example, Slack's REST API documentation refers to the end paths as "method URLs" and the collection of these as "API methods". Some API docs will list these pairs in the following manner:
Available methods
POST /statuses/update
GET /statuses/lookup