feat: add oauth2 types (#16)

Ref: cd6c72a9a2

CHANGELOG.md

@@ -1,7 +0,0 @@
-# Changelog
-
-This will be a list of changes that happen between versions
-
-## 0.1.0
-
-Initial release

README.md

@@ -31,6 +31,8 @@ The exports of each API version is split into three main parts:
 
     - For example, `RESTPostAPIChannelMessageJSONBody` or `RESTGetAPIGatewayBotInfoResult`.
 
+    - Some exported types (specifically OAuth2 related ones) may not respect this entire structure due to the nature of the fields. They will start with either `RESTOAuth2` or with something similar to `REST<HTTP Method>OAuth2`
+
   - If a type ends with `Result`, then it represents the expected result by calling its accompanying route.
 
     - Types that are exported as `never` usually mean the result will be a `204 No Content`, so you can safely ignore it. This does **not** account for errors.
@@ -48,21 +50,21 @@ You can `require` / `import` the module directly, which will give you the latest
 > We **strongly recommend** you use a version when importing this module! This will prevent breaking changes when updating the module.
 
 ```js
-const { APIUserData } = require('discord-api-types');
+const { APIUser } = require('discord-api-types');
 ```
 
 ```ts
 // TypeScript/ES Module support
-import { APIUserData } from 'discord-api-types';
+import { APIUser } from 'discord-api-types';
 ```
 
 You should instead consider adding the API version you want to target by appending `/v*`, where the `*` represents the API version.
 
 ```js
-const { APIUserData } = require('discord-api-types/v6');
+const { APIUser } = require('discord-api-types/v6');
 ```
 
 ```ts
 // TypeScript/ES Module support
-import { APIUserData } from 'discord-api-types/v6';
+import { APIUser } from 'discord-api-types/v6';
 ```

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "discord-api-types",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "discord-api-types",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Discord API typings that are kept up to date for use in bot library creation.",
   "main": "default/index.js",
   "scripts": {

v6/payloads/auditLog.ts

@@ -162,222 +162,327 @@ export enum AuditLogOptionsType {
 /**
  * https://discord.com/developers/docs/resources/audit-log#audit-log-change-object-audit-log-change-structure
  */
-export interface APIAuditLogChange {
-	new_value?: APIAuditLogChangeKey;
-	old_value?: APIAuditLogChangeKey;
-	key: string;
+export type APIAuditLogChange =
+	| APIAuditLogChangeKeyName
+	| APIAuditLogChangeKeyIconHash
+	| APIAuditLogChangeKeySplashHash
+	| APIAuditLogChangeKeyOwnerID
+	| APIAuditLogChangeKeyRegion
+	| APIAuditLogChangeKeyAFKChannelID
+	| APIAuditLogChangeKeyAFKTimeout
+	| APIAuditLogChangeKeyMFALevel
+	| APIAuditLogChangeKeyVerificationLevel
+	| APIAuditLogChangeKeyExplicitContentFilter
+	| APIAuditLogChangeKeyDefaultMessageNotifications
+	| APIAuditLogChangeKeyVanityURLCode
+	| APIAuditLogChangeKey$Add
+	| APIAuditLogChangeKey$Remove
+	| APIAuditLogChangeKeyPruneDeleteDays
+	| APIAuditLogChangeKeyWidgetEnabled
+	| APIAuditLogChangeKeyWidgetChannelID
+	| APIAuditLogChangeKeySystemChannelID
+	| APIAuditLogChangeKeyPosition
+	| APIAuditLogChangeKeyTopic
+	| APIAuditLogChangeKeyBitrate
+	| APIAuditLogChangeKeyPermissionOverwrites
+	| APIAuditLogChangeKeyNSFW
+	| APIAuditLogChangeKeyApplicationID
+	| APIAuditLogChangeKeyRateLimitPerUser
+	| APIAuditLogChangeKeyPermissions
+	| APIAuditLogChangeKeyPermissionsNew
+	| APIAuditLogChangeKeyColor
+	| APIAuditLogChangeKeyHoist
+	| APIAuditLogChangeKeyMentionable
+	| APIAuditLogChangeKeyAllow
+	| APIAuditLogChangeKeyAllowNew
+	| APIAuditLogChangeKeyDeny
+	| APIAuditLogChangeKeyDenyNew
+	| APIAuditLogChangeKeyCode
+	| APIAuditLogChangeKeyChannelID
+	| APIAuditLogChangeKeyInviterID
+	| APIAuditLogChangeKeyMaxUses
+	| APIAuditLogChangeKeyUses
+	| APIAuditLogChangeKeyMaxAge
+	| APIAuditLogChangeKeyTemporary
+	| APIAuditLogChangeKeyDeaf
+	| APIAuditLogChangeKeyMute
+	| APIAuditLogChangeKeyNick
+	| APIAuditLogChangeKeyAvatarHash
+	| APIAuditLogChangeKeyID
+	| APIAuditLogChangeKeyType
+	| APIAuditLogChangeKeyEnableEmoticons
+	| APIAuditLogChangeKeyExpireBehavior
+	| APIAuditLogChangeKeyExpireGracePeriod;
+
+/**
+ * Returned when a guild's name is changed
+ */
+export type APIAuditLogChangeKeyName = AuditLogChangeData<'name', string>;
+
+/**
+ * Returned when a guild's icon is changed
+ */
+export type APIAuditLogChangeKeyIconHash = AuditLogChangeData<'icon_hash', string>;
+
+/**
+ * Returned when a guild's splash is changed
+ */
+export type APIAuditLogChangeKeySplashHash = AuditLogChangeData<'splash_hash', string>;
+
+/**
+ * Returned when a guild's owner ID is changed
+ */
+export type APIAuditLogChangeKeyOwnerID = AuditLogChangeData<'owner_id', string>;
+
+/**
+ * Returned when a guild's region is changed
+ */
+export type APIAuditLogChangeKeyRegion = AuditLogChangeData<'region', string>;
+
+/**
+ * Returned when a guild's afk_channel_id is changed
+ */
+export type APIAuditLogChangeKeyAFKChannelID = AuditLogChangeData<'afk_channel_id', string>;
+
+/**
+ * Returned when a guild's afk_timeout is changed
+ */
+export type APIAuditLogChangeKeyAFKTimeout = AuditLogChangeData<'afk_timeout', number>;
+
+/**
+ * Returned when a guild's mfa_level is changed
+ */
+export type APIAuditLogChangeKeyMFALevel = AuditLogChangeData<'mfa_level', GuildMFALevel>;
+
+/**
+ * Returned when a guild's verification_level is changed
+ */
+export type APIAuditLogChangeKeyVerificationLevel = AuditLogChangeData<'verification_level', GuildVerificationLevel>;
+
+/**
+ * Returned when a guild's explicit_content_filter is changed
+ */
+export type APIAuditLogChangeKeyExplicitContentFilter = AuditLogChangeData<
+	'explicit_content_filter',
+	GuildExplicitContentFilter
+>;
+
+/**
+ * Returned when a guild's default_message_notifications is changed
+ */
+export type APIAuditLogChangeKeyDefaultMessageNotifications = AuditLogChangeData<
+	'default_message_notifications',
+	GuildDefaultMessageNotifications
+>;
+
+/**
+ * Returned when a guild's vanity_url_code is changed
+ */
+export type APIAuditLogChangeKeyVanityURLCode = AuditLogChangeData<'vanity_url_code', string>;
+
+/**
+ * Returned when new role(s) are added
+ */
+export type APIAuditLogChangeKey$Add = AuditLogChangeData<'$add', APIRole[]>;
+
+/**
+ * Returned when role(s) are removed
+ */
+export type APIAuditLogChangeKey$Remove = AuditLogChangeData<'$remove', APIRole[]>;
+
+/**
+ * Returned when there is a change in number of days after which inactive and role-unassigned members are kicked
+ */
+export type APIAuditLogChangeKeyPruneDeleteDays = AuditLogChangeData<'prune_delete_days', number>;
+
+/**
+ * Returned when a guild's widget is enabled
+ */
+export type APIAuditLogChangeKeyWidgetEnabled = AuditLogChangeData<'widget_enabled', boolean>;
+
+/**
+ * Returned when a guild's widget_channel_id is changed
+ */
+export type APIAuditLogChangeKeyWidgetChannelID = AuditLogChangeData<'widget_channel_id', string>;
+
+/**
+ * Returned when a guild's system_channel_id is changed
+ */
+export type APIAuditLogChangeKeySystemChannelID = AuditLogChangeData<'system_channel_id', string>;
+
+/**
+ * Returned when a channel's position is changed
+ */
+export type APIAuditLogChangeKeyPosition = AuditLogChangeData<'position', number>;
+
+/**
+ * Returned when a channel's topic is changed
+ */
+export type APIAuditLogChangeKeyTopic = AuditLogChangeData<'topic', string>;
+
+/**
+ * Returned when a voice channel's bitrate is changed
+ */
+export type APIAuditLogChangeKeyBitrate = AuditLogChangeData<'bitrate', number>;
+
+/**
+ * Returned when a channel's permission overwrites is changed
+ */
+export type APIAuditLogChangeKeyPermissionOverwrites = AuditLogChangeData<'permission_overwrites', APIOverwrite[]>;
+
+/**
+ * Returned when a channel's NSFW restriction is changed
+ */
+export type APIAuditLogChangeKeyNSFW = AuditLogChangeData<'nsfw', boolean>;
+
+/**
+ * The application ID of the added or removed Webhook or Bot
+ */
+export type APIAuditLogChangeKeyApplicationID = AuditLogChangeData<'application_id', string>;
+
+/**
+ * Returned when a channel's amount of seconds a user has to wait before sending another message
+ * is changed
+ */
+export type APIAuditLogChangeKeyRateLimitPerUser = AuditLogChangeData<'rate_limit_per_user', number>;
+
+/**
+ * Returned when a permission bitfield is changed
+ * @deprecated Use `permissions_new` instead
+ */
+export type APIAuditLogChangeKeyPermissions = AuditLogChangeData<'permissions', number>;
+
+/**
+ * Returned when a permission bitfield is changed
+ */
+export type APIAuditLogChangeKeyPermissionsNew = AuditLogChangeData<'permissions_new', string>;
+
+/**
+ * Returned when a role's color is changed
+ */
+export type APIAuditLogChangeKeyColor = AuditLogChangeData<'color', number>;
+
+/**
+ * Returned when a role's hoist status is changed
+ */
+export type APIAuditLogChangeKeyHoist = AuditLogChangeData<'hoist', boolean>;
+
+/**
+ * Returned when a role's mentionable status is changed
+ */
+export type APIAuditLogChangeKeyMentionable = AuditLogChangeData<'mentionable', boolean>;
+
+/**
+ * Returned when an overwrite's allowed permissions bitfield is changed
+ * @deprecated Use `allow_new` instead
+ */
+export type APIAuditLogChangeKeyAllow = AuditLogChangeData<'allow', number>;
+
+/**
+ * Returned when an overwrite's allowed permissions bitfield is changed
+ */
+export type APIAuditLogChangeKeyAllowNew = AuditLogChangeData<'allow_new', string>;
+
+/**
+ * Returned when an overwrite's denied permissions bitfield is changed
+ * @deprecated Use `deny_new` instead
+ */
+export type APIAuditLogChangeKeyDeny = AuditLogChangeData<'deny', number>;
+
+/**
+ * Returned when an overwrite's denied permissions bitfield is changed
+ */
+export type APIAuditLogChangeKeyDenyNew = AuditLogChangeData<'deny_new', string>;
+
+/**
+ * Returned when an invite's code is changed
+ */
+export type APIAuditLogChangeKeyCode = AuditLogChangeData<'code', string>;
+
+/**
+ * Returned when an invite's channel_id is changed
+ */
+export type APIAuditLogChangeKeyChannelID = AuditLogChangeData<'channel_id', string>;
+
+/**
+ * Returned when an invite's inviter_id is changed
+ */
+export type APIAuditLogChangeKeyInviterID = AuditLogChangeData<'inviter_id', string>;
+
+/**
+ * Returned when an invite's max_uses is changed
+ */
+export type APIAuditLogChangeKeyMaxUses = AuditLogChangeData<'max_uses', number>;
+
+/**
+ * Returned when an invite's uses is changed
+ */
+export type APIAuditLogChangeKeyUses = AuditLogChangeData<'uses', number>;
+
+/**
+ * Returned when an invite's max_age is changed
+ */
+export type APIAuditLogChangeKeyMaxAge = AuditLogChangeData<'max_age', number>;
+
+/**
+ * Returned when an invite's temporary status is changed
+ */
+export type APIAuditLogChangeKeyTemporary = AuditLogChangeData<'temporary', boolean>;
+
+/**
+ * Returned when a user's deaf status is changed
+ */
+export type APIAuditLogChangeKeyDeaf = AuditLogChangeData<'deaf', boolean>;
+
+/**
+ * Returned when a user's mute status is changed
+ */
+export type APIAuditLogChangeKeyMute = AuditLogChangeData<'mute', boolean>;
+
+/**
+ * Returned when a user's nick is changed
+ */
+export type APIAuditLogChangeKeyNick = AuditLogChangeData<'mute', boolean>;
+
+/**
+ * Returned when a user's avatar_hash is changed
+ */
+export type APIAuditLogChangeKeyAvatarHash = AuditLogChangeData<'avatar_hash', string>;
+
+/**
+ * The ID of the changed entity - sometimes used in conjunction with other keys
+ */
+export interface APIAuditLogChangeKeyID {
+	key: 'id';
+	new_value: string;
+	old_value?: string;
 }
 
 /**
- * https://discord.com/developers/docs/resources/audit-log#audit-log-change-object-audit-log-change-key
+ * The type of entity created
  */
-export interface APIAuditLogChangeKey {
-	/**
-	 * Returned when a guild is updated
-	 */
-	name?: string;
-	/**
-	 * Returned when a guild is updated
-	 */
-	icon_hash?: string;
-	/**
-	 * Returned when a guild is updated
-	 */
-	splash_hash?: string;
-	/**
-	 * Returned when a guild is updated
-	 */
-	owner_id?: string;
-	/**
-	 * Returned when a guild is updated
-	 */
-	region?: string;
-	/**
-	 * Returned when a guild is updated
-	 */
-	afk_channel_id?: string;
-	/**
-	 * Returned when a guild is updated
-	 */
-	afk_timeout?: number;
-	/**
-	 * Returned when a guild is updated
-	 */
-	mfa_level?: GuildMFALevel;
-	/**
-	 * Returned when a guild is updated
-	 */
-	verification_level?: GuildVerificationLevel;
-	/**
-	 * Returned when a guild is updated
-	 */
-	explicit_content_filter?: GuildExplicitContentFilter;
-	/**
-	 * Returned when a guild is updated
-	 */
-	default_message_notifications?: GuildDefaultMessageNotifications;
-	/**
-	 * Returned when a guild is updated
-	 */
-	vanity_url_code?: string;
-	/**
-	 * Returned when a guild is updated
-	 */
-	$add?: APIRole[];
-	/**
-	 * Returned when a guild is updated
-	 */
-	$remove?: APIRole[];
-	/**
-	 * Returned when a guild is updated
-	 */
-	prune_delete_days?: number;
-	/**
-	 * Returned when a guild is updated
-	 */
-	widget_enabled?: boolean;
-	/**
-	 * Returned when a guild is updated
-	 */
-	widget_channel_id?: string;
-	/**
-	 * Returned when a guild is updated
-	 */
-	system_channel_id?: string;
+export type APIAuditLogChangeKeyType = AuditLogChangeData<'type', ChannelType | string>;
 
-	/**
-	 * Returned when a channel is updated
-	 */
-	position?: number;
-	/**
-	 * Returned when a channel is updated
-	 */
-	topic?: string;
-	/**
-	 * Returned when a channel is updated
-	 */
-	bitrate?: number;
-	/**
-	 * Returned when a channel is updated
-	 */
-	permission_overwrites?: APIOverwrite[];
-	/**
-	 * Returned when a channel is updated
-	 */
-	nsfw?: boolean;
-	/**
-	 * Returned when a channel is updated
-	 */
-	application_id?: string;
-	/**
-	 * Returned when a channel is updated
-	 */
-	rate_limit_per_user?: number;
+/**
+ * Returned when an integration's enable_emoticons is changed
+ */
+export type APIAuditLogChangeKeyEnableEmoticons = AuditLogChangeData<'enable_emoticons', boolean>;
 
-	/**
-	 * Returned when a role is updated
-	 */
-	permissions?: number;
-	/**
-	 * Returned when a role is updated
-	 */
-	permissions_new?: string;
-	/**
-	 * Returned when a role is updated
-	 */
-	color?: string;
-	/**
-	 * Returned when a role is updated
-	 */
-	hoist?: boolean;
-	/**
-	 * Returned when a role is updated
-	 */
-	mentionable?: boolean;
-	/**
-	 * Returned when a role is updated
-	 * @deprecated Use `allow_new` instead
-	 */
-	allow?: number;
-	/**
-	 * Returned when a role is updated
-	 */
-	allow_new?: string;
-	/**
-	 * Returned when a role is updated
-	 * @deprecated Use `deny_new` instead
-	 */
-	deny?: number;
-	/**
-	 * Returned when a role is updated
-	 */
-	deny_new?: string;
+/**
+ * Returned when an integration's expire_behavior is changed
+ */
+export type APIAuditLogChangeKeyExpireBehavior = AuditLogChangeData<'expire_behavior', IntegrationExpireBehavior>;
 
-	/**
-	 * Returned when an invite is updated
-	 */
-	code?: string;
-	/**
-	 * Returned when an invite is updated
-	 */
-	channel_id?: string;
-	/**
-	 * Returned when an invite is updated
-	 */
-	inviter_id?: string;
-	/**
-	 * Returned when an invite is updated
-	 */
-	max_uses?: number;
-	/**
-	 * Returned when an invite is updated
-	 */
-	uses?: number;
-	/**
-	 * Returned when an invite is updated
-	 */
-	max_age?: number;
-	/**
-	 * Returned when an invite is updated
-	 */
-	temporary?: boolean;
+/**
+ * Returned when an integration's expire_grace_period is changed
+ */
+export type APIAuditLogChangeKeyExpireGracePeriod = AuditLogChangeData<'expire_grace_period', number>;
 
-	/**
-	 * Returned when a user is updated
-	 */
-	deaf?: boolean;
-	/**
-	 * Returned when a user is updated
-	 */
-	mute?: boolean;
-	/**
-	 * Returned when a user is updated
-	 */
-	nick?: string;
-	/**
-	 * Returned when a user is updated
-	 */
-	avatar_hash?: string;
-
-	/**
-	 * The ID of the changed entry
-	 */
-	id: string;
-	/**
-	 * The type of the changed entity
-	 */
-	type?: ChannelType | string;
-
-	/**
-	 * Returned when an integration is updated
-	 */
-	enable_emoticons?: boolean;
-	/**
-	 * Returned when an integration is updated
-	 */
-	expire_behavior?: IntegrationExpireBehavior;
-	/**
-	 * Returned when an integration is updated
-	 */
-	expire_grace_period?: number;
+/**
+ * @internal
+ */
+interface AuditLogChangeData<K extends string, D extends unknown> {
+	key: K;
+	new_value?: D;
+	old_value?: D;
 }

v6/payloads/gateway.ts

@@ -88,6 +88,7 @@ export enum ActivityType {
 	Listening,
 
 	Custom = 4,
+	Competing,
 }
 
 /**

v6/rest/oauth2.ts

@@ -1,6 +1,159 @@
-import type { APIApplication } from '../payloads';
+import type { APIApplication, APIGuild, APIWebhook } from '../payloads';
 
 /**
  * https://discord.com/developers/docs/topics/oauth2#get-current-application-information
  */
 export type RESTGetAPIOauth2CurrentApplicationResult = APIApplication;
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant
+ */
+export interface RESTOAuth2AuthorizationQuery {
+	response_type: 'code';
+	client_id: string;
+	scope: string;
+	redirect_uri?: string;
+	state?: string;
+	prompt?: 'consent' | 'none';
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
+ */
+export interface RESTOAuth2AuthorizationQueryResult {
+	code: string;
+	state?: string;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example
+ */
+export interface RESTPostOAuth2AccessTokenURIEncodedData {
+	client_id: string;
+	client_secret: string;
+	grant_type: 'authorization_code';
+	code: string;
+	redirect_uri?: string;
+	scope: string;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-access-token-response
+ */
+export interface RESTPostOAuth2AccessTokenResult {
+	access_token: string;
+	token_type: string;
+	expires_in: number;
+	refresh_token: string;
+	scope: string;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-refresh-token-exchange-example
+ */
+export interface RESTPostOAuth2RefreshTokenURIEncodedData {
+	client_id: string;
+	client_secret: string;
+	grant_type: 'refresh_token';
+	refresh_token: string;
+	redirect_uri?: string;
+	scope: string;
+}
+
+export type RESTPostOAuth2RefreshTokenResult = RESTPostOAuth2AccessTokenResult;
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#implicit-grant
+ */
+export interface RESTOAuth2ImplicitAuthorizationQuery {
+	response_type: 'token';
+	client_id: string;
+	scope: string;
+	redirect_uri?: string;
+	state?: string;
+	prompt?: 'consent' | 'none';
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#implicit-grant-redirect-url-example
+ */
+export type RESTOAuth2ImplicitAuthorizationURIFragmentResult = Omit<RESTPostOAuth2AccessTokenResult, 'refresh_token'>;
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#client-credentials-grant
+ */
+export interface RESTPostOAuth2ClientCredentialsURIEncodedData {
+	client_id: string;
+	client_secret: string;
+	grant_type: 'client_credentials';
+	scope: string;
+}
+
+export type RESTPostOAuth2ClientCredentialsResult = RESTOAuth2ImplicitAuthorizationURIFragmentResult;
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#bot-authorization-flow-bot-auth-parameters
+ */
+export interface RESTOAuth2BotAuthorizationQuery {
+	client_id: string;
+	scope: string;
+	/**
+	 * The required permissions bitfield, stringified
+	 */
+	permissions?: string;
+	guild_id?: string;
+	disable_guild_select?: boolean;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#advanced-bot-authorization
+ */
+export interface RESTOAuth2AdvancedBotAuthorizationQuery {
+	client_id: string;
+	/**
+	 * This assumes you include the `bot` scope alongside others (like `identify` for example)
+	 */
+	scope: string;
+	/**
+	 * The required permissions bitfield, stringified
+	 */
+	permissions?: string;
+	guild_id?: string;
+	disable_guild_select?: boolean;
+	response_type: string;
+	redirect_uri?: string;
+}
+
+export interface RESTOAuth2AdvancedBotAuthorizationQueryResult {
+	code: string;
+	state?: string;
+	guild_id: string;
+	permissions: string;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#advanced-bot-authorization-extended-bot-authorization-access-token-example
+ */
+export interface RESTPostOAuth2AccessTokenWithBotAndGuildsScopeResult {
+	access_token: string;
+	token_type: string;
+	expires_in: number;
+	refresh_token: string;
+	scope: string;
+	guild: APIGuild;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#webhooks-webhook-token-response-example
+ */
+export interface RESTPostOAuth2AccessTokenWithBotAndWebhookIncomingScopeResult {
+	access_token: string;
+	token_type: string;
+	expires_in: number;
+	refresh_token: string;
+	scope: string;
+	webhook: APIWebhook;
+}
+
+export type RESTPostOAuth2AccessTokenWithBotAndGuildsAndWebhookIncomingScopeResult = RESTPostOAuth2AccessTokenWithBotAndGuildsScopeResult &
+	RESTPostOAuth2AccessTokenWithBotAndWebhookIncomingScopeResult;