V2 API Documentation

• This is a list of all the current endpoints with updated methods and responses (after will be a list of new endpoints for v2)

• Draft 4

• reason can be left NULL if you don't want a reason to your actions

When making any request (except the /blog/latest endpoint) you will need to send your API token through Autherization: bearer in the header.

Blogs

Get latest blog post

GET https://api.bubblez.app/v2/blog/latest

you don't need to send any data (this is a public endpoint)

200: OK

{
	"error": false,
	"blog": {
		"content": "string",
		"image": "string",
		"tag": "string",
		"date": "integer"
	},
	"user": {
		"uuid": "string",
		"username": "string",
		"displayname": "string",
		"pfp": "string"
	}
}

---

Posts

you only need "parent_id" if you're replying to a post or another reply

Post

PUT https://api.bubblez.app/v2/post

Request Body

Name	Type	Description
parent_id	String	The ID of the post you want to reply to
content*	String
from	String
lock	Boolean	default "false"
nsfw	Boolean	default "false"

200: OK

{
	"error": false,
	"post": {
		"id": "string",
		"parent_id": "string",
		"content": "string",
		"from": "string",
		"lock": "boolean",
		"nsfw": "boolean"
	}
}

for content, lock and nsfw: if left as null, nothing will be updated

Update post

PATCH https://api.bubblez.app/v2/post/{post_id}

Path Parameters

Name	Type	Description
post_id*	Integer

Request Body

Name	Type	Description
token*	String
content	String	Can be left as null
lock	Boolean	Can be left as null
nsfw	Boolean	Can be left as null
reason	String

200: OK

{
	"error": false,
	"post": {
		"id": "string",
		"content": "string",
		"lock": "boolean",
		"nsfw": "boolean"
	},
	"reason": "string"
}

Get post

GET https://api.bubblez.app/v2/post/{post_id}

Path Parameters

Name	Type	Description
post_id*	Integer

200: OK

{
	"error": false,
	"post": {
		"id": "string",
		"content": "string",
		"from": "string",
		"lock": "boolean",
		"nsfw": "boolean",
		"edited": "integer",
		"date": "integer",
		"replies": {
			"id": "string",
			"id": "string"
		}
	},
	"user": {
		"uuid": "string",
		"username": "string",
		"displayname": "string",
		"pfp": "string"
	}
}

Delete post

DELETE https://api.bubblez.app/v2/post/{post_id}

Path Parameters

Name	Type	Description
post_id*	Integer

200: OK

{
	"error": false,
	"post": {
		"id": "string",
	},
	"reason": "string"
}

---

Users

A way to use the Username in conjuction with UUID will be added later

NOTE1: type: 0 = User, 1 = Bot NOTE2: both nsfw and private will be "false" for bot accounts NOTE3: A way to get other bot info will come later

Get user

GET https://api.bubblez.app/v2/user/{uuid}

Path Parameters

Name	Type	Description
uuid*	String

200: OK

{
	"error": false,
	"user": {
		"type": "integer",
		"uuid": "string",
		"username": "string",
		"displayname": "string",
		"banner": "string",
		"badge": "json",
		"special_badge": "json",
		"bio": "string",
		"nsfw": "boolean",
		"private": "boolean",
		"pronoun": "json",
		"joined": "integer"
	}
}

This is used to tell if the site is online without a massive response back

Get ping

GET https://api.bubblez.app/v2/ping

200: OK

{
	"error": false
}

---

NEW FOR V2

Will return NULL if unchanged

Update profile

PATCH https://api.bubblez.app/v2/profile

Request Body

Name	Type	Description
username	String	Keep null to leave them unchanged
displayname	String	Keep null to leave them unchanged
pfp	String	Keep null to leave them unchanged
banner	String	Keep null to leave them unchanged
bio	String	Keep null to leave them unchanged

200: OK

{
	"error": false,
	"updated": {
		"username": "string",
		"displayname": "string",
		"pfp": "string",
		"banner": "string",
		"bio": "string"
	}
}