{"action":"created","issue":{"url":"https://api.github.com/repos/discordapp/discord-api-docs/issues/387","repository_url":"https://api.github.com/repos/discordapp/discord-api-docs","labels_url":"https://api.github.com/repos/discordapp/discord-api-docs/issues/387/labels{/name}","comments_url":"https://api.github.com/repos/discordapp/discord-api-docs/issues/387/comments","events_url":"https://api.github.com/repos/discordapp/discord-api-docs/issues/387/events","html_url":"https://github.com/discordapp/discord-api-docs/issues/387","id":259920256,"number":387,"title":"[api/semi-breaking change] (Very) Large Bot Sharding","user":{"login":"jhgg","id":5489149,"avatar_url":"https://avatars3.githubusercontent.com/u/5489149?v=4","gravatar_id":"","url":"https://api.github.com/users/jhgg","html_url":"https://github.com/jhgg","followers_url":"https://api.github.com/users/jhgg/followers","following_url":"https://api.github.com/users/jhgg/following{/other_user}","gists_url":"https://api.github.com/users/jhgg/gists{/gist_id}","starred_url":"https://api.github.com/users/jhgg/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jhgg/subscriptions","organizations_url":"https://api.github.com/users/jhgg/orgs","repos_url":"https://api.github.com/users/jhgg/repos","events_url":"https://api.github.com/users/jhgg/events{/privacy}","received_events_url":"https://api.github.com/users/jhgg/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":16,"created_at":"2017-09-22T19:56:06Z","updated_at":"2017-09-28T01:10:49Z","closed_at":null,"author_association":"MEMBER","body":"**If you are a bot in over _100,000_ guilds,** we are rolling out a new sharding system. You won't need to modify your code, or do anything special except for ONE thing. The number of shards you run must be a multiple of 16 (or another number we may determine deciding upon the size of your bot). I'll be reaching out to each large bot author individually over the course of the next month to perform the migration and what not.\r\n\r\n- When we enroll you into this system, the gateway bot bootstrap endpoint will return the correct number of shards. That means if you're already using this endpoint to determine how many shards to start, your bot will probably require no further modification.\r\n- For large bots enrolled in the new system, we will be increasing the session start limit per day from 1,000 to 2,000 - **starting Oct 16**\r\n- When you are enrolled in this system, and you try and start your bot with an invalid number of shards (not a multiple of 16, etc...) the websocket will close with an invalid shard count opcode - **starting Oct 16**\r\n- The `/users/@me/guilds` endpoint will return no more results. We will be making a new endpoint that will be new-sharding-system aware to iterate through your bot's guilds if needed. - **starting Oct 16**\r\n- This system will become mandatory for large bots (>100k guilds) on Oct 31, 2017 assuming no other delays arise. \r\n\r\n## The big list o' bots to migrate\r\n\r\n- [x] `Mee6#4876` (482,864)\r\n- [x] `Dyno#3861` (433,357)\r\n- [x] `FredBoat♪♪#7284` (420,938)\r\n- [ ] `Rythm#3722` (285,555)\r\n- [ ] `Tatsumaki#8792` (248,778)\r\n- [x] `ErisBot#1777` (232,153)\r\n- [x] `Ayana#8911` (180,573)\r\n- [ ] `dabBot#563` (173,565)\r\n- [ ] `Aethex#394` (127,430)\r\n- [ ] `KawaiiBot#769` (119,288)\r\n- [ ] `Nadeko#6685` (110,834)"},"comment":{"url":"https://api.github.com/repos/discordapp/discord-api-docs/issues/comments/332698467","html_url":"https://github.com/discordapp/discord-api-docs/issues/387#issuecomment-332698467","issue_url":"https://api.github.com/repos/discordapp/discord-api-docs/issues/387","id":332698467,"user":{"login":"MinnDevelopment","id":18090140,"avatar_url":"https://avatars3.githubusercontent.com/u/18090140?v=4","gravatar_id":"","url":"https://api.github.com/users/MinnDevelopment","html_url":"https://github.com/MinnDevelopment","followers_url":"https://api.github.com/users/MinnDevelopment/followers","following_url":"https://api.github.com/users/MinnDevelopment/following{/other_user}","gists_url":"https://api.github.com/users/MinnDevelopment/gists{/gist_id}","starred_url":"https://api.github.com/users/MinnDevelopment/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MinnDevelopment/subscriptions","organizations_url":"https://api.github.com/users/MinnDevelopment/orgs","repos_url":"https://api.github.com/users/MinnDevelopment/repos","events_url":"https://api.github.com/users/MinnDevelopment/events{/privacy}","received_events_url":"https://api.github.com/users/MinnDevelopment/received_events","type":"User","site_admin":false},"created_at":"2017-09-28T01:10:49Z","updated_at":"2017-09-28T01:10:49Z","author_association":"CONTRIBUTOR","body":"The 2,000 refers the IDENTIFY limits per 24 hours. The 1,000 limit of IDENTIFY requests within 24 hours has been added to prevent bots from falling into reconnect loops and is an issue to larger bots when outages occur that cause RESUME to fail.\r\n\r\nTo refer to your last question\r\n> When we enroll you into this system, the gateway bot bootstrap endpoint will return the correct number of shards. That means if you're already using this endpoint to determine how many shards to start, your bot will probably require no further modification."}}
{"actor":{"display_login":"MinnDevelopment"}}