vrchatapi.github.io icon indicating copy to clipboard operation
vrchatapi.github.io copied to clipboard

Document /groups/ID/posts

Open Protected opened this issue 1 year ago • 2 comments

Ever since multiple posts/announcements per group became possible, the /groups/ID/announcement endpoint has been insufficient. The website uses /groups/ID/posts to retrieve the post history of a group.

Query parameters:

n: Amount of results (like for group members). Seems to default to 5. The website issues multiple calls to the endpoint as you scroll down. offset: Which result to return from, defaulting to 0.

Results appear sorted by reverse creation date by default.

Returns:

{
	"total": AMOUNT,
	"posts": [GroupAnnouncement]
}

Where AMOUNT is the total amount of existing posts, not the amount of returned posts.

The GroupAnnouncement object is outdated in the website. The following fields are missing (returned equally by both endpoints):

editorId: string visibility: string (defaults to "group", there's presumably some value for public posts) roleIds: [string] (assumed)

Protected avatar Apr 09 '24 19:04 Protected

Oops, looks like someone already mentioned this in https://github.com/vrchatapi/specification/issues/198

Protected avatar Apr 09 '24 19:04 Protected

I'm working on it, https://github.com/vrchatapi/specification/pull/315

Tresvian avatar Apr 23 '24 03:04 Tresvian

closed by https://github.com/vrchatapi/specification/pull/315

jellejurre avatar Nov 20 '24 18:11 jellejurre