Answers for "what is request API"

what is request API

What is an API Request?

If you specialize in apps or software development,
you must have come across the term API.
This is the short form for Application Programming Interface,
and it technically refers to a robust set of procedures,
tools, and protocols that permit the interaction between web applications.
It is an intermediary that delivers a client’s request to the server and then returns a response to the client.

APIs help software developers to streamline and shorten the application building process by eliminating frequently repeated program development processes.
In short, they help you not to keep reinventing the wheel every time you are using the same procedure to build applications.
With APIs, developers can omit some of the simple programming steps,
and thus save time and increase productivity.
However, for programmers to use APIs, they must know how to make API requests.

api request

Request 
		 Request URL (ENDPOINT)
		 	http://54.158.178.13:8000/api/spartans

		 HTTP Methods|Verb  : GET POST PUT DELETE PATCH 
		 	
		 HEADER  : key value pair 
		 	Accept , Content-Type
		 
		 Query Parameters : key value pair right after ? 
		 	/api/spartans/search?gender=Male&nameContains=li
		 	mostly used to filter out the result according to 
		 	the cirteria provided here 

		 Path Parameters|Variable 
		 	/api/spartans/{id}  /api/spartans/:id
		 	used to identify single resource among list of resources

		 Request Body | Payload
		 	the data you are sending to the server

api request and response

HTTP request method is made up of five  components:
Request Method ==> Get, Post, Put, Delete (these are
the common ones)
Request URL ==> the URL of the resource
Request Header ==> Accept-Language, AcceptEncoding, User-Agent, Host
Request Body ==> This is the data to be sent to the
resource
Request Query Parameters : key value pair 
		 	
HTTP response method is made up of three components:
Response Status Code ==> 200, 301, 404, 500
(these are the most common ones)
Response Header Fields ==> Date, Server, LastModified, Content-Type
Response Body ==> This is the data that comes
back to the client from the server.

what do we have in the request and response in api

REQUEST :(request url,http methods,header,query param, param,body,cookie)

1-)Request Url where we have Endpoint (domain:Port/Endpoints)

2-)HTTP METHODS(Get, Post, Put, Patch, Delete, Header)

Get: For to retrieve resources from the server
Post: to send or add resource to the server
Put: For update the resources in the server
Patch: For partial update the resource
Delete: For deleting the resource in the server
Head: To get header from the response not the body

3-)HEADER is metadata is about the request,
basically providing more information along
with the request.

-Content Type header : to specify what kind of
 data we are sending to the server
-Accept Header : to specify what kind of data 
 format you want to get in the response like (json or xml)
-Authorization header : used to provide the
 Bearer token in many api's.

4-)Query Parameter: A key value pair usually
 for filtering result

5-)Parameter: for identifying single resource
 among the list of resources.
6-)Payload(BODY): for POST,PUT,PATCH request
(json,xml,plainText,URL encoded for data)
7-)Cookie

RESPONSE :(STATUS CODE,PAYLOAD(body),HEADER,COOKIE,
           TIME(spent to get response))

1-Status Code:
   2xx - Success
   4xx - Client Error
   5xx - Server Error

2-Payload(Body) : 
The actual resource we got from the server.
Content type can be : plain text, json, xml, html, json etc.

3- Metadata about response to provide more information

4- Cookie

5- Time for getting spended time for the response