Skip to content

Commit 6a39d8d

Browse files
fix: GraphQL vs REST blog post alignments on core principles
1 parent efb9da8 commit 6a39d8d

File tree

1 file changed

+7
-9
lines changed

1 file changed

+7
-9
lines changed

data/blog/software-development/web-services/graphql-vs-rest.mdx

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -23,18 +23,16 @@ This comprehensive guide will help you understand the key differences between RE
2323

2424
REST API (Representational State Transfer) has been the dominant API architecture for over two decades, and for good reason. It's simple, stateless, and follows well-established HTTP conventions. REST APIs are the foundation of modern web services and are used by millions of applications worldwide.
2525

26-
### Key Characteristics of REST
26+
### Core REST Principles
2727

28-
REST is built on six fundamental principles and follows these key characteristics:
28+
REST is built on six fundamental principles:
2929

30-
- **Resource-based**: Each endpoint represents a specific resource (e.g., `/users`, `/posts`)
31-
- **HTTP methods**: Uses standard HTTP verbs (GET, POST, PUT, DELETE, PATCH)
30+
- **Client-Server Architecture**: Separation of concerns between client and server
3231
- **Stateless**: Each request contains all necessary information
3332
- **Cacheable**: Responses can be cached at various levels
34-
- **Uniform interface**: Consistent patterns across all endpoints
35-
- **Client-Server Architecture**: Separation of concerns between client and server
33+
- **Uniform Interface**: Consistent patterns across all endpoints
3634
- **Layered System**: Architecture can be layered for scalability
37-
- **HATEOAS**: Hypermedia as the Engine of Application State (optional)
35+
- **Code on Demand**: Optional execution of code on the client
3836

3937
### REST API Example with Full CRUD Operations
4038

@@ -144,9 +142,9 @@ Content-Type: application/json
144142

145143
GraphQL, developed by Facebook in 2015, offers a more flexible and efficient approach to data fetching. It allows clients to request exactly the data they need, nothing more and nothing less. GraphQL has revolutionized how developers think about API design and data retrieval.
146144

147-
### Key Characteristics of GraphQL
145+
### Core GraphQL Principles
148146

149-
GraphQL is built on several key concepts and offers these characteristics:
147+
GraphQL is built on several key concepts and principles:
150148

151149
- **Query language**: Clients specify exactly what data they want
152150
- **Single endpoint**: All requests go through one endpoint (usually `/graphql`)

0 commit comments

Comments
 (0)