Welcome to the Blog API!
BlogAPI was built with Java Spring, and it provides an easy-to-use solution for managing blog posts and comments. With authentication and authorization features, you can be sure that only authorized users can access the data they are permitted to.
The API includes 5 database tables: blogs, comments, users, user_role_junction, and roles. It has a lot of endpoints where you can create, read, update, and delete blog posts, comments, users, roles and more
| HTTP Method | URL Path | Status Code | Description |
|---|---|---|---|
| POST | /auth/login | 200 (OK) | Login |
| POST | /auth/register | 201 (Created) | Register |
| HTTP Method | URL Path | Status Code | Description |
|---|---|---|---|
| POST | /api/blogs/ | 201 (Created) | Create a blog |
| PUT | /api/blogs/{blogId} | 200 (OK) | Update a blog |
| DELETE | /api/blogs/{blogId} | 200 (OK) | Delete a blog |
| GET | /api/blogs/ | 200 (OK) | Get all blogs |
| GET | /api/blogs/?orderBy={title, createdAt, updatedAt} |
200 (OK) | Order blogs by title, createdAt or updatedAt |
| GET | /api/blogs/{blogId} | 200 (OK) | Get blog by id |
| GET | /api/blogs/search?title=titlehere | 200 (OK) | Search blogs by title |
| HTTP Method | URL Path | Status Code | Description |
|---|---|---|---|
| POST | /api/blogs/{blogId}/comments/ | 201 (Created) | Create a comment |
| PUT | /api/blogs/0/comments/{commentId} | 200 (OK) | Update a comment |
| DELETE | /api/blogs/0/comments/{commentId} | 200 (OK) | Delete a comment |
| GET | /api/blogs/{blogId}/comments/ | 200 (OK) | Get blogs comments |
| HTTP Method | URL Path | Status Code | Description |
|---|---|---|---|
| GET | /api/users/my-profile | 200 (OK) | Get your profile |
| GET | /api/users/my-blogs | 200 (OK) | Get your blogs |
| GET | /api/users/my-comments | 200 (OK) | Get your comments |
Request
POST /auth/login
Content-Type: application/json{
"username": "ahmet",
"password": "1234",
}Response
{
"jwt": "eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJzZWxmIiwic3ViIjoiYWhtZXQiLCJpYXQiOjE2ODI4OTc0NzUsInJvbGVzIjoiVVNFUiJ9.teJzl47XjJqPJAU19Lhf8CrQOS2L1x11DPnilFqA1JKsiRwqVumAUZT7s89WPSm5-Cky5A0lG_u5BnB-Do1ROoqXkjK0MwIO3Hu9SFMusbcCD0D78sKiF3JMQHUU6RuJeKcSx5eVmqqVyPiw-UyqbiWJog2Y6JDsJyMxVwbHKBgh20RpCGtXf-hpDtpITbMJaQO01mY_FYNTu197wE8PXgsMoUv6Jjl_r7WIcFAoZzDnRF5VJ3niZVsncGRjqn9uQAPfWCrVgIa2f-VEpr2CveWDilKepOrboz3ypTBskmpNE_Av8aJwvu4DqePuqX-n_3n6DGv1phTvYjM_V0MdqA"
}Request
POST /auth/register
Content-Type: application/json{
"username":"johndoe",
"password":"12345",
"email":"johndoe@gmail.com",
"age":33
}Response
{
"id": 7,
"username": "johndoe",
"password": "$2a$10$02CiV8kQn3n5Pzmb2zxdBepC0/LIoUxHtUk/cHD364s4hL37NWjbS",
"email": "johndoe@gmail.com",
"age": 33,
"authorities": [
{
"id": 2,
"authority": "USER"
}
],
"blogs": null,
"comments": null,
"enabled": true,
"accountNonExpired": true,
"credentialsNonExpired": true,
"accountNonLocked": true
}Request
POST /api/blogs/
Content-Type: application/json
Authorization: Bearer <token>{
"title": "blog title",
"body": "blog content"
}Response
Created successfully
Request
PUT /api/blogs/{blogId}
Content-Type: application/json
Authorization: Bearer <token>{
"title": "updated blog title",
"body": "updated blog content"
}Response
{
"title": "updated blog title",
"body": "updated blog content"
}Request
DELETE /api/blogs/{blogId}
Content-Type: application/json
Authorization: Bearer <token>Response
Deleted successfully
GET /api/blogs/?orderBy=title (or createdAt or updatedAt)
Content-Type: application/json
Authorization: Bearer <token>Response
[
{
"title": "Ahmet's Blog",
"body": "Hey, this is my blog about Log4j2. Log4j2 is a logging framework that is mostly used in back-end services. It's the most popular logging framework. Last year, unfortunately there was a critical loop-hole was found in this framework that led all of companies to double-check and re-build their logging systems.",
"username": "ahmet",
"commentCount": 2,
"createdAt": "2023-04-29T14:50:12.655+00:00"
},
{
"title": "John's Lorem Blog",
"body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec auctor velit vel enim volutpat, quis rhoncus metus tempor. Integer imperdiet lacus eu augue imperdiet ultricies. Fusce sit amet lorem non massa pharetra rutrum. Sed commodo urna vitae mauris tincidunt, et congue dolor commodo. Sed eget bibendum neque. Sed nec dui augue. Nunc finibus hendrerit velit, eu commodo magna ultricies vel. Aliquam vel nisl enim. Vivamus at enim commodo, vulputate quam eget, cursus justo.",
"username": "john",
"commentCount": 1,
"createdAt": "2023-04-30T16:34:54.336+00:00"
},
{
"title": "My Thoughts on the Importance of Reading",
"body": "Reading is one of the most important activities that a person can engage in. It allows us to learn about new topics and ideas, develop our critical thinking skills, and expand our imaginations. Whether you enjoy fiction or non-fiction, there is something for everyone in the world of books. So take some time today to curl up with a good book and see where it takes you!",
"username": "mark12",
"commentCount": 3,
"createdAt": "2023-04-30T21:33:32.582+00:00"
},
{
"title": "The Power of Practicing Gratitude",
"body": "Practicing gratitude is a simple but powerful way to improve your mental health and overall well-being. By focusing on the good things in your life, you can increase feelings of happiness and satisfaction, reduce symptoms of anxiety and depression, and even improve physical health outcomes. Whether you keep a daily gratitude journal or simply take a few moments each day to reflect on the things you're thankful for, incorporating gratitude into your routine can have a big impact on your life.",
"username": "admin",
"commentCount": 1,
"createdAt": "2023-04-29T14:42:41.628+00:00"
}
]GET /api/blogs/{blogId}
Content-Type: application/json
Authorization: Bearer <token>Response
{
"title": "My Thoughts on the Importance of Reading",
"body": "Reading is one of the most important activities that a person can engage in. It allows us to learn about new topics and ideas, develop our critical thinking skills, and expand our imaginations. Whether you enjoy fiction or non-fiction, there is something for everyone in the world of books. So take some time today to curl up with a good book and see where it takes you!",
"username": "mark12",
"createdAt": "2023-04-30T21:33:32.582+00:00",
"updatedAt": null,
"comments": [
{
"body": "I really enjoyed reading your blog post. Your writing style is engaging and you make some great points about the importance of staying active. Keep up the good work!",
"username": "ahmet",
"createdAt": "2023-04-30T21:33:32.582+00:00"
},
{
"body": "I really enjoyed reading your thoughts on this topic, Mark. You have a unique perspective that I find refreshing.",
"username": "admin",
"createdAt": "2023-04-30T21:33:32.582+00:00"
},
{
"body": "Great post, Mark! Your writing always inspires me to think more deeply about the world around us!",
"username": "john",
"createdAt": "2023-04-30T21:33:32.582+00:00"
}
]
}GET /api/blogs/search?title=reading
Content-Type: application/json
Authorization: Bearer <token>Response
[
{
"title": "My Thoughts on the Importance of Reading",
"body": "Reading is one of the most important activities that a person can engage in. It allows us to learn about new topics and ideas, develop our critical thinking skills, and expand our imaginations. Whether you enjoy fiction or non-fiction, there is something for everyone in the world of books. So take some time today to curl up with a good book and see where it takes you!",
"username": "mark12",
"commentCount": 3,
"createdAt": "2023-04-30T21:33:32.582+00:00"
}
]Request
POST /api/blogs/{blogId}/comments/
Content-Type: application/json
Authorization: Bearer <token>{
"body": "comment body"
}Response
Created successfully
Request
PUT /api/blogs/0/comments/{commentId}
Content-Type: application/json
Authorization: Bearer <token>{
"body": "updated blog content"
}Response
{
"body": "updated blog content"
}Request
DELETE /api/blogs/8/comments/
Content-Type: application/json
Authorization: Bearer <token>Response
Deleted successfully
Request
GET /api/blogs/0/comments/{commentId}
Content-Type: application/json
Authorization: Bearer <token>Response
{
"body": "As an admin i liked this blog",
"username": "admin",
"createdAt": "2023-04-29T14:50:12.655+00:00",
"updatedAt": "2023-04-30T17:27:12.697+00:00",
"blogTitle": "Ahmet's Blog"
}Request
GET /api/user/my-profile
Content-Type: application/json
Authorization: Bearer <token>Response
{
"username": "ahmet",
"email": "saas@gmail.com",
"age": 19,
"blogs": [
{
"title": "Ahmet's Blog",
"body": "Hey, this is my blog about Log4j2. Log4j2 is a logging framework that is mostly used in back-end services. It's the most popular logging framework. Last year, unfortunately there was a critical loop-hole was found in this framework that led all of companies to double-check and re-build their logging systems.",
"commentCount": 2,
"createdAt": "2023-04-29T14:50:12.655+00:00"
}
],
"comments": [
{
"body": "Hey, nice blog. Keep up the good work!",
"createdAt": "2023-04-29T14:42:41.628+00:00",
"updatedAt": "2023-04-30T17:17:36.502+00:00"
},
{
"body": "updated test comment!!",
"createdAt": "2023-04-29T14:50:12.655+00:00",
"updatedAt": "2023-04-30T17:27:12.697+00:00"
},
{
"body": "This is a great blog post! Thanks for sharing your insights.",
"createdAt": "2023-04-30T16:34:54.336+00:00",
"updatedAt": "2023-04-30T21:39:39.030+00:00"
},
{
"body": "I really enjoyed reading your blog post. Your writing style is engaging and you make some great points about the importance of staying active. Keep up the good work!",
"createdAt": "2023-04-30T21:33:32.582+00:00",
"updatedAt": null
}
]
}Request
GET /api/user/my-blogs
Content-Type: application/json
Authorization: Bearer <token>Response
[
{
"title": "Ahmet's Blog",
"body": "Hey, this is my blog about Log4j2. Log4j2 is a logging framework that is mostly used in back-end services. It's the most popular logging framework. Last year, unfortunately there was a critical loop-hole was found in this framework that led all of companies to double-check and re-build their logging systems.",
"commentCount": 2,
"createdAt": "2023-04-29T14:50:12.655+00:00"
}
]Request
GET /api/user/my-comments
Content-Type: application/json
Authorization: Bearer <token>Response
[
{
"body": "Hey, nice blog. Keep up the good work!",
"createdAt": "2023-04-29T14:42:41.628+00:00",
"updatedAt": "2023-04-30T17:17:36.502+00:00"
},
{
"body": "updated test comment!!",
"createdAt": "2023-04-29T14:50:12.655+00:00",
"updatedAt": "2023-04-30T17:27:12.697+00:00"
},
{
"body": "This is a great blog post! Thanks for sharing your insights.",
"createdAt": "2023-04-30T16:34:54.336+00:00",
"updatedAt": "2023-04-30T17:36:38.135+00:00"
}
]Example Logs
01-05-2023 00:30:40 [INFO ] - (AuthenticationManager.java:65) | mark12(id: 5) has registered
01-05-2023 00:33:32 [INFO ] - (BlogManager.java:66) | Blog(id: 8) has been added by mark12
01-05-2023 00:35:18 [INFO ] - (CommentManager.java:68) | ahmet has commented(id: 11) on the blog(id: 8)
01-05-2023 00:35:51 [INFO ] - (CommentManager.java:68) | john has commented(id: 12) on the blog(id: 8)
01-05-2023 00:36:25 [INFO ] - (CommentManager.java:68) | admin has commented(id: 13) on the blog(id: 8)
01-05-2023 00:39:39 [INFO ] - (BlogManager.java:94) | Blog(id: 7) has been updated by john
01-05-2023 00:40:45 [INFO ] - (CommentManager.java:95) | john has edited their comment(id: 12) on the blog(id: 8)
01-05-2023 00:41:12 [INFO ] - (CommentManager.java:68) | admin has commented(id: 14) on the blog(id: 8)
01-05-2023 00:42:06 [INFO ] - (CommentManager.java:112) | admin has deleted their comment(id: 14) on the blog(id: 8)
01-05-2023 01:14:09 [INFO ] - (AuthenticationManager.java:65) | mark123(id: 6) has registered
01-05-2023 02:33:21 [INFO ] - (AuthenticationManager.java:65) | johndoe(id: 7) has registered
Java Spring Boot. Dependencies:
- Spring WEB
- Spring Data JPA
- Spring Security
- OAuth2 Resource Server
- Spring DevTools
- PostgreSQL Driver
- ModelMapper
- Log4j2