Wat wordt er in dit artikel besproken?
Een algemeen overzicht van verbindingen en gekoppelde rollen vind je hier.
Om een app met verbindingsfuncties te ontwikkelen, moet je eerst een applicatie en een bot user configureren in de Developer Portal, en daarna de gewenste verbinding en gekoppelde rol. In dit artikel leggen we stap voor stap uit hoe je dit doet.
Meer gedetailleerde informatie over elke stap vind je in onze documentatie voor ontwikkelaars: https://discord.com/developers/docs/tutorials/configuring-app-metadata-for-linked-roles
Een app met verbindingsfuncties maken
Maak eerst een bot user aan in de Developer Portal, die informatie over de verbonden account op zal vragen. De bot heeft ook een redirect URL nodig voor de OAuth2-flow. De redirect URL hangt af van de server en de manier waarop je jouw app host.
Je moet ook een eindpunt-URL instellen voor je gekoppelde rollen in de Developer Portal.
Om informatie op te vragen van een dienst zoals Steam of een andere API, moet je op basis van hun documentatie voor ontwikkelaars een HTTP-verzoek naar hun API configureren en sturen.
Gekoppelde rollen
Het laatste dat geconfigureerd moet worden is de gekoppelde rol zelf. Je kunt de metadata van de gekoppelde rol registreren door deze in te stellen in een PUT-verzoek aan onze API, vergelijkbaar met het registreren van slashopdrachten die door de app worden beheerd. Deze metadata zullen worden gebruikt als de vereisten waaraan gebruikers moeten voldoen om de gekoppelde rol te krijgen.
Let op: gebruik een bot token voor de authenticatie en geen user token.
Open tot slot de Serverinstellingen en maak een rol aan. Onder het kopje “Links” kun je de vereisten voor de rol toevoegen. Als je dat gedaan hebt, ben je klaar!
Als gebruikers hun accounts willen koppelen, kunnen ze linksboven op de naam van de server klikken en zoeken naar de gekoppelde rol die door jouw app wordt beheerd.