#topgg-open-source | Top.gg | Page 3

drowsy thistle Sep 5, 2025, 1:09 PM

#

@steady kite which sdks can you work on?

steady kite Sep 5, 2025, 1:09 PM

#

defeiently docs

#

topgg-voting-node-sdk

drowsy thistle Sep 5, 2025, 1:10 PM

#

oooo nice

steady kite Sep 5, 2025, 1:11 PM

#

node-docs that I had no idea about until just now

#

whats the URL to that

drowsy thistle Sep 5, 2025, 1:13 PM

#

node-docs?

steady kite Sep 5, 2025, 1:13 PM

#

https://github.com/top-gg/top.gg-voting-node-docs

GitHub

GitHub - top-gg/top.gg-voting-node-docs: The official docs for the ...

The official docs for the Top.gg node vote SDK. Contribute to top-gg/top.gg-voting-node-docs development by creating an account on GitHub.

drowsy thistle Sep 5, 2025, 1:14 PM

#

never knew that existed until now

#

lmao

dense barn Sep 5, 2025, 1:17 PM

#

would be neat to get those merged into the main docs site

steady kite Sep 5, 2025, 1:19 PM

#

true

#

do we have URL for it rn?

#

or is it just a github kek

drowsy thistle Sep 5, 2025, 1:30 PM

#

me when i wanted to update my url

#

iara_why_sob

deft merlin Sep 5, 2025, 1:30 PM

#

lol

steady kite Sep 5, 2025, 1:31 PM

#

just shoot me a DM Prayge

drowsy thistle Sep 5, 2025, 1:31 PM

#

i believe everyone deserves to be able to see our progress too

deft merlin Sep 5, 2025, 1:31 PM

#

send me the link and i'll post it here and pin it

drowsy thistle Sep 5, 2025, 1:32 PM

#

sure sure

deft merlin Sep 5, 2025, 1:35 PM

#

Current Progress on SDKs: https://docs.google.com/spreadsheets/d/e/2PACX-1vQNAKeJ1Sdo4YGxuANSAHgNs5X7al7pP8tfsu5xUA7mTRN5gIpmS5FaH8z6kaVQmp2ttk7MZLOO8LZM/pub?gid=1904461732&single=true&output=pdf

deft merlin Sep 5, 2025, 1:35 PM

#

deft merlin Current Progress on SDKs: https://docs.google.com/spreadsheets/d/e/2PACX-1vQNAKe...

drowsy thistle Sep 5, 2025, 1:54 PM

#

deft merlin Current Progress on SDKs: https://docs.google.com/spreadsheets/d/e/2PACX-1vQNAKe...

added a v0 mark to differentiate between which has been successfully tested on v1 and which has successfully tested on v0

#

should the SDKs accept raw JSON dictionaries? because this will vary depending on language

#

what do you think @steady kite

steady kite Sep 5, 2025, 2:02 PM

#

I’d accept both

#

Raw as an escape

drowsy thistle Sep 5, 2025, 2:03 PM

#

as an escape?

steady kite Sep 5, 2025, 2:03 PM

#

Validation is like non existent from raw?

drowsy thistle Sep 5, 2025, 2:03 PM

#

yea

#

also tokens will not be related to discord bots anymore right

steady kite Sep 5, 2025, 2:04 PM

#

what

drowsy thistle Sep 5, 2025, 2:05 PM

#

no wait i mean

#

do server owners get access to the API as well? i dont remember if i've asked this before

steady kite Sep 5, 2025, 2:05 PM

#

im confused

#

Confused_Dog

#

ofc they would??

#

what API ig

drowsy thistle Sep 5, 2025, 2:07 PM

#

steady kite im confused

because you need to visit your bot page to retrieve your API token

steady kite Sep 5, 2025, 2:07 PM

#

oh

#

you have to be the owner to add a server

drowsy thistle Sep 5, 2025, 2:07 PM

#

and now that servers are back, who knows if they also want to give API access to server owners

#

and maybe more things down the line

steady kite Sep 5, 2025, 2:08 PM

#

steady kite you have to be the owner to add a server

this

drowsy thistle Sep 5, 2025, 2:08 PM

#

yeah i know

steady kite Sep 5, 2025, 2:08 PM

#

manage server or admin can't add servers to top.gg

#

so ofc the owner would get access

#

cause they are the only ones who can add it?

drowsy thistle Sep 5, 2025, 2:08 PM

#

in v0, the API is very much discord bot-based because it was prior to servers becoming available again

steady kite Sep 5, 2025, 2:09 PM

#

correct

drowsy thistle Sep 5, 2025, 2:10 PM

#

will v1 be the same or can server owners retrieve API tokens from their top.gg server page now?

steady kite Sep 5, 2025, 2:11 PM

#

still confused cause the API key's are historically on the server page, so yes server owners would have acces to there own page because they are the only ones who can add it. Maybe a missing something so imma just step back and maybe Veld understands and can answer your question.

drowsy thistle Sep 5, 2025, 2:11 PM

#

or maybe they already can? (i dont have a server on the site atm)

steady kite Sep 5, 2025, 2:12 PM

#

on the staging site, I don't see an option for API at the moment

drowsy thistle Sep 5, 2025, 2:12 PM

#

oh

#

because if they get the same kind of token as the ones devs get for discord bots, i need to adapt the documentation accordingly

steady kite Sep 5, 2025, 2:13 PM

#

I get it

drowsy thistle Sep 5, 2025, 2:13 PM

#

because there's a lot of "Your discord bot"

#

iara_why_sob

#

in all of the sdks docs

steady kite Sep 5, 2025, 2:13 PM

#

if my name was veld, I would create different API keys for different apps

#

that way you can share it to trusted individuals wihtout sharing your whole account

drowsy thistle Sep 5, 2025, 2:14 PM

#

me too

deft merlin Sep 5, 2025, 9:38 PM

#

You'll be given the <@&844267965742186619> or the <@&412346069675147264> role if you make a recognized contribution DoggThumbsUp

deft merlin Sep 5, 2025, 9:38 PM

#

deft merlin You'll be given the <@&844267965742186619> or the <@&412346069675147264> role if...

dense barn Sep 5, 2025, 9:55 PM

#

drowsy thistle will v1 be the same or can server owners retrieve API tokens from their top.gg s...

Yes

drowsy thistle Sep 5, 2025, 11:43 PM

#

Yes iara_nodnotes

dense barn Sep 6, 2025, 4:22 AM

#

API is live on test-top.gg

drowsy thistle Sep 6, 2025, 4:39 AM

#

poggythumbsup

#

will work on it next week

#

i need to finish this week's uni first

dense barn Sep 6, 2025, 4:44 AM

#

its also live on top.gg/api/v1/ now

drowsy thistle Sep 6, 2025, 4:45 AM

#

yipppeeeee

dense barn Sep 6, 2025, 4:46 AM

#

it would be nice if we could atleast update the node & python sdks sooner rather than later

drowsy thistle Sep 6, 2025, 4:46 AM

#

alr

#

working on it right now

dense barn Sep 6, 2025, 4:46 AM

#

im announcing the update in a few hours happy

#

just doing some final checks now

drowsy thistle Sep 6, 2025, 4:47 AM

#

so no more new endpoints?

dense barn Sep 6, 2025, 4:47 AM

#

two routes are available

drowsy thistle Sep 6, 2025, 4:47 AM

#

