REST vs SOAP vs GraphQL comparison in Rest API - Visual Side-by-Side Comparison

Concept Flow - REST vs SOAP vs GraphQL comparison

Client sends request

↓

REST

↓

Uses HTTP

↓

Stateless

↓

Resource

↓

URLs

↓

JSON/XML

↓

Multiple

↓

Endpoints

↓

Cache

↓

Client receives response

Client sends a request, chooses REST, SOAP, or GraphQL, each with different protocols and data formats, then receives a response.

Execution Sample

Rest API

GET /users/123 HTTP/1.1
Host: api.example.com

--- REST example

POST /soap HTTP/1.1
Host: api.example.com
Content-Type: text/xml

<soapenv:Envelope>...</soapenv:Envelope>

--- SOAP example

POST /graphql HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"query": "{ user(id: \"123\") { name } }"}

--- GraphQL example

Shows example requests for REST, SOAP, and GraphQL APIs fetching user data.

Execution Table

Step	API Type	Request Sent	Data Format	Response Received	Notes
1	REST	GET /users/123	JSON or XML	User data in JSON	Simple URL, stateless
2	SOAP	POST /soap with XML envelope	XML	User data in XML	Strict protocol, built-in security
3	GraphQL	POST /graphql with query JSON	JSON	User data shaped by query	Single endpoint, flexible data
4	REST	GET /users/123	JSON or XML	404 Not Found if user missing	Standard HTTP status codes
5	SOAP	POST /soap with XML envelope	XML	SOAP Fault message	Standardized error handling
6	GraphQL	POST /graphql with query JSON	JSON	Errors in response body	Errors returned in data structure
7	REST	GET /users	JSON or XML	List of users	Multiple endpoints for resources
8	SOAP	POST /soap with XML envelope	XML	Response with multiple data	Complex operations supported
9	GraphQL	POST /graphql with query JSON	JSON	Custom shaped list of users	Client controls data shape
10	Exit	-	-	-	All requests processed

💡 All API types processed their requests and returned responses or errors.

Variable Tracker

Variable	Start	After REST	After SOAP	After GraphQL	Final
Request Type	None	GET /users/123	POST /soap XML	POST /graphql JSON	Completed
Data Format	None	JSON/XML	XML	JSON	Completed
Response	None	User JSON	User XML	User JSON shaped	Completed
Error Handling	None	HTTP status	SOAP Fault	Errors in JSON	Completed

Key Moments - 3 Insights

Why does SOAP always use XML while REST can use JSON or XML?

SOAP is a protocol that requires XML envelopes for messages (see execution_table rows 2 and 5). REST is more flexible and can use JSON or XML depending on the API design (rows 1 and 4).

How does GraphQL let clients control the data shape?

GraphQL uses queries sent in JSON that specify exactly what fields are needed (execution_table row 3 and 9). This means clients get only the data they ask for, unlike REST or SOAP.

Why does REST use multiple endpoints but GraphQL uses a single endpoint?

REST maps resources to URLs (execution_table rows 1 and 7), so each resource has its own endpoint. GraphQL uses one endpoint and clients specify queries to get different data shapes (rows 3 and 9).

Visual Quiz - 3 Questions

Look at the execution table, what data format does SOAP use in its requests?

A Plain text

B JSON

C XML

D YAML

💡 Hint

Check the 'Data Format' column for SOAP rows (2 and 5) in the execution table.

At which step does GraphQL return errors inside the response body?

A Step 6

B Step 9

C Step 3

D Step 2

💡 Hint

Look for 'Errors in response body' in the 'Notes' column for GraphQL in the execution table.

If REST used a single endpoint like GraphQL, what would change in the execution table?

A SOAP would stop using XML

B Multiple endpoints rows would merge into one

C GraphQL would use multiple endpoints

D Error handling would change

💡 Hint

Refer to the 'Notes' column about endpoints in REST and GraphQL rows.

Concept Snapshot

REST, SOAP, and GraphQL are ways to build APIs.
REST uses multiple URLs and supports JSON or XML.
SOAP uses XML with strict rules and built-in security.
GraphQL uses one endpoint and lets clients ask for exactly what they want.
REST is simple and cacheable; SOAP is strict and secure; GraphQL is flexible but complex.

Full Transcript

This visual compares REST, SOAP, and GraphQL APIs. The client sends a request choosing one API type. REST uses HTTP methods and multiple URLs, returning JSON or XML. SOAP sends XML envelopes with strict rules and built-in security. GraphQL uses a single HTTP endpoint with JSON queries that specify exactly what data the client wants. The execution table shows example requests and responses for each API type, including how errors are handled. Variables track request types, data formats, responses, and error handling across the three APIs. Key moments clarify why SOAP uses XML, how GraphQL controls data shape, and why REST uses multiple endpoints. The quiz tests understanding of data formats, error handling, and endpoint differences. The snapshot summarizes the main differences simply and clearly.