SlackApimaticSdk 1.0.0

Getting Started with Slack Web API

Introduction

One way to interact with the Slack platform is its HTTP RPC-based Web API, a collection of methods requiring OAuth 2.0-based user, bot, or workspace tokens blessed with related OAuth scopes.

Learn more about the Slack Web API: https://api.slack.com/web

Install the Package

If you are building with .NET CLI tools then you can also use the following command:

dotnet add package SlackApimaticSdk --version 1.0.0

You can also view the package at: https://www.nuget.org/packages/SlackApimaticSdk/1.0.0

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

The API client can be initialized as follows:

Code-Based Initialization

using Microsoft.Extensions.Logging;
using SlackWebApi.Standard;
using SlackWebApi.Standard.Authentication;
using SlackWebApi.Standard.Models;
using System.Collections.Generic;

namespace ConsoleApp;

SlackWebApiClient client = new SlackWebApiClient.Builder()
    .AuthorizationCodeAuth(
        new AuthorizationCodeAuthModel.Builder(
            "OAuthClientId",
            "OAuthClientSecret",
            "OAuthRedirectUri"
        )
        .OauthScopes(
            new List<OauthScope>
            {
                OauthScope.Admin,
                OauthScope.AdminAppsread,
            })
        .Build())
    .HttpClientConfig(httpClientConfig =>
        httpClientConfig.Timeout(TimeSpan.FromSeconds(100)))
    .Environment(SlackWebApi.Standard.Environment.Production)
    .LoggingConfig(config => config
        .LogLevel(LogLevel.Information)
        .RequestConfig(reqConfig => reqConfig.Body(true))
        .ResponseConfig(respConfig => respConfig.Headers(true))
    )
    .Build();

Configuration-Based Initialization

using SlackWebApi.Standard;
using Microsoft.Extensions.Configuration;

namespace ConsoleApp;

// Build the IConfiguration using .NET conventions (JSON, environment, etc.)
var configuration = new ConfigurationBuilder()
    .AddJsonFile("config.json")
    .AddEnvironmentVariables() // [optional] read environment variables
    .Build();

// Instantiate your SDK and configure it from IConfiguration
var client = SlackWebApiClient
    .FromConfiguration(configuration.GetSection("SlackWebApi"));

See the Configuration-Based Initialization section for details.

Environments

The SDK can be configured to use a different environment for making API calls. Available environments are:

Fields

Authorization

This API uses the following authentication schemes.

• slackAuth (OAuth 2 Authorization Code Grant)

List of APIs

• Admin Apps
• Admin Apps Approved
• Admin Apps Requests
• Admin Apps Restricted
• Admin Conversations
• Admin Conversations Ekm
• Admin Conversations Restrict Access
• Admin Emoji
• Admin Invite Requests
• Admin Invite Requests Approved
• Admin Invite Requests Denied
• Admin Teams Admins
• Admin Teams
• Admin Teams Owners
• Admin Teams Settings
• Admin Usergroups
• Admin Users
• Admin Users Session
• Api
• Apps Event Authorizations
• Apps Permissions
• Apps Permissions Resources
• Apps Permissions Scopes
• Apps Permissions Users
• Apps
• Auth
• Bots
• Calls
• Calls Participants
• Chat
• Chat Scheduled Messages
• Conversations
• Dialog
• Dnd
• Emoji
• Files Comments
• Files
• Files Remote
• Migration
• oauth
• oauth V2
• Pins
• Reactions
• Reminders
• Rtm
• Search
• Stars
• Team
• Team Profile
• Usergroups
• Usergroups Users
• Users
• Users Profile
• Views
• Workflows

SDK Infrastructure

Configuration

• Configuration-Based Initialization
• HttpClientConfiguration
• HttpClientConfigurationBuilder
• LogBuilder
• LogRequestBuilder
• LogResponseBuilder
• ProxyConfigurationBuilder

HTTP

• HttpCallback
• HttpContext
• HttpRequest
• HttpResponse
• HttpStringResponse

Utilities

• ApiException
• ApiResponse
• ApiHelper