(that's what i meant in general)

#

god damn this internet sucks

dense barn Sep 6, 2025, 4:48 AM

#

POST /api/v1/projects/@me/commands

GET /api/v1/projects/@me/votes/:source_id?source=discord|topgg

drowsy thistle Sep 6, 2025, 4:48 AM

#

alr alr

dense barn Sep 6, 2025, 4:48 AM

#

any expected errors are passed through the problem+json spec

#

https://datatracker.ietf.org/doc/html/rfc7807

IETF Datatracker

RFC 7807: Problem Details for HTTP APIs

This document defines a "problem detail" as a way to carry machine- readable details of errors in a HTTP response to avoid the need to define new error response formats for HTTP APIs.

#

thank u null

#

I would recommend making a new class for v1 api clients btw

#

since they need a new token

drowsy thistle Sep 6, 2025, 4:49 AM

#

god damn

dense barn Sep 6, 2025, 4:49 AM

#

but any V0 api endpoints can be used for them still

drowsy thistle Sep 6, 2025, 4:49 AM

#

didn't you say that they were deprecated

dense barn Sep 6, 2025, 4:50 AM

#

they're not going away

drowsy thistle Sep 6, 2025, 4:50 AM

#

huh

dense barn Sep 6, 2025, 4:50 AM

#

the v0 api isnt being updated

drowsy thistle Sep 6, 2025, 4:50 AM

#

should the documentation state that they're deprecated

dense barn Sep 6, 2025, 4:50 AM

#

but the new tokens are recognized on the old api

#

no

drowsy thistle Sep 6, 2025, 4:50 AM

#

alright

dense barn Sep 6, 2025, 4:50 AM

#

we still support the API

drowsy thistle Sep 6, 2025, 4:50 AM

#

new tokens are not 100% relative to discord bots right

dense barn Sep 6, 2025, 4:50 AM

#

but we dont add new functionality to v0

drowsy thistle Sep 6, 2025, 4:50 AM

#

which means that server owners can have them

dense barn Sep 6, 2025, 4:50 AM

#

no, discord servers also have tokens

drowsy thistle Sep 6, 2025, 4:50 AM

#

nice nice

#

will reflect it on our docs

#

does it have the same structure?

dense barn Sep 6, 2025, 4:51 AM

#

wdym

drowsy thistle Sep 6, 2025, 4:51 AM

#

because we used to unpack its base64 to get the ID

dense barn Sep 6, 2025, 4:51 AM

#

nothing is different at all between bots and servers

#

what for?

drowsy thistle Sep 6, 2025, 4:51 AM

#

/bots/:id/stats

dense barn Sep 6, 2025, 4:52 AM

#

dense barn ``` POST /api/v1/projects/@me/commands ``` ``` GET /api/v1/projects/@me/votes/:...

you can use /bots/stats

drowsy thistle Sep 6, 2025, 4:52 AM

#

or something like that

dense barn Sep 6, 2025, 4:52 AM

#

i added that back

drowsy thistle Sep 6, 2025, 4:52 AM

#

that fails for tokens relative to discord servers right

dense barn Sep 6, 2025, 4:52 AM

#

yes

drowsy thistle Sep 6, 2025, 4:52 AM

#

good good

dense barn Sep 6, 2025, 4:52 AM

#

maybe

#

idk

#

lol

#

i would have to check

drowsy thistle Sep 6, 2025, 4:52 AM

#

should we refer to discord bots/servers as entities or as projects

dense barn Sep 6, 2025, 4:53 AM

#

projects

drowsy thistle Sep 6, 2025, 4:53 AM

#

alrighty

#

will work on it as soon as i can

#

(note that i have priorities atm so be patient, other developers are more than welcome to help!)

dense barn Sep 6, 2025, 4:54 AM

#

no worries

#

whenever u can

drowsy thistle Sep 8, 2025, 1:33 PM

#

@dense barn do you know why this is the case? i've already asked xiuh to give me the lib dev bot's v1 token

dense barn Sep 8, 2025, 1:37 PM

#

you're getting an error which does not give you json?

#

if (!res.ok) {
  throw new Error("Error updating commands: " + await rest.text());
}

...

drowsy thistle Sep 8, 2025, 1:41 PM

#

dense barn ``` if (!res.ok) { throw new Error("Error updating commands: " + await rest.te...

empty

dense barn Sep 8, 2025, 1:48 PM

#

do you have "Bearer" in front of ur token

#

AG_Susge

#

How do JSON Web Tokens work?
In authentication, when the user successfully logs in using their credentials, a JSON Web Token will be returned. Since tokens are credentials, great care must be taken to prevent security issues. In general, you should not keep tokens longer than required.

You also should not store sensitive session data in browser storage due to lack of security.

Whenever the user wants to access a protected route or resource, the user agent should send the JWT, typically in the Authorization header using the Bearer schema. The content of the header should look like the following:

Authorization: Bearer <token>

drowsy thistle Sep 8, 2025, 2:05 PM

#

dense barn do you have "Bearer" in front of ur token

no, legacy tokens used to work without Bearer

#

guess it's required now

#

does Bearer work with legacy tokens?

dense barn Sep 8, 2025, 2:09 PM

#

Yes, but i would recommend keeping legacy as-is

#

Bearer is required now yes

#

the new API will follow the spec for anything

drowsy thistle Sep 8, 2025, 2:53 PM

#

alrighty

#

will there be things like /servers/votes or /projects/votes?

dense barn Sep 8, 2025, 3:05 PM

#

projects can be anything

#

a project is a server

#

or a bot

#

or whatever else

drowsy thistle Sep 8, 2025, 3:10 PM

#

yeah

#

but /projects/ endpoints are not that much atm

drowsy thistle Sep 8, 2025, 3:31 PM

#

POST /v1/projects/@me/commands has been implemented to the Python SDK poggythumbsup

#

other SDKs have also saw several changes (see pins)

#

i'll continue tomorrow (or whenever i have time)

#

lots of TODOs plump_pain

drowsy thistle Sep 8, 2025, 4:09 PM

#

oh btw test-top.gg/api/v1/projects/@me/votes/asdf gives out 500 when it should've been a 400 error

drowsy thistle Sep 8, 2025, 4:12 PM

#

drowsy thistle will there be things like `/servers/votes` or `/projects/votes`?

oh wait i didn't realize test-top.gg/api/v1/projects/@me/votes existed dumb i'll switch over the SDKs to use this endpoint over /bots/check?userId=

dense barn Sep 8, 2025, 5:12 PM

#

drowsy thistle oh btw `test-top.gg/api/v1/projects/@me/votes/asdf` gives out 500 when it should...

yeah i think the validation right now throws an error instead

dense barn Sep 8, 2025, 5:13 PM

#

drowsy thistle oh wait i didn't realize `test-top.gg/api/v1/projects/@me/votes` existed <:dumb:...

actually -- dont move it over; it'll break for legacy tokens

#

make sure there's a V1Client instead if you havent already

drowsy thistle Sep 8, 2025, 5:14 PM

#

dense barn actually -- dont move it over; it'll break for legacy tokens

oh alright

#

creating a separate v1 client will take a while tho

dense barn Sep 8, 2025, 5:15 PM

#

how so

#

class V1Client (token: string) extends V0Client(token) {
updateCommands() { ... }
}

#

V0 api works with v1 token

drowsy thistle Sep 8, 2025, 5:15 PM

#

hmm

#

sure thing

dense barn Sep 8, 2025, 5:16 PM

#

to get the token version you can use this:

const checkTokenVersion = (token: string) => { 
  const segments = token.split(".");
  if (segments.length !== 3) {
    throw new Error("invalid token");
  }

  const data = JSON.parse(btoa(segments[1]));
  if ("_t" in data) {
    return "version 1";
  }

  if ("id" in data) {
    return "version 0";
  }

  throw new Error("invalid token");
};

drowsy thistle Sep 8, 2025, 5:16 PM

#

oooohh niceee!

dense barn Sep 8, 2025, 5:16 PM

#

id is present in both

#

but id in v1 token is the topgg id

#

not the discord id

drowsy thistle Sep 8, 2025, 5:17 PM

#

oh damn

#

what does /bots/.../stats use again

#

the legacy ones

#

do they use both

#

i forgot

dense barn Sep 8, 2025, 5:18 PM

#

wdym

drowsy thistle Sep 8, 2025, 5:20 PM

#

the optional bot IDs

drowsy thistle Sep 9, 2025, 4:47 AM

#

dense barn actually -- dont move it over; it'll break for legacy tokens

new tokens are still preferred right

#

so do you mind if i throw a warning whenever people use legacy tokens

drowsy thistle Sep 9, 2025, 5:15 AM

#

i could add checks so that new tokens use the new /v1/projects/@me/votes endpoint while legacy tokens use the older /bots/check?userId= endpoint

drowsy thistle Sep 9, 2025, 9:33 AM

#

drowsy thistle `POST /v1/projects/@me/commands` has been implemented to the Python SDK <:poggyt...

GET /v1/projects/@me/votes/:user_id has been implemented and tested on the Python SDK poggythumbsup

#

i replaced has_voted with get_vote

#

should be compatible with both legacy and new tokens

minor viper Sep 9, 2025, 10:27 AM

#

drowsy thistle `GET /v1/projects/@me/votes/:user_id` has been implemented and tested on the Pyt...

poggythumbsup

drowsy thistle Sep 9, 2025, 10:56 AM

#

drowsy thistle `POST /v1/projects/@me/commands` has been implemented to the Python SDK <:poggyt...

POST /v1/projects/@me/commands and GET /v1/projects/@me/votes/:user_id have been implemented on the Node.js SDK poggythumbsup

drowsy thistle Sep 9, 2025, 11:45 AM

#

both endpoints have been tested!

drowsy thistle Sep 9, 2025, 3:29 PM

#

both endpoints have been implemented on the Rust SDK poggythumbsup the latter has been tested. the former is yet to be tested.

minor viper Sep 9, 2025, 3:47 PM

#

Bro cooking

drowsy thistle Sep 9, 2025, 3:49 PM

#

nah i'm suffering

minor viper Sep 9, 2025, 3:50 PM

#

drowsy thistle nah i'm suffering

exactly.... KEKW same thing

dense barn Sep 10, 2025, 2:21 AM

#

Thanks, appreciated!! Prayge

#

The goat does it again

cunning locust Sep 10, 2025, 2:46 AM

#

we love nully

#

doing gods work

dense barn Sep 10, 2025, 3:38 AM

#

100%

drowsy thistle Sep 10, 2025, 4:38 AM

#

thank you so much y'all 😭 your words are way too kind hahaha

#

kittylove2

drowsy thistle Sep 10, 2025, 9:22 AM

#

drowsy thistle both endpoints have been implemented on the Rust SDK <:poggythumbsup:81901239303...

the former is finally successfully tested! this is legit probably the most complex test code i've ever written 😭

minor viper Sep 10, 2025, 10:42 AM

#

drowsy thistle the former is finally successfully tested! this is legit probably the most compl...

🔥 KEKW

drowsy thistle Sep 10, 2025, 1:39 PM

#

@steady kite changes are now live in https://github.com/null8626/node-sdk! kittypat

dense barn Sep 10, 2025, 1:58 PM

#

drowsy thistle <@884516044151083079> changes are now live in <https://github.com/null8626/node-...

@faint fern

dense barn Sep 10, 2025, 1:58 PM

#

drowsy thistle <@884516044151083079> changes are now live in <https://github.com/null8626/node-...

is this ready for PR?

drowsy thistle Sep 10, 2025, 1:59 PM

#

will need feedback first

#

is the latest version of the API final?

#

(aka you won't add more features for the time being)

dense barn Sep 10, 2025, 7:19 PM

#

the current feature cycle is done yes

#

i might add new features with new features or launches

drowsy thistle Sep 11, 2025, 8:35 AM

#

the C++ SDK has been updated and tested for the new v1 endpoints!

#

iaraThumbsUp

#

i'll update the documentation accordingly soon poggythumbsup

#

hey veld, do you mind if i incorporate the changes in your v1 pr in top-gg/docs to my fork?

faint fern Sep 11, 2025, 9:47 AM

#

drowsy thistle <@884516044151083079> changes are now live in <https://github.com/null8626/node-...

looks good to me

drowsy thistle Sep 11, 2025, 9:52 AM

#

poggythumbsup

dense barn Sep 11, 2025, 2:43 PM

#

drowsy thistle hey veld, do you mind if i incorporate the changes in your v1 pr in top-gg/docs ...

what does that mean?

#

are the changes PR'd?

#

I don't see any PRs open

drowsy thistle Sep 11, 2025, 2:44 PM

#

dense barn what does that mean?

i mean i'll add documentation for the v1 endpoints to my fork (https://github.com/null8626/docs)

dense barn Sep 11, 2025, 2:44 PM

#

uh go for it

#

but aren't those changes supposed to be derived from the main repo?

drowsy thistle Sep 11, 2025, 2:45 PM

#

yes

dense barn Sep 11, 2025, 2:45 PM

#

its quite out of sync already

#

maybe syncing it up would do good

drowsy thistle Sep 11, 2025, 2:45 PM

#

oh wait

#

i didn't realize that you've merged the pr

dense barn Sep 11, 2025, 2:45 PM

#

yes

#

it's all out

drowsy thistle Sep 11, 2025, 2:45 PM

#

i'll sync it soon

dense barn Sep 11, 2025, 2:45 PM

#

i did the launch a while back

#

docs are also on the docs.top.gg site already

drowsy thistle Sep 11, 2025, 2:46 PM

#

is it live on top.gg/api? not just test-top.gg/api

dense barn Sep 11, 2025, 2:46 PM

#

yes

drowsy thistle Sep 11, 2025, 2:46 PM

#

oh great

dense barn Sep 11, 2025, 2:46 PM

#

we launched

#

so it's all live

drowsy thistle Sep 11, 2025, 2:47 PM

#

nice

#

i'm currently updating my docs fork

#

so far it seems like the Node.js, Python, Rust, and C++ SDKs are ready

dense barn Sep 11, 2025, 2:47 PM

#

ok

#

can you PR them/

drowsy thistle Sep 11, 2025, 2:47 PM

#

as soon as i can

dense barn Sep 11, 2025, 2:48 PM

#

it would be beneficial to let people use them earlier rather than preparing every single one then all launching

steady kite Sep 11, 2025, 2:48 PM

#

what other languages need done?

drowsy thistle Sep 11, 2025, 2:48 PM

#

Lua, Java, Go, Ruby, C#, and PHP

dense barn Sep 11, 2025, 2:48 PM

#

it also avoids other people doing duplicate work if a PR is atleast open

drowsy thistle Sep 11, 2025, 2:48 PM

#

they are still stuck at v0 (on my forks at least)

drowsy thistle Sep 11, 2025, 2:49 PM

#

dense barn it would be beneficial to let people use them earlier rather than preparing ever...

yeah, i'll try releasing those 4 first before working on the remaining 6

#

(i also have uni)

steady kite Sep 11, 2025, 2:50 PM

#

ya don't have to do it yourself

#

ill get back to you on which ones I can do

drowsy thistle Sep 11, 2025, 2:50 PM

#

you know PHP right

steady kite Sep 11, 2025, 2:50 PM

#

haven't really done SDK's before only API's

#

yes

drowsy thistle Sep 11, 2025, 2:51 PM

#

wait wait lemme push my changes on my php fork

#

wait i'll work on it later, i gotta focus on these 4 first

#

sorry william ayaka_pray

steady kite Sep 11, 2025, 3:24 PM

#

Your good XD I can take a look

drowsy thistle Sep 11, 2025, 3:58 PM

#

alright all four's documentations (readmes and .mdx files for top-gg/docs) are done, working on finishing touches

#

also working on syncing my fork, this will take a bit

#

@dense barn so the old endpoints require /v0/ right?

dense barn Sep 11, 2025, 4:03 PM

#

no thats a docs link

drowsy thistle Sep 11, 2025, 4:04 PM

#

right

#

also just realized i forgot to work on the source query parameter for the 4 sdks dumb one sec guys

#

is the user source always accompanied by a snowflake?

#

thinking of making an enum for my rust sdk for this

#

something like ```rs
pub enum UserSource<I> {
Topgg(I),
Discord(I),
}

#

also this is non-exhaustive right

dense barn Sep 11, 2025, 4:23 PM

#

drowsy thistle also this is non-exhaustive right

this is all possible options for now.

drowsy thistle Sep 11, 2025, 4:23 PM

#

right

#

what do you think about that veld

#

should i treat it as an enum or as a variant

dense barn Sep 11, 2025, 4:24 PM

#

either is fine

drowsy thistle Sep 11, 2025, 4:24 PM

#

fair

drowsy thistle Sep 12, 2025, 5:04 AM

#

@dense barn hey uhm in top.gg/api legacy endpoints don't work with new tokens (with or without Bearer)

#

but test-top.gg/api works fine

dense barn Sep 12, 2025, 5:05 AM

#

Oh prolly my bad will update config

drowsy thistle Sep 12, 2025, 6:46 AM

#

drowsy thistle also just realized i forgot to work on the `source` query parameter for the 4 sd...

alright source has been implemented and tested for the 4 sdks and the documentation for the 4 sdks are done, which means all of them should be ready for release

#

now all that's left is to sync my top-gg/docs fork with the upstream commit and finalizing it

#

poggythumbsup

minor viper Sep 12, 2025, 8:16 AM

#

poggythumbsup bro cooking

#

KEKW

drowsy thistle Sep 12, 2025, 10:37 AM

#

hey @dense barn, i just found out that POST /v1/projects/@me/commands works with { name: '', description: null }

#

#

{} gives out 500

#

same goes for { description: 'test' }

#

you should add checks for these

dense barn Sep 12, 2025, 10:42 AM

#

Clueless just dont send bad data

drowsy thistle Sep 12, 2025, 10:43 AM

#

it's only that "" and an empty body give out 400 😭

#

is the validation just to check if the body is an array of objects or not?

#

i believe 500 should be reserved for unexpected errors, don't wanna send the wrong message to bot devs

drowsy thistle Sep 12, 2025, 11:14 AM

#

drowsy thistle now all that's left is to sync my top-gg/docs fork with the upstream commit and ...

alright, the documentation is complete! i'll make a pull request soon

#

iaraThumbsUp

drowsy thistle Sep 12, 2025, 11:31 AM

#

changes to the four SDKs are now pushed!

drowsy thistle Sep 12, 2025, 12:03 PM

#

@dense barn @steady kite

#

poggythumbsup

steady kite Sep 12, 2025, 12:05 PM

#

your amazing

drowsy thistle Sep 12, 2025, 12:06 PM

#

kittylove2

#

appreciate it!

drowsy thistle Sep 12, 2025, 12:39 PM

#

drowsy thistle <@121919449996460033> <@884516044151083079> - <https://github.com/top-gg/docs/pu...

cc @faint fern too

dense barn Sep 13, 2025, 12:53 AM

#

man these are some insanely large PRs for a route addition

#

why so many breaking changes on the node sdk

#

why didn't we just make a new class called ApiV1

#

why shoehorn it all into the same api client

dense barn Sep 13, 2025, 1:13 AM

#

I left comments on all of the SDK PR's

drowsy thistle Sep 13, 2025, 3:03 AM

#

will work on it

drowsy thistle Sep 13, 2025, 3:05 AM

#

dense barn why so many breaking changes on the node sdk

thought it'll be more appropriate to combine them (since i thought most bot devs would probably miss it or something), guess i'll use a child class now

dense barn Sep 13, 2025, 3:11 AM

#

Biggest thing is that there’s too many changes in one go

#

Would be awesome if we can merge the changes one by one instead of all in one go

#

It’s really hard to look at a pr that changes how releases work, tests are structured, docs are set up, and then also the separate features

drowsy thistle Sep 13, 2025, 3:13 AM

#

my bad

#

will do it next time

#

sorry veld

dense barn Sep 13, 2025, 3:13 AM

#

No need to apologise! I still really appreciate you taking the effort and ownership to handle this

drowsy thistle Sep 13, 2025, 5:16 AM

#

i am aware i am very much imperfect and this is a learning process for me, thanks!

#

kittysalute

#

for the python SDK pull request, i'll split my pull request into four pull requests:

the one that fixes/updates the v0 endpoints (also incorporates changes that make it compatible with newer python versions)
the one that adds v1 endpoints
the one that rewrites the readthedocs.io documentation
the one that rewrites the github actions

#

i'll do the same in subsequent pull requests, i hope it makes reviewing them easier for you

drowsy thistle Sep 13, 2025, 6:27 AM

#

drowsy thistle for the python SDK pull request, i'll split my pull request into four pull reque...

pull request 1 (of 4) is issued -> https://github.com/Top-gg-Community/python-sdk/pull/83

#

i could split it more if you think this is still too much ayaka_pray

#

for the C++ SDK pull request, i'll split my pull request into four pull requests:

the one that fixes/updates the v0 endpoints
the one that adds webhooks
the one that adds v1 endpoints
the one that adds tests

drowsy thistle Sep 13, 2025, 7:49 AM

#

drowsy thistle for the C++ SDK pull request, i'll split my pull request into four pull requests...

pull request 1 (of 4) is issued -> https://github.com/Top-gg-Community/cpp-sdk/pull/13

drowsy thistle Sep 13, 2025, 10:39 AM

#

pull request 2 (of 4) is issued -> https://github.com/Top-gg-Community/cpp-sdk/pull/15

#

there's not much going on in Rust SDK's pull request, do you mind if i split it into two batches (v0 and v1)?

drowsy thistle Sep 13, 2025, 12:05 PM

#

drowsy thistle there's not much going on in Rust SDK's pull request, do you mind if i split it ...

pull request 1 (of 2) is issued -> https://github.com/Top-gg-Community/rust-sdk/pull/30

dense barn Sep 13, 2025, 9:05 PM

#

drowsy thistle pull request 1 (of 4) is issued -> <https://github.com/Top-gg-Community/python-s...

this one still renames files that breaks all the actual reviewing

drowsy thistle Sep 14, 2025, 2:18 AM

#

dense barn this one still renames files that breaks all the actual reviewing

doesn't the Rust SDK does it as well?

dense barn Sep 14, 2025, 2:20 AM

#

it is able to find them as moves there

drowsy thistle Sep 14, 2025, 2:20 AM

#

ahhh

drowsy thistle Sep 14, 2025, 2:41 AM

#

done for the C++ one

#

can you check that one again? thanks

#

merged Rust SDK's pull request, now working on a second one.

drowsy thistle Sep 14, 2025, 6:32 AM

#

finished, i'll issue the pull request tomorrow

drowsy thistle Sep 14, 2025, 3:42 PM

#

since the other SDKs are virtually done v0-wise, i'll issue a pull request for all of them very soon

drowsy thistle Sep 15, 2025, 2:15 PM

#

to help everyone keep track of things, the list of pull requests is added to the google spreadsheet. it will be actively updated. see pins. poggythumbsup

pull requests under "Pending review" are in need of review.

drowsy thistle Sep 15, 2025, 3:13 PM

#

drowsy thistle finished, i'll issue the pull request tomorrow

done. https://github.com/Top-gg-Community/rust-sdk/pull/31

drowsy thistle Sep 15, 2025, 5:04 PM

#

the pull request for the Node.js SDK is also updated -> https://github.com/Top-gg-Community/node-sdk/pull/92

drowsy thistle Sep 16, 2025, 3:28 AM

#

drowsy thistle the pull request for the Node.js SDK is also updated -> <https://github.com/Top-...

breaking changes to webhooks reverted poggythumbsup

drowsy thistle Sep 16, 2025, 6:45 AM

#

issued a new pull request for the docs repo: https://github.com/top-gg/docs/pull/101

#

issued a new pull request for the Python SDK repo: https://github.com/Top-gg-Community/python-sdk/pull/84

drowsy thistle Sep 16, 2025, 8:53 AM

#

issued another new pull request for the Python SDK repo: https://github.com/Top-gg-Community/python-sdk/pull/85

drowsy thistle Sep 16, 2025, 2:10 PM

#

issued yet another new pull request for the Python SDK repo: https://github.com/Top-gg-Community/python-sdk/pull/86

drowsy thistle Sep 16, 2025, 2:39 PM

#

issued a new pull request for the Go SDK repo: https://github.com/Top-gg-Community/go-sdk/pull/13

drowsy thistle Sep 16, 2025, 2:55 PM

#

issued another new pull request for the Go SDK repo: https://github.com/Top-gg-Community/go-sdk/pull/14

drowsy thistle Sep 16, 2025, 3:16 PM

#

issued a new pull request for the .NET SDK repo: https://github.com/Top-gg-Community/dotnet-sdk/pull/30

drowsy thistle Sep 16, 2025, 3:38 PM

#

issued another new pull request for the .NET SDK repo: https://github.com/Top-gg-Community/dotnet-sdk/pull/31

drowsy thistle Sep 16, 2025, 5:33 PM

#

issued a new pull request for the Lua SDK repo: https://github.com/Top-gg-Community/lua-sdk/pull/4

drowsy thistle Sep 16, 2025, 5:58 PM

#

issued another new pull request for the Lua SDK repo: https://github.com/Top-gg-Community/lua-sdk/pull/5

minor viper Sep 17, 2025, 9:28 AM

#

drowsy thistle issued another new pull request for the Lua SDK repo: <https://github.com/Top-gg...

Bro is his own webhook notif poggythumbsup

dense barn Sep 17, 2025, 11:45 AM

#

drowsy thistle issued a new pull request for the docs repo: <https://github.com/top-gg/docs/pul...

MONKA

#

ah package lock

#

classic

drowsy thistle Sep 17, 2025, 11:46 AM

#

#

yes

#

just look at the diff in package.json

dense barn Sep 17, 2025, 11:46 AM

#

do you have a screenshot of the changes?

#

i see a light mode one

#

but not dark mode AG_Think

drowsy thistle Sep 17, 2025, 11:47 AM

#

dark mode in the older version?

dense barn Sep 17, 2025, 11:47 AM

#

in the PR

drowsy thistle Sep 17, 2025, 11:48 AM

#

oh sure

dense barn Sep 17, 2025, 11:48 AM

#

overall seems good tho

#

thanks!

drowsy thistle Sep 17, 2025, 11:48 AM

#

iaraThumbsUp

#

no worries!

drowsy thistle Sep 17, 2025, 11:50 AM

#

dense barn do you have a screenshot of the changes?

dense barn Sep 17, 2025, 11:51 AM

#

left one comment

drowsy thistle Sep 17, 2025, 11:51 AM

#

will check in a sec

dense barn Sep 17, 2025, 11:58 AM

#

https://github.com/Top-gg-Community/go-sdk/pull/13
commented

GitHub

feat: adapt to v0 by null8626 · Pull Request #13 · Top-gg-Communi...

The following pull request is a toned down version of #12. This pull request focuses solely on the changes done to the SDK in the v0 of the API. Such as:

Adapting the SDK to newer changes in v0 li...

dense barn Sep 17, 2025, 11:58 AM

#

drowsy thistle issued another new pull request for the Go SDK repo: <https://github.com/Top-gg-...

approved

dense barn Sep 17, 2025, 12:04 PM

#

drowsy thistle issued a new pull request for the .NET SDK repo: <https://github.com/Top-gg-Comm...

commented a better solution.

drowsy thistle Sep 17, 2025, 12:07 PM

#

sure

#

will work on it soon

#

i'll avoid renaming functions from now on, sorry

dense barn Sep 17, 2025, 12:09 PM

#

drowsy thistle issued another new pull request for the .NET SDK repo: <https://github.com/Top-g...

reviewed

#

all are reviewed

drowsy thistle Sep 17, 2025, 12:33 PM

#

thanks veld, will work on them as soon as i can

#

kittysalute

drowsy thistle Sep 17, 2025, 12:45 PM

#

dense barn reviewed

replied to some, can you check on this one? ^

dense barn Sep 17, 2025, 12:48 PM

#

replied

drowsy thistle Sep 17, 2025, 12:53 PM

#

thanks

drowsy thistle Sep 17, 2025, 1:10 PM

#

do you think old features (especially things like the old widgets and get_user) should be deprecated or removed?

dense barn Sep 17, 2025, 1:38 PM

#

mark them as deprecated but nothing else

drowsy thistle Sep 17, 2025, 1:41 PM

#

alright

drowsy thistle Sep 17, 2025, 2:37 PM

#

reverting changes will take a while, please be patient!

#

ayaka_pray

drowsy thistle Sep 17, 2025, 3:42 PM

#

this is taking a bit longer than expected. i'll work on other things first, sorry everyone!

drowsy thistle Sep 18, 2025, 8:13 AM

#

alright, reverting changes is done for the Rust SDK. it also has been linted via cargo check and cargo clippy. all that's left is to test it and double-check its documentation. poggythumbsup

drowsy thistle Sep 18, 2025, 8:37 AM

#

done: https://github.com/top-gg/docs/pull/101

drowsy thistle Sep 18, 2025, 8:56 AM

#

done: https://github.com/Top-gg-Community/dotnet-sdk/pull/31

drowsy thistle Sep 18, 2025, 10:33 AM

#

^ also done for #30, but it's not tested yet.

dense barn Sep 18, 2025, 10:44 AM

#

drowsy thistle done: <https://github.com/top-gg/docs/pull/101>

is fine but generally you dont want to set styles inside classes inside variables, now ur just complicating css again

#

- .GET {
-   --header-color: blue;
- }
+ --header-color-info: blue;
+ --header-color-danger: red;

drowsy thistle Sep 18, 2025, 10:46 AM

#

but the colors for GET and POST HTTP Headers are different, no?

dense barn Sep 18, 2025, 10:46 AM

#

yes but now you'll get this

#

lightmode:
  variable: 
    .GET:
      blue
    .POST:
      red
darkmode:
  ...

#

lots of complexity for a simple variable usage

#

you can set the variable in react to the static value

#

you already know the method here

#

so you can just set it to the correct variable as well

#

the variables will be reliant on CSS so there's no desync

#

for example: here's how dynamic colors work for top.gg:

#

#

variable is used to set a dynamic color based on the application state

#

then flattened so it's consistent everywhere

#

so if you're on dark mode, all colors will be on dark mode regardless of your theme

#

the components themselves have control over the visuals needing any race conditions on CSS-in-JS

#

aaaand that way there are also no re-renders in the react tree

#

because css is managed by the browser's DOM, not the react virtual tree

#

tl;dr keep color variables flat, use react to render which variables

#

don't mix concern of responsibilities

drowsy thistle Sep 18, 2025, 10:54 AM

#

alright poggythumbsup was planning to do that before this but worried it would somehow still desync

#

TIL

dense barn Sep 18, 2025, 10:55 AM

#

it shouldn't

#

just make sure not to reference the hook at all

#

we dont need it

drowsy thistle Sep 18, 2025, 11:09 AM

#

@dense barn done, is this right? https://github.com/null8626/docs/commit/06c9c84143079ae7ac0b5e278da5fd0cba5b51c8

dense barn Sep 18, 2025, 11:14 AM

#

That works yes

#

Can we remove the use colour mode hook now

drowsy thistle Sep 18, 2025, 11:17 AM

#

dense barn Can we remove the use colour mode hook now

done

#

also both pull requests for the .NET SDK should be resolved by now

drowsy thistle Sep 18, 2025, 2:07 PM

#

hey veld, can you check the docs pull request again? thanks

drowsy thistle Sep 18, 2025, 3:47 PM

#

breaking changes in the Node.js SDK reverted. it has been tested with npm run test. (for more info, see https://github.com/Top-gg-Community/node-sdk/pull/92#issuecomment-3308224964)

all that's left now is updating its README. poggythumbsup

drowsy thistle Sep 18, 2025, 5:15 PM

#

both of the Go SDK's pull requests' breaking changes have been reverted (with one exception) and can be reviewed!

#

iaraThumbsUp

drowsy thistle Sep 18, 2025, 5:49 PM

#

Lua SDK partially done -- working on reverting breaking changes tomorrow or next week.

harsh shore Sep 18, 2025, 10:14 PM

#

dense barn

Pretty blue gradient right there

drowsy thistle Sep 19, 2025, 4:20 AM

#

done (also already tested): https://github.com/Top-gg-Community/lua-sdk/pull/5

drowsy thistle Sep 19, 2025, 7:29 AM

#

done (also already tested): https://github.com/top-gg-Community/lua-sdk/pull/4

drowsy thistle Sep 19, 2025, 8:50 AM

#

@dense barn just making sure, is /bots deprecated or is it just the search parameter?

dense barn Sep 22, 2025, 7:15 AM

#

drowsy thistle <@121919449996460033> just making sure, is `/bots` deprecated or is it just the ...

no need to change anything

#

all of v0 is deprecated lol but we're not changing the api

#

my answer every time will be the same

#

"the current state is how it'll be"

#

no more. no less

drowsy thistle Sep 22, 2025, 7:17 AM

#

dense barn all of v0 is deprecated lol but we're not changing the api

i am aware of this, but it's clearly still working so i don't think it's going away any time soon

dense barn Sep 22, 2025, 7:18 AM

#

exactly

#

its not going to change

#

PI_ThumbsUp

#

so no need to change or depracte it

#

there will be an announcement when things get deprecated

drowsy thistle Sep 22, 2025, 7:19 AM

#

dense barn no need to change anything

i remember you stating that before the entirety of v0 is marked as deprecated, the /bots endpoint is deprecated (in the same vein as the user endpoint and legacy widget endpoints)

is deprecated here in the same vein as the deprecation of the entirety of v0?

dense barn Sep 22, 2025, 7:20 AM

#

i mean yeah but we dont change the client for that

#

its more of a line of thought where we arent changing v0 anymore ever

#

its legacy

#

no need to mark it as deprecated because it's not for user's pov

#

they use the endpoints and there are no alternatives so you can't deprecate the endpoint

#

neither is there plans to remove it

#

so just keep things are they are and focus on v1

drowsy thistle Sep 22, 2025, 7:22 AM

#

dense barn its more of a line of thought where we arent changing v0 anymore ever

changing and fixing right? because to my knowledge the search parameter of the /bots endpoint is no longer working as intended

dense barn Sep 22, 2025, 7:22 AM

#

yep no need to change it

drowsy thistle Sep 22, 2025, 7:23 AM

#

no need to change it iara_think_thonk

dense barn Sep 22, 2025, 7:23 AM

#

yes

drowsy thistle Sep 22, 2025, 7:23 AM

#

should i still mark it as deprecated

dense barn Sep 22, 2025, 7:23 AM

#

no

drowsy thistle Sep 22, 2025, 7:23 AM

#

damnit

dense barn Sep 22, 2025, 7:23 AM

#

we dont change the v0 api

#

so there's no need to change the v0 client

drowsy thistle Sep 22, 2025, 7:23 AM

#

guess most of the pull requests are back to WIP

#

plump_pain

#

working on them as soon as i can, thanks veld!

dense barn Sep 22, 2025, 7:23 AM

#

i mean it's been pretty consistent no

#

tears

drowsy thistle Sep 22, 2025, 7:23 AM

#

wdym

dense barn Sep 22, 2025, 7:24 AM

#

just pretend v0 doesnt exist anymore, it's an old api with buggy functionality

#

why waste time on it when the current apis for the routes work

#

people are using really only post-stats and the /vote one

drowsy thistle Sep 22, 2025, 7:24 AM

#

because i realized that in the latest version of the rust sdk i removed the get_bots function

#

there was a pull request for it and it got merged and everything

#

plump_pain

dense barn Sep 22, 2025, 7:25 AM

#

lol

drowsy thistle Sep 22, 2025, 7:25 AM

#

im unsure if i should bring it back

dense barn Sep 22, 2025, 7:25 AM

#

don't bother

drowsy thistle Sep 22, 2025, 7:25 AM

#

same goes for the get_users function

dense barn Sep 22, 2025, 7:25 AM

#

don't waste your time on it

drowsy thistle Sep 22, 2025, 7:25 AM

#

some of the sdks no longer have it (as in they are deleted)

#

i've been an advocate for consistency, guess you're not too serious on that kittysad

dense barn Sep 22, 2025, 7:26 AM

#

I'm an advocate on impact

drowsy thistle Sep 22, 2025, 7:26 AM

#

wait what about attributes like shards? should those be marked as deprecated?

#

because i'm sure the docs page will reflect this

dense barn Sep 22, 2025, 7:27 AM

#

drowsy thistle Sep 22, 2025, 7:27 AM

#

sooo i'm taking that as a no

#

sorry veld, thanks for clarifying

dense barn Sep 22, 2025, 7:28 AM

#

If you've done the work, we can merge and release it

#

but im more keen on getting command uploading across man

#

i dont really care about the v0 api because it's more of a thorn in our side atm

drowsy thistle Sep 22, 2025, 7:28 AM

#

kittysalute

#

but i thought the majority of bots still depend on them

#

but fairs fairs ig

dense barn Sep 22, 2025, 7:29 AM

#

yes and it works

#

and that's all it'll do

drowsy thistle Sep 22, 2025, 7:30 AM

#

i hope bot devs are not mad at my rust sdk cuz it does not have the get_bots endpoint even though it's there on the docs page 😭

#

okay nvm you know what i'm bringing em back

#

i couldn't stop thinking about the bot devs man plump_pain

#

i'm bringing the sdks back to when it had the most of the v0 features

drowsy thistle Sep 22, 2025, 1:00 PM

#

btw since you value impact, do you consider adding a parameter to a method as breaking? because some languages do not support optional arguments @dense barn

dense barn Sep 22, 2025, 1:18 PM

#

incremental changes are not breaking changes

#

if they do not support optional arguments we should use objects with optional properties instead

#

the highest impact thing the clients can do now is support v1

drowsy thistle Sep 22, 2025, 1:20 PM

#

alright

drowsy thistle Sep 22, 2025, 4:57 PM

#

alright, reverting has been done for the Rust SDK! poggythumbsup

so far, its api feature has been tested. other aspects such as its autoposter and webhooks are yet to be tested.

#

diff against an older commit can be seen here: https://github.com/Top-gg-Community/rust-sdk/compare/a7ed300e4a8ad62b4823aab84c2c59fd7bcaf955...null8626:rust-sdk:split/revert-v2

drowsy thistle Sep 23, 2025, 10:21 AM

#

after 6 hours of debugging the Rust SDK's doctests (including autoposters for both discord libraries) have finally been tested iara_yay

#

all that's left is to do test its webhooks and we should be good to go!

drowsy thistle Sep 23, 2025, 11:32 AM

#

axum webhook port tested poggythumbsup

drowsy thistle Sep 23, 2025, 12:38 PM

#

warp webhook port tested poggythumbsup

drowsy thistle Sep 23, 2025, 1:29 PM

#

rocket webhook port tested poggythumbsup

drowsy thistle Sep 23, 2025, 1:58 PM

#

actix-web webhook port tested poggythumbsup everything has been tested! expect a pull request coming up in a few moments!

#

debugging this SDK has made me nearly maxed out my laptop's storage several times lol

#

but at least every docstring example has been tested! BunNod

drowsy thistle Sep 23, 2025, 4:38 PM

#

DONE!!!! -> https://github.com/Top-gg-Community/rust-sdk/pull/32

#

iaraThumbsUp

drowsy thistle Sep 23, 2025, 5:20 PM

#

@dense barn regarding this (https://github.com/null8626/dotnet-sdk/commit/128cbedd58492433a07622a36a227e104127bf35#r166358039)

how would i achieve it? to my knowledge, BackgroundWorker demands a synchronous function

should i run a Task inside that work function?

dense barn Sep 23, 2025, 5:20 PM

#

read this: https://github.com/null8626/dotnet-sdk/commit/128cbedd58492433a07622a36a227e104127bf35#commitcomment-166358196

GitHub

refactor: use a BackgroundWorker · null8626/dotnet-sdk@128cbed

#

giggle_fluent my bad AG_Pray

drowsy thistle Sep 23, 2025, 5:21 PM

#

i read it directly from my github notifs so i was confused lmfao

#

ia_lul_haha

#

i'm gonna be mostly unavailable tomorrow, so i'll see if i could get last-minute fixes done at this hour (it's 12am)

drowsy thistle Sep 23, 2025, 7:00 PM

#

i'll work on updating it to use a timer tomorrow when i can!

drowsy thistle Sep 24, 2025, 4:43 AM

#

done! -> https://github.com/null8626/dotnet-sdk/commit/0bcec1cb760a0717028b43886a7f06613c33d6f3 (but not yet tested.)

drowsy thistle Sep 24, 2025, 4:37 PM

#

^ also done for .NET SDK's v0 revert branch. yet to be tested when i have time.

#

please be patient ayaka_pray so sorry for the delays everyone! i'm giving my best for all of this

copper oxide Sep 24, 2025, 4:41 PM

#

drowsy thistle please be patient <:ayaka_pray:871485500651872286> so sorry for the delays every...

you’re doing well!! good job!

drowsy thistle Sep 24, 2025, 5:33 PM

#

i'm taking a break from this so i can focus on uni until next week. the first half of this week has been non-stop SDK development lol kittysalute

copper oxide Sep 24, 2025, 5:34 PM

#

drowsy thistle i'm taking a break from this so i can focus on uni until next week. the first ha...

yeah ive seen you working a lott

#

good luck with uni!!

minor raft Sep 26, 2025, 10:09 AM

#

mcp server for top.gg api would be a great

#

idk if anyone else would use tho tbh but can be a feature for sure

chilly yacht Sep 26, 2025, 10:19 AM

#

i think the priority should be kept on what it currently is, such as stability and improvements rather than LLM buzz

drowsy thistle Sep 26, 2025, 10:19 AM

#

BunNod

dense barn Sep 26, 2025, 11:41 AM

#

minor raft Sep 26, 2025, 12:07 PM

#

true and it's understandable 😭

#

its just tools made easy for plug and play but that itself is annoying cuz theres loads of servers and the general ai users dont know how to set it up

dense barn Sep 26, 2025, 1:45 PM

#

😂 valid

minor raft Sep 26, 2025, 5:17 PM

#

ill make one anyway as i want my ai bot to suggest other bots if user asks 😅

dense barn Sep 26, 2025, 5:45 PM

#

oohh

#

that would be awesome :)

drowsy thistle Sep 29, 2025, 7:28 AM

#

alright, time to start working on testing the .NET SDK poggythumbsup

drowsy thistle Sep 29, 2025, 10:49 AM

#

the split/v0 branch has been tested! which means that it's now time to file a pull request iaraThumbsUp

#

-> https://github.com/Top-gg-Community/dotnet-sdk/pull/32

drowsy thistle Sep 29, 2025, 12:07 PM

#

hey @dense barn, can you check the pull request above again? i've responded to your comments

dense barn Sep 29, 2025, 12:09 PM

#

that's fine I would've preferred to do

public string SupportUrl { get; init; }
public string SupportInviteCode => SupportUrl;

but there's no real downside to your solution perf-wise

drowsy thistle Sep 29, 2025, 12:16 PM

#

dense barn that's fine I would've preferred to do ``` public string SupportUrl { get; ini...

i wanted to keep it consistent with the rest of the code, since most of the properties are just defined like that

dense barn Sep 29, 2025, 12:17 PM

#

yeah thats fine

drowsy thistle Sep 29, 2025, 12:19 PM

#

alright

#

now the pull request can be merged

#

(i don't have permissions to do it)

#

maybe you or faithie

dense barn Sep 29, 2025, 12:19 PM

#

done

drowsy thistle Sep 29, 2025, 12:19 PM

#

epic

drowsy thistle Sep 30, 2025, 5:09 AM

#

drowsy thistle done! -> <https://github.com/null8626/dotnet-sdk/commit/0bcec1cb760a0717028b4388...

tested!

@dense barn see https://github.com/Top-gg-Community/dotnet-sdk/pull/31

drowsy thistle Sep 30, 2025, 9:04 AM

#

most breaking changes have been reverted!! -> https://github.com/Top-gg-Community/go-sdk/pull/13 (this is also already tested btw.)

drowsy thistle Sep 30, 2025, 6:37 PM

#

currently reverting the breaking changes done on the C++ SDK, this will take a while, sorry!

drowsy thistle Oct 2, 2025, 6:28 AM

#

drowsy thistle currently reverting the breaking changes done on the C++ SDK, this will take a w...

changes reverted and tested for the v0 pull request!

#

iaraThumbsUp

drowsy thistle Oct 2, 2025, 8:37 AM

#

changes reverted and tested for the webhooks pull request!

#

the pull requests for the C++ SDK are now ready to be re-reviewed!

drowsy thistle Oct 2, 2025, 9:08 AM

#

now working on adding v1 functionalities to the .NET SDK poggythumbsup

#

and also maybe a dsharpplus adapter

#

(oh btw i just noticed that some of the .NET functions have inconsistencies like for example a method that does not end with Async is actually async notlikekomi )

drowsy thistle Oct 2, 2025, 11:25 AM

#

im gonna mark the old methods as obsolete and create an async version of them, because the method names can be misleading

#

also i just realized that the .NET SDK has never handled HTTP exceptions properly plump_pain

drowsy thistle Oct 2, 2025, 12:48 PM

#

drowsy thistle and also maybe a dsharpplus adapter

sadly to work on this and test the v1 branch, i would need for the discord.net adapter pull request to be merged kittysad

#

cuz otherwise it will be super messy

dense barn Oct 2, 2025, 12:52 PM

#

drowsy thistle sadly to work on this and test the v1 branch, i would need for the discord.net a...

then do it after the v1 changes

#

if you need the .net adapter first work on that first

#

get that merged first

#

then work on the next dependant

drowsy thistle Oct 2, 2025, 12:52 PM

#

alright

#

im pretty much done now, about to test it

#

but to test the post bot commands functionality, i would need to depend on a discord library because the raw functionality depends on an generic type which would be serialized to a JSON format. while i could theoretically create a mock application command class for this, that would be too complicated is it not?

#

wait i think i have a workaround for this, one sec

drowsy thistle Oct 2, 2025, 1:30 PM

#

alright, done!

#

iaraThumbsUp

#

@dense barn https://github.com/Top-gg-Community/dotnet-sdk/pull/33

#

other pull requests in the SDK are also available for review btw

drowsy thistle Oct 2, 2025, 5:24 PM

#

i'll focus on the documentation side of things tomorrow BunNod

drowsy thistle Oct 3, 2025, 2:59 PM

#

documentation for Rust, C++, Node.js, Go, .NET, and Lua SDKs is now complete!

TODO: document v1 features for the C++, Go, and Lua SDKs

drowsy thistle Oct 3, 2025, 5:46 PM

#

both pull requests that adds v1 functionality can now be reviewed (see pins)

drowsy thistle Oct 6, 2025, 6:10 PM

#

currently working on reverting breaking changes for the python sdk. this will take a while, please be patient!

broken frost Oct 6, 2025, 6:26 PM

#

i will not be patience

#

where update

drowsy thistle Oct 6, 2025, 6:57 PM

#

broken frost where update

oh well time to pull another all nighter

#

kittysad

drowsy thistle Oct 7, 2025, 1:32 PM

#

alright, i am finally done with porting its structures! now it's time to port its webhook and autoposter, this will take some time ayaka_pray

#

i'll work on it tomorrow! ayaka_pray

drowsy thistle Oct 8, 2025, 1:06 PM

#

alright, autoposter and webhook done! now it's time for make some finishing touches and finally start testing

drowsy thistle Oct 8, 2025, 4:31 PM

#

API methods and autoposter tested!

drowsy thistle Oct 8, 2025, 5:28 PM

#

webhook tested!

drowsy thistle Oct 9, 2025, 7:47 AM

#

alright, i'm pretty much done! i've split my changes into three pull requests (because previously the diff was really big):

the one that adapts it to the latest version of v0 (split/v0)
the one that simplifies its tests by reducing them into two files (split/tests)
the one that overhauls its readthedocs documentation (split/docs)

drowsy thistle Oct 9, 2025, 8:12 AM

#

for now, i'll issue the first two:

#

iaraThumbsUp

drowsy thistle Oct 9, 2025, 8:27 AM

#

alright, time to work on the Java SDK plump_pain

drowsy thistle Oct 9, 2025, 9:30 AM

#

drowsy thistle alright, time to work on the Java SDK <:plump_pain:791715169285570630>

most breaking changes reverted!

drowsy thistle Oct 9, 2025, 4:56 PM

#

alright, i've split my changes to three pull requests!

the one that adapts it to the latest version of v0 (split/v0)
the one that adds an autoposter functionality (split/autoposter)
the one that adds a webhooks wrapper for Spring Boot, Dropwizard, and Eclipse Jetty (split/webhooks)

drowsy thistle Oct 9, 2025, 5:06 PM

#

drowsy thistle alright, i've split my changes to three pull requests! - the one that adapts it...

#

alright, my job is done for the day proudkitty finally 😭

drowsy thistle Oct 9, 2025, 5:40 PM

#

i'll work on the Ruby SDK tomorrow! poggythumbsup

drowsy thistle Oct 10, 2025, 4:37 AM

#

breaking changes has been reverted and everything has been tested, it's time to work on adding v1 functionalities fastnod

drowsy thistle Oct 10, 2025, 6:29 AM

#

alright, everything has been tested!

drowsy thistle Oct 10, 2025, 7:34 AM

#

done!!!! https://github.com/top-gg-Community/ruby-sdk/pull/1

#

iaraThumbsUp

#

one SDK left proudkitty

drowsy thistle Oct 10, 2025, 9:35 AM

#

PHP SDK done! now it's time to test it BunNod

drowsy thistle Oct 10, 2025, 10:05 AM

#

alright, everything has been successfully tested!

drowsy thistle Oct 10, 2025, 10:51 AM

#

https://github.com/Top-gg-Community/php-sdk/pull/5

#

alright, i'm FINALLY done with every SDK!!! iara_yay kittyparty

#

now all that's left is to continue on with the pull requests BunNod

drowsy thistle Oct 10, 2025, 11:31 AM

#

god it feels so good to finally have a break proudkitty

kindred maple Oct 16, 2025, 4:02 AM

#

One message removed from a suspended account.

#

One message removed from a suspended account.

#

One message removed from a suspended account.

drowsy thistle Oct 16, 2025, 4:29 AM

#

kindred maple One message removed from a suspended account.

yeah

#

they made the channel open not too long ago

#

afaik they created a role that allowed people to send messages in this channel and added it to id:customize, i'm not sure if that role still exists

#

kinda sucks that i've been getting unrelated messages here :/

kindred maple Oct 16, 2025, 4:38 AM

#

One message removed from a suspended account.

drowsy thistle Oct 16, 2025, 4:40 AM

#

kindred maple One message removed from a suspended account.

i've checked the sniped messages, it's always deleted scam messages

kindred maple Oct 16, 2025, 4:41 AM

#

One message removed from a suspended account.

drowsy thistle Oct 16, 2025, 5:10 AM

#

@wraith pulsar

#

iara_yawn

#

another one

wraith pulsar Oct 16, 2025, 5:15 AM

#

DoggThumbsUp

drowsy thistle Oct 16, 2025, 5:18 AM

#

wraith pulsar <:DoggThumbsUp:1400113319905329264>

thank you so much bhai

#

you are the only mod i rely on when the others are asleep lol

#

kittypat

wraith pulsar Oct 16, 2025, 5:21 AM

#

no worries times zones are weird

drowsy thistle Oct 20, 2025, 4:53 PM

#

drowsy thistle god it feels so good to finally have a break <:proudkitty:1078343325754609714>

added and tested support for v1 in the C++ SDK!

#

iaraThumbsUp

#

now it's ready to be issued immediately once the v0 pull request is reviewed and merged

drowsy thistle Oct 21, 2025, 8:56 AM

#

every tests now work for the Python SDK!

#

poggythumbsup

#

https://github.com/Top-gg-Community/python-sdk/pull/88 is now closed. the SDK is to continue using pytest.

#

#87 has gotten pretty big (over 1,700 line diffs), i'm splitting it into three pull requests.

drowsy thistle Oct 21, 2025, 9:48 AM

#

two new pull requests from #87:

drowsy thistle Oct 21, 2025, 10:18 AM

#

added v1 support for the Python SDK! poggythumbsup

tawny nest Oct 21, 2025, 12:50 PM

#

Have / will the examples on the repo be updated?

drowsy thistle Oct 21, 2025, 1:41 PM

#

tawny nest Have / will the examples on the repo be updated?

of course

#

in fact i will rewrite the entire README and documentation

#

the former will apply to ALL SDKs

tawny nest Oct 21, 2025, 1:43 PM

#

yay

drowsy thistle Oct 21, 2025, 1:45 PM

#

@tawny nest the readme changes will be be carried over by the split/docs pull request, it will be issued once the split/v0 pull request is reviewed and merged

tawny nest Oct 21, 2025, 1:46 PM

#

thumb_derp

drowsy thistle Oct 21, 2025, 1:48 PM

#

i am briefly taking a break from the SDKs because i am not really in a good mental state right now, sorry everyone!

tawny nest Oct 21, 2025, 1:48 PM

#

mental and physical health always comes first

dense barn Oct 21, 2025, 4:20 PM

#

take care AG_Pray

drowsy thistle Oct 30, 2025, 9:53 AM

#

hey everyone, just wanted to let you all know that i should be able to return to this by mid-november. so sorry for the delay! ayaka_pray

supple nebula Nov 2, 2025, 12:47 AM

#

where can i get the src for top.gg

cunning locust Nov 2, 2025, 12:53 AM

#

supple nebula where can i get the src for top.gg

like... source code for the website?

supple nebula Nov 2, 2025, 12:58 AM

#

cunning locust like... source code for the website?

yuh

cunning locust Nov 2, 2025, 12:58 AM

#

thats not public

supple nebula Nov 2, 2025, 12:58 AM

#

cunning locust thats not public

thought so thanks

swift seal Nov 3, 2025, 7:12 PM

#

Hey, I would like to help every now and then with top.gg's lib for Go language, how do I get about it?

#

I'm a Go professional, core developer of one of discord libraries (officially confirmed by discord)

#

I don't know if I can send links here, if so tell me.

drowsy thistle Nov 3, 2025, 7:13 PM

#

hai! you can make a pull request, or dm one of the community managers to become one of the core maintainers and become a library developer (but in the end you still need to make changes via pull requests)

swift seal Nov 3, 2025, 7:21 PM

#

drowsy thistle hai! you can make a pull request, or dm one of the community managers to become ...

Got you, well pull request out of the blue might feel rude so let me try to DM first. Can I DM anyone? Let's say Marco Rennmaus or you have specific person in mind?

drowsy thistle Nov 3, 2025, 7:21 PM

#

huh really? to me it's not rude imo

#

feel free to make a pull request right away

#

but if you really wanna become the core maintainer, sure dm marco poggythumbsup

swift seal Nov 3, 2025, 7:22 PM

#

Well tbh. the Go version of top.gg lib feels abandoned so if I were to make any changes - I would likely try rewriting most of it, normally it's seen as very bad / rude.

#

Thing is, the way it is written is not very in Go style

#

It feels imported from somewhere else

drowsy thistle Nov 3, 2025, 7:23 PM

#

i understand, many of the other SDKs are abandoned as well

#

i've been updating most of them for the past month plump_pain

#

i have a pull request on the Go SDK that updates it to the latest API's changes, but feel free to rewrite it poggythumbsup

swift seal Nov 3, 2025, 7:23 PM

#

Does top.gg API actually has so many changes to track? I thought it's like 1-2 pull requests a month and it should be golden with how slowly things move around top.gg I see.

drowsy thistle Nov 3, 2025, 7:24 PM

#

kinda

#

i'm sure Veld is fine with you rewriting things, just make sure that you DO NOT make breaking changes

#

unless you make it a major release, but i don't think he's too keen on that atm

swift seal Nov 3, 2025, 7:25 PM

#

Do we get some testing api keys for automated test cases?

drowsy thistle Nov 3, 2025, 7:25 PM

#

yes

swift seal Nov 3, 2025, 7:25 PM

#

Then it should be fine if I can setup maybe some github workflow tests

drowsy thistle Nov 3, 2025, 7:25 PM

#

feel free to request a community manager for this bot's API token https://top.gg/bot/1026525568344264724

swift seal Nov 3, 2025, 7:26 PM

#

Gotcha, I'll try talking to Marco and we'll see.

drowsy thistle Nov 3, 2025, 7:26 PM

#

kittysalute

#

i dmed Xiuh for the token but i think you can dm marco too

swift seal Nov 3, 2025, 7:26 PM

#

Oh... should I rather talk with Xiuh then? To not confuse them more

#

He was helping on my other ticket just few min ago

drowsy thistle Nov 3, 2025, 7:27 PM

#

sure

#

also *she

swift seal Nov 3, 2025, 7:28 PM

#

mb

swift seal Nov 3, 2025, 8:19 PM

#

Hey @drowsy thistle could you link me the current, most up to date Top.gg API docs? It seems broken / incomplete what I found:

#

I would like to avoid having to scavenge throught other language libraries to reverse engineer endpoints and models...

drowsy thistle Nov 3, 2025, 8:23 PM

#

swift seal Hey <@661200758510977084> could you link me the current, most up to date Top.gg ...

well, this is the docs as is

chilly yacht Nov 3, 2025, 8:23 PM

#

Those are the most recent ones

#

https://docs.top.gg/docs/API/v0/user
https://docs.top.gg/docs/API/v0/bot

if you're searching that

drowsy thistle Nov 3, 2025, 8:24 PM

#

the latest version API is in docs.top.gg, it's just that it is not that well written atm imo

swift seal Nov 3, 2025, 8:24 PM

#

Hmmm...... they are totally not in sync with my old go sdk I just cloned

drowsy thistle Nov 3, 2025, 8:24 PM

#

i have a docs pull request that overhauls it coming up

swift seal Nov 3, 2025, 8:25 PM

#

drowsy thistle the latest version API is in docs.top.gg, it's just that it is not that well wri...

I use that right but but please tell me why there's v0 and why v0 and v1 seems to operate on objects / models that are not documented under models/ ? It's really confusing from outside.

drowsy thistle Nov 3, 2025, 8:26 PM

#

okay so

#

user source is essentially an enum

#

you can use this in the query param for the API endpoint that mentions it

#

both API versions are basically the same in terms of input/output types

drowsy thistle Nov 3, 2025, 8:28 PM

#

drowsy thistle user source is essentially an enum

the value can be "topgg" or "discord"

#

try it out with top.gg and discord IDs and see what happens

swift seal Nov 3, 2025, 8:29 PM

#

Ok, so for now - would it be correct to call it all as just v1 and have 3 API segments:

/bots (strict rate limits)
/users (regular rate limits)
/projects (strict rate limits)

drowsy thistle Nov 3, 2025, 8:30 PM

#

no not really

#

/projects is v1

swift seal Nov 3, 2025, 8:30 PM

#

I'm also currently crafting logic for rate limiter

drowsy thistle Nov 3, 2025, 8:30 PM

#

/bots and /users are v0

#

which is technically deprecated but will remain supported

swift seal Nov 3, 2025, 8:32 PM

#

Well, you see this is confusing because if v0 is deprecated -> this technically means any new code should ignore it / omit it, so logically I should only handle v1 but from what I see it only supports setting slash commands right now to be displayed so... developers using this library would have no control regarding bots/users?

#

Or no wait

#

https://top.gg/api/v1/projects/@me/votes/:user_id exists

drowsy thistle Nov 3, 2025, 8:33 PM

#

what Veld's view on this is, v0 is technically deprecated BUT all SDKs should not mark it as so, it's just that it will NOT be maintained anymore.

#

therefore libraries should not mark them as depecated or dismiss them entirely

#

because of this he is opposed on breaking changes

#

and instead encourage lib devs to extend their sdks to add v1 support

#

(and also fix existing bugs, but thats not his priority rn)

swift seal Nov 3, 2025, 8:34 PM

#

Hmm... got it but it's very confusing way of doing things, it's against any normal practices...

v1 alone as is - is not really usable on it's own from what I see, so v0 support is a must anyway

drowsy thistle Nov 3, 2025, 8:34 PM

#

thousands of bots depend on top.gg's sdks, and i kinda understand him

#

he doesnt wanna upset the bot dev community

swift seal Nov 3, 2025, 8:35 PM

#

Well, many things must keep backward compatibility, that's fine on it's own, just calling it v0 + @deprecated is weird

#

Anything under v1 is usually considered experimential, not production ready, comes with no promises whatsoever.

drowsy thistle Nov 3, 2025, 8:35 PM

#

it's just that it's unmaintained indefinitely, existing bugs on v0 will remain forever

swift seal Nov 3, 2025, 8:36 PM

#

Ok, I'll try adding commets to each method signaling which API version it uses.

drowsy thistle Nov 3, 2025, 8:36 PM

#

most of v0 still work, you should not dismiss them

#

sagu honestly i did this too when v1 was announced, i rehashed many of my SDKs, and Veld was not happy with that

swift seal Nov 3, 2025, 8:37 PM

#

Are those object descriptions in docs 100% up to date?

drowsy thistle Nov 3, 2025, 8:37 PM

#

yes

#

you can make a request to the API to double check tho

drowsy thistle Nov 3, 2025, 8:38 PM

#

drowsy thistle yes

*or actually almost if we're talking docs on the v0 endpoints, my bad.

swift seal Nov 3, 2025, 8:38 PM

#

drowsy thistle you can make a request to the API to double check tho

Would rather avoid that... it costs a bunch of time but also I have no guarantee I won't miss some optional field that just won't appear in my case.

drowsy thistle Nov 3, 2025, 8:39 PM

#

i understand

swift seal Nov 3, 2025, 8:39 PM

#

Let me create what's available in documentation for now and cry later when things fail

drowsy thistle Nov 3, 2025, 8:39 PM

#

if you want a frame of reference, see my python SDK

#

it does not have v1 atm but it has the newest version of v0

swift seal Nov 3, 2025, 8:40 PM

#

It sounds so bad: latest version of v0

#

on so many levels

#

but it is what it is

drowsy thistle Nov 3, 2025, 8:40 PM

#

well, i am working on them

#

and i am waiting for Veld to review all of my pull requests lol

#

or Luke

#

but days has passed

swift seal Nov 3, 2025, 8:41 PM

#

I warned Xiuh I'm gonna drop a pull request with like 3k lines of code at once

#

to not be scared

drowsy thistle Nov 3, 2025, 8:41 PM

#

uh

#

Veld had advised me that it's better for me to split big diff pull requests

#

reviewing 3k diffs is not fun

swift seal Nov 3, 2025, 8:41 PM

#

Go lib version is absurdly behind and weirdly made for Go standards so it's really a good idea to rewrite most/all of it.

drowsy thistle Nov 3, 2025, 8:42 PM

#

but in your context, maybe he'll be fine with it idk

swift seal Nov 3, 2025, 8:42 PM

#

I'll be good and create some basic skelet of docs and testing

#

should be fine I hope

swift seal Nov 3, 2025, 8:43 PM

#

drowsy thistle reviewing 3k diffs is not fun

commits will have to do

#

it wouldn't pass tests when I'm rewriting nearly everything and I was now to split whole rewrite into few pull requests

drowsy thistle Nov 3, 2025, 8:45 PM

#

good luck!

swift seal Nov 3, 2025, 8:48 PM

#

@drowsy thistle unclear:

bot.defAvatar ?string | "The cdn hash of the bot's avatar if the bot has none"

#

Do you mean the cdn of the discord automatic avatar (one of five) when bot has no avatar?

#

The description makes no sense

drowsy thistle Nov 3, 2025, 8:49 PM

#

defavatar is deprecated

#

avatar also now holds the ENTIRE url, not just the hash

#

how the go sdk docs was worded was kinda wack

swift seal Nov 3, 2025, 8:50 PM

#

It's not just go sdk, same naming is in docs

drowsy thistle Nov 3, 2025, 8:51 PM

#

yeah i understand

#

some parts of these dated years ago

swift seal Nov 3, 2025, 9:17 PM

#

@drowsy thistle it's not completed, I'm heading to sleep for today but leave me info if using this kind of naming is fine. Default, raw values in API are commonly misleading without context so I modified few field names to better match + add some description. Also gotta love even API sometimes uses snake_case just for other time to use camelCase...

#

Also why docs says server & shard counts may be empty/omitted? It doesn't really make sense, I did few test API searches and every single bot appears to have those fields defined.

dense barn Nov 5, 2025, 1:39 PM

#

drowsy thistle what Veld's view on this is, v0 is technically deprecated BUT all SDKs should no...

V0 needs to continue to be supported because V1 doesn't contain all api endpoints to cover the full API yet. But, people already built integrations on top of V0 so it makes zero sense to change V0 in any capacity.

dense barn Nov 5, 2025, 1:40 PM

#

swift seal Anything under v1 is usually considered experimential, not production ready, com...

V0 is just what I called it because the API really just wasn't good. V1 is my setup for an actual strong standing, strongly typed API

#

v0 is not deprecated. but it is not getting any more support.

#

v1 is the current recommended API

drowsy thistle Nov 5, 2025, 3:47 PM

#

ohhh

#

i was a bit confused because #topgg-open-source message

dense barn Nov 5, 2025, 5:07 PM

#

yeah there's no need to mark it as deprecated because in a sense v0 is no longer going to be updated from an API endpoint so whatever is there now will be there until it shuts down

#

if the client supports something it shouldn't it can safely be ignored and focus for libraries should be on building v1's clients

drowsy thistle Nov 5, 2025, 5:08 PM

#

true

swift seal Nov 7, 2025, 3:30 PM

#

Got some time on my hand lol, holidays

drowsy thistle Nov 7, 2025, 3:30 PM

#

yipppeeeee

swift seal Nov 7, 2025, 3:30 PM

#

Bot.vanity?

#

It doesn't seem to exist anymore?

#

I do test API requests with testing token but I got 0 bots with vanity field

drowsy thistle Nov 7, 2025, 3:31 PM

#

yea

#

vanity is a feature exclusively for certified bots, bot certification was removed a looong time ago

swift seal Nov 7, 2025, 3:32 PM

#

bot.donatebotguildid?

swift seal Nov 7, 2025, 3:32 PM

#

drowsy thistle vanity is a feature exclusively for certified bots, bot certification was remove...

ok, so certifiedBot is also invalid? got it

drowsy thistle Nov 7, 2025, 3:33 PM

#

yes

swift seal Nov 7, 2025, 3:33 PM

#

Pls tell me if that matches up to date standards

#

I had to get bit creative with naming because what API uses in field values is really random

drowsy thistle Nov 7, 2025, 3:34 PM

#

i'll check when i'm available

#

i'm very busy right now

#

maybe veld will

#

or someone else

swift seal Nov 7, 2025, 3:40 PM

#

Hmmm

#

Could someone confirm if https://top.gg/api/bots/:bot_id/stats endpoint works properly?

#

I tried my own bot and got back:

{
    "server_count": 2,
    "shards": [],
    "shard_count": null
}

But it should say servers: 0 as I never published this data

#

Confused why it got 2

drowsy thistle Nov 7, 2025, 3:43 PM

#

yes

#

i tested the post stats endpoint by posting {"server_count":2} often

swift seal Nov 7, 2025, 3:43 PM

#

#

I tested fiew servers

#

bots*

#

It always shows the same response and is quite slow

drowsy thistle Nov 7, 2025, 3:44 PM

#

oh

#

then i don't know

#

i've always used {"server_count":2} for the lib dev bot (1026525568344264724)

swift seal Nov 7, 2025, 3:45 PM

#

Could it be that it just totally ignores what's in uri and targets bot from where it has auth token?

#

@deft merlin could we get clarification? I assume you have access to API spec details.

deft merlin Nov 7, 2025, 3:56 PM

#

nah you'll have to talk to @dense barn

swift seal Nov 7, 2025, 3:56 PM

#

Also

deft merlin Nov 7, 2025, 3:56 PM

#

im not a technical resource hehe

swift seal Nov 7, 2025, 3:56 PM

#

https://top.gg/api/bots/:bot_id/votes is also broken

#

It even ends up getting 200 OK answer with empty [] array if data is invalid

#

It should never happen

#

It's all coming from v0 category so I'm confused if I should implement it knowing it's broken anyway or don't bother and ignore altogether...

drowsy thistle Nov 7, 2025, 3:58 PM

#

deft merlin im not a technical resource <:hehe:469467884457033728>

xiuh can you teach me how to build a bot list /s

dense barn Nov 7, 2025, 3:59 PM

#

swift seal It even ends up getting 200 OK answer with empty [] array if data is invalid

shards is no longer at all used

#

i think we still read the data if sent and aggregate it, but we dont store them individually

swift seal Nov 7, 2025, 3:59 PM

#

Could we maybe get some list which endpoints works / partially / not at all?

dense barn Nov 7, 2025, 3:59 PM

#

for backporting purposes

swift seal Nov 7, 2025, 4:00 PM

#

Well, if I'm about to rewrite whole lib then I won't held back

dense barn Nov 7, 2025, 4:00 PM

#

V1 is what's new

#

I would recommend using that

swift seal Nov 7, 2025, 4:00 PM

#

Yeah but you said it yourself quite a bit of stuff exists in v0 only

dense barn Nov 7, 2025, 4:00 PM

#

For stats, only server_count matters and should be used moving forward

swift seal Nov 7, 2025, 4:01 PM

#

swift seal Pls tell me if that matches up to date standards

Ok, could I get confirmation if that's correct? Those tables in docs website are outdated af

dense barn Nov 7, 2025, 4:02 PM

#

ApprovalDate is actually creation date iirc

#

Library is not stored anymore so dont include it in the library you're writing

swift seal Nov 7, 2025, 4:02 PM

#

I can rename it but it might be misleading*

#

By creation date insdie bot object, people might think it means when bot was created in general sense

dense barn Nov 7, 2025, 4:03 PM

#

OwnerIDs is currently a mix of top.gg IDs and discord IDs

swift seal Nov 7, 2025, 4:03 PM

#

Well, I used Discord valid uint64 snowflake

dense barn Nov 7, 2025, 4:03 PM

#

in the UI we only accept both, but, will always map them to our internal IDs

#

FeaturedGuildIDs we don't expose in the API afaik

drowsy thistle Nov 7, 2025, 4:03 PM

#

swift seal I can rename it but it might be misleading*

for my sdks, i added a new property approved_at and marked the former as deprecated

dense barn Nov 7, 2025, 4:04 PM

#

we don't display approval date tho?

swift seal Nov 7, 2025, 4:04 PM

#

#

Yeah, API sends empty array

drowsy thistle Nov 7, 2025, 4:04 PM

#

oh wait what

dense barn Nov 7, 2025, 4:04 PM

#

it's created at date

#

when the user submits the draft to top.gg

#

ShardCount should be removed

#

other than that lgtm

swift seal Nov 7, 2025, 4:06 PM

#

#

Correct?

dense barn Nov 7, 2025, 4:06 PM

#

feel free to also PR those fields out of docs tbh

#

yep lgtm

swift seal Nov 7, 2025, 4:06 PM

#

dense barn feel free to also PR those fields out of docs tbh

I may try in future but I'm limited with my time, I'll try to help regarding Go lib but I cannot do any promises.

#

I might do huge PR in 3 days or in 2 months

#

Realistically

dense barn Nov 7, 2025, 4:06 PM

#

for reference

#

here's our legacy backporting function:


export const createLegacyApiSchema = (b: LegacyApiItemFragment): LegacyApiBot => {
  return {
    invite: b.__typename === "DiscordBot" ? (b.inviteUrl ?? undefined) : undefined,
    website: b.socials.find((s) => s.type === SocialPlatformType.Website)?.url,
    support: b.socials.find((s) => s.type === SocialPlatformType.Discord)?.url,
    github: b.socials.find((s) => s.type === SocialPlatformType.Github)?.url,
    longdesc: b.longDescription,
    shortdesc: b.shortDescription,
    prefix: b.__typename === "DiscordBot" ? b.prefix : undefined,
    lib: "",
    clientid: b.__typename === "DiscordBot" ? b.applicationId : undefined,
    avatar: b.iconUrl,
    id: b.externalId,
    username: b.name,
    date: b.createdAt,
    server_count: b.socialCount ?? 0, // eslint-disable-line camelcase
    shard_count: 0, // eslint-disable-line camelcase
    guilds: [],
    shards: [],
    monthlyPoints: b.votes,
    points: b.totalVotes,
    certifiedBot: false,
    owners: b.owners
      .map((o) => o.connections.find((x) => x.type === "discord")?.id)
      .filter((x) => x != null),
    tags: b.tags.map((t) => t.slug),
    reviews: {
      averageScore: b.reviewStats.averageScore > 0 ? b.reviewStats.averageScore / 20 : 0,
      count: b.reviewStats.reviewCount,
    },
    bannerUrl: b.__typename === "DiscordBot" ? (b.backgroundUrl ?? undefined) : undefined,
  };
};

#

^ turns out we do backport them to discord IDs so i guess there's that

drowsy thistle Nov 7, 2025, 4:08 PM

#

i swear i remember someone saying that the date property is when the bot was approved 😭 time to change it on every sdk i've worked on

swift seal Nov 7, 2025, 4:08 PM

#

I also believe it's when it was approved by top.gg

dense barn Nov 7, 2025, 4:08 PM

#

 date: b.createdAt,

drowsy thistle Nov 7, 2025, 4:08 PM

#

i know

#

not now

dense barn Nov 7, 2025, 4:08 PM

#

might've been i wouldn't know

#

it's been like this for a long long time tho

drowsy thistle Nov 7, 2025, 4:09 PM

#

i know

dense barn Nov 7, 2025, 4:09 PM

#

since i haven't touched it since the last time i fixed bugs for it

swift seal Nov 7, 2025, 4:09 PM

#

dense barn here's our legacy backporting function: ```ts export const createLegacyApiSche...

Not using at least TS here is a crime tbh

dense barn Nov 7, 2025, 4:09 PM

#

?

#

it is typescript lol

#

it's actually very strictly typed

swift seal Nov 7, 2025, 4:10 PM

#

lol my bad then, it was some time since I got free of any javascript/typescript in our codebases and I forgot how messy it was

dense barn Nov 7, 2025, 4:10 PM

#

everything here is a type narrower

swift seal Nov 7, 2025, 4:10 PM

#

I thought at first API was slow as server is dying

#

But if it's JS based then it would make sense :/

dense barn Nov 7, 2025, 4:11 PM

#

swift seal Nov 7, 2025, 4:11 PM

#

dense barn here's our legacy backporting function: ```ts export const createLegacyApiSche...

I don't know larger canvas but having some map/set and calling .find() method each time is suicidal for performance.. especially when it has lots of elements - just heads up

dense barn Nov 7, 2025, 4:12 PM

#

it wont have a lot of elements

#

max 5

swift seal Nov 7, 2025, 4:15 PM

#

dense barn here's our legacy backporting function: ```ts export const createLegacyApiSche...

Yeah, just saying, just in single return - single call you do at minimum 7 for loops in this piece of code

#

Where it likely can be limited down to 1, maybe 2

#

And in case of JS it means new stack calls, etc.

dense barn Nov 7, 2025, 4:17 PM

#

its really trivial

#

these are micro-optimizations of nanoseconds

swift seal Nov 7, 2025, 4:21 PM

#

dense barn these are micro-optimizations of nanoseconds

Both yes and no... I won't attack you about it or anything, just saying there's lots of hot spots blatantly on view.

While in a test case it's just a few nanoseconds or like 1ms, at scale it can quickly grow, especially in case it's single threaded. V8 uses IO loop (async/await stuff) but it's still ultimately bound to single core. V8 allows for child processes (aka threads) but they are very heavy, hard to use well.

Also it probably hits your GC like crazy, you create & instantly drop a bunch of stack frames and variables so my assumption is it makes GC way more frequent than it needs to be.

dense barn Nov 7, 2025, 4:22 PM

#

why would it hit my GC, im iterating over a list of references

#

we currently run 250 requests per seconds on three tiny machines, i think perf is fine for the website :p

#

opportunity cost is higher than to refactor legacy apis

swift seal Nov 7, 2025, 4:24 PM

#

dense barn opportunity cost is higher than to refactor legacy apis

I don't have all the data but yeah, moving fast is commonly more worth

swift seal Nov 7, 2025, 4:24 PM

#

dense barn why would it hit my GC, im iterating over a list of references

Because you call new functions, they allocate blocks of memory, shuffle addresses, etc. generally do a lot of stuff that is really pointless for such simple stuff - then GC has to mark & sweep them.

#

Calling functions is not free, especially in interpreted languages

#

Also as you use map/set, you likely want to access data via key, otherwise use arrays because data is then allocated next to each other, resulting in way faster for loops

#

Map can store data that can be all over the place, making memory lookups take longer time

dense barn Nov 7, 2025, 4:27 PM

#

While what you're saying is true, it doesn't work for my usecase

#

Maps aren't serializable

swift seal Nov 7, 2025, 4:37 PM

#

dense barn we currently run 250 requests per seconds on three tiny machines, i think perf i...

btw. that... I have no idea of all the inner workings but it sounds crazy. Like if you render in real time som graphics and return then it's fine but for Rest API that accepts some json body, does bit of processing and returns other json - it sounds crazy.

dense barn Nov 7, 2025, 4:39 PM

#

its the entire react web server

swift seal Nov 7, 2025, 4:39 PM

#

For example, our work services are made in Go but a single docker container with 1GB ram, 2vCPUs locked at 3GHz & 1gbps connection (2 sides) - it's able to handle about 60k req/sec

#

Ah, so the website and API are same codebase?

#

It runs as single process?

#

I guess it's fine... like react and fast are opposite words lol

dense barn Nov 7, 2025, 4:40 PM

#

basically

#

hence why legacy api

#

new api runs on aspnet

swift seal Nov 7, 2025, 4:40 PM

#

I have no idea about C# stuff

dense barn Nov 7, 2025, 4:40 PM

#

C# fast

swift seal Nov 7, 2025, 4:41 PM

#

I know it's reasonably fast

#

Just don't know any details

dense barn Nov 7, 2025, 4:41 PM

#

yeah fair

#

@true sinew is my C# goat when it comes to internals

swift seal Nov 7, 2025, 4:41 PM

#

Ye, well I do Go, Rust, C

#

Rarely TS if must

drowsy thistle Nov 7, 2025, 4:42 PM

#

based stack

swift seal Nov 7, 2025, 4:42 PM

#

Used to use TS way more back in the day but Go is just too good

#

It just works and is 5-10x faster just by being here lmao

drowsy thistle Nov 7, 2025, 4:43 PM

#

both are cool, plan to use one of them in the future

swift seal Nov 7, 2025, 4:43 PM

#

Yeah, well if you don't need to do front end stuff, you basically always want Go between it and TS.

#

It's like free upgrade

#

If you know TS well, moving to Go is simple

dense barn Nov 7, 2025, 4:44 PM

#

tried go

#

its ok

#

prefer C#

swift seal Nov 7, 2025, 4:44 PM

#

I never tried C# so idk, only know that after Java I have PTSD with classes

#

Yes, I would love 7th deep class inheritance

drowsy thistle Nov 7, 2025, 4:45 PM

#

C# and Go are equally cool, love both

dense barn Nov 7, 2025, 4:46 PM

#

meh, you dont need inheritance for web services

#

i barely use inheritance

swift seal Nov 7, 2025, 4:46 PM

#

I use Go for nearly everything nowadays as my "go to" language, not just some web servers

#

Obviously don't do super low level drivers or databases in it - althought you can if people do similar shit in Java..

#

But it's fully capable as backend for some apps, game server, etc.

dense barn Nov 7, 2025, 4:47 PM

#

yep

#

its what its designed for

swift seal Nov 7, 2025, 4:48 PM

#

Yeah, coolest part is that how freaky simple it is to start - like imagine teaching junior Go vs C++ now

#

Sure C++ in good use can be faster but honestly not all that much

#

Good Go code can get like I would say to even 90% of what good C++ code can achieve

#

But you'll pay a lot of time and sanity to do C++ good code*

#

C# I've also heard it is rather easy to pick up, just similarly to Java it is bloated with a lot of patterns, specific expectations how to code...

drowsy thistle Nov 7, 2025, 4:51 PM

#

i don't really compare languages lately, imo it depends on the ecosystem, if it has the crucial things i need for my project, i'll use it

swift seal Nov 7, 2025, 4:51 PM

#

Yeah, for the most part I use it as tools

#

After all that's what they are

#

Just pick a correct tool for the job

#

Just never cry later when someone picks rust and is now behind with competition because it takes ages to make new features or when you have server in python and it's beyond slow...

dense barn Nov 7, 2025, 4:54 PM

#

yeah

#

lol

drowsy thistle Nov 7, 2025, 4:55 PM

#

well obviously you also need to be aware of its downsides prior to using it

swift seal Nov 7, 2025, 4:56 PM

#

drowsy thistle well obviously you also need to be aware of its downsides prior to using it

Yeah but being good at gathering information in short time is one of the skills of any good engineer/programmer

#

It's obvious you won't know everything from start

true sinew Nov 7, 2025, 7:23 PM

#

dense barn <@114280336535453703> is my C# goat when it comes to internals

SusWokege

lyric magnet Nov 9, 2025, 8:01 AM

#

poggythumbsup

wary spoke Nov 9, 2025, 5:53 PM

#

Why is my bots pfp not showing on top.gg? And i cant fix it.

tawny nest Nov 9, 2025, 6:50 PM

#

wary spoke Why is my bots pfp not showing on top.gg? And i cant fix it.

#support
go to your bots page, and click the 'refresh data' button
ensure your bot has a pfp, go to your app on the dev panel and ensure the pfp is there in the general info and the bot section

#

and lastly, dont post in 3 channels to get help.

wary spoke Nov 9, 2025, 6:54 PM

#

tawny nest and lastly, dont post in 3 channels to get help.

Well its not the first time i ask so figured spam a few channels someone will open there mouth.

#

Also my bot page on top.gg?

tawny nest Nov 9, 2025, 6:59 PM

#

wary spoke Also my bot page on top.gg?

yes

tawny nest Nov 9, 2025, 6:59 PM

#

wary spoke Well its not the first time i ask so figured spam a few channels someone will op...

spam is against the rules, and thats also a bit rude

wary spoke Nov 9, 2025, 7:02 PM

#

tawny nest yes

Yea not sure where u see a 'refresh data' button bc i just looked threw the tabs and dont see it anywhere

tawny nest Nov 9, 2025, 7:03 PM

#

wary spoke Yea not sure where u see a 'refresh data' button bc i just looked threw the tabs...

wary spoke Nov 9, 2025, 7:03 PM

#

Yea i was lookin in setting where it should be.

broken frost Nov 9, 2025, 7:05 PM

#

@wary spoke

please use one channel to ask for support, we have a designated channel here: #support
please be more respectful when interacting with other users
thank you

drowsy thistle Nov 9, 2025, 7:38 PM

#

mm_sip

floral salmon Nov 15, 2025, 2:03 AM

#

what is
Top.gg Lib Dev API Access

#

and can i use it

#

and how do you use it

#

hello

#

any help at all

drowsy thistle Nov 15, 2025, 11:33 AM

#

a bot listed for the sole purpose of library developers being able to access the API without having to list their own bot in order to gain access to an API token

floral salmon Nov 15, 2025, 4:10 PM

#

drowsy thistle a bot listed for the sole purpose of library developers being able to access the...

so it will list my bots for me so i don't have to get them revied

drowsy thistle Nov 15, 2025, 4:11 PM

#

what

tawny nest Nov 15, 2025, 4:11 PM

#

floral salmon so it will list my bots for me so i don't have to get them revied

no?

#

what

#

the libraries listed at https://docs.top.gg/docs (eg. https://docs.top.gg/docs/Libraries/python) are developed by people.
these people need a way to test their work
the Top.gg Lib Dev API Access gives them the token access to test their work

it doesnt list bots to avoid reviewal

Home | Top.gg Documentation

Welcome to Top.gg

floral salmon Nov 15, 2025, 4:16 PM

#

tawny nest no?

still don't get can you show me an example of what it does

tawny nest Nov 15, 2025, 4:17 PM

#

...

#

im not a library dev
i dont have access
no

drowsy thistle Nov 15, 2025, 4:17 PM

#

it does not do anything

#

its only purpose of being listed is to give non-project creator Top.gg API library developers (like me) an access to its API token

kindred maple Nov 15, 2025, 10:52 PM

#

floral salmon still don't get can you show me an example of what it does

One message removed from a suspended account.

#

One message removed from a suspended account.

#

One message removed from a suspended account.

floral salmon Nov 15, 2025, 11:12 PM

#

kindred maple One message removed from a suspended account.

how do you get the certified develipor role

kindred maple Nov 15, 2025, 11:12 PM

#

One message removed from a suspended account.

agile dock Nov 19, 2025, 2:05 AM

#

Hi

#

@meager basin

meager basin Nov 19, 2025, 9:10 AM

#

?

haughty plover Nov 26, 2025, 8:01 PM

#

?verify

cunning locust Nov 26, 2025, 9:48 PM

#

i miss when this channel was locked 🥀

drowsy thistle Nov 27, 2025, 3:46 AM

#

same

#

sigh

dense barn Nov 28, 2025, 2:49 AM

#

sideeye

#

we made it open to make it easier for people to get into contributing to the SDKs

iron junco Nov 28, 2025, 8:23 AM

#

dense barn we made it open to make it easier for people to get into contributing to the SDK...

How exactly

drowsy thistle Dec 9, 2025, 12:03 PM

#

@wraith pulsar sigh

wraith pulsar Dec 9, 2025, 12:04 PM

#

ty

drowsy thistle Dec 11, 2025, 7:40 PM

#

okay

tawny torrent Dec 13, 2025, 9:10 AM

#

Hey

drowsy thistle Dec 26, 2025, 5:20 AM

#

veld, can you try checking some of the pull requests in pins? thanks ayaka_pray

#

just as a quick reminder

drowsy thistle Dec 26, 2025, 2:11 PM

#

or maybe william can check them whenever he's free

slate mango Dec 27, 2025, 10:11 AM

#

I say hallo topggSunglasses

night belfry Jan 3, 2026, 5:51 PM

#

slate mango I say hallo<:topggSunglasses:848049751173496832>

i say hola

gilded notch Jan 3, 2026, 7:45 PM

#

night belfry i say hola

i say bonjour

stone obsidian Jan 4, 2026, 2:06 AM

#

gilded notch i say bonjour

i say vanakkam

slate mango Jan 4, 2026, 10:59 AM

#

💪

heady halo Jan 4, 2026, 10:28 PM

#

Does anyone maintain the top.gg JavaScript library? I'm getting the error Autoposter is not a function

#

I just copied and pasted the code that was in the documentation

#

padrao9

heady halo Jan 4, 2026, 10:59 PM

#

https://github.com/Top-gg-Community/node-sdk/pull/93

GitHub

feat: add endpoint: `/v1/projects/@me/commands` by igorwastaken · ...

I created this endpoint in this SDK, if it's necessary to include it in the package.

dense barn Jan 5, 2026, 1:39 AM

#

heady halo https://github.com/Top-gg-Community/node-sdk/pull/93

reviewed

heady halo Jan 5, 2026, 2:08 AM

#

dense barn reviewed

It should look like this?

dense barn Jan 5, 2026, 2:11 AM

#

I would avoid renaming the Api since it causes for a breaking change. For an incremental improvement I would call it "ApiV1" for now.

heady halo Jan 5, 2026, 2:18 AM

#

hum

heady halo Jan 5, 2026, 2:21 AM

#

dense barn I would avoid renaming the Api since it causes for a breaking change. For an inc...

I fixed that husky generated files thing

#

If you want, I can try to help create this class