# Главная

Лимб. Все дороги ведут отсюда.

Если тебе нужны ответы на вопросы, то ты оказался по адресу.

![](/files/-L_x1VW1gVjJpdblcPo2)

{% content-ref url="/pages/-LeghL87H-Yrev2ZuvP5" %}
[Вступление](/api/api)
{% endcontent-ref %}

## Библиотеки для работы с SD.C API

1. [sdc-api](https://github.com/MegaVasiliy007/sdc-api) | NodeJS *(By* [*SDC*](https://sdc.su/)*)*
2. [sdc-type](https://github.com/sqdshcom/sdc-type) | TypeScript *(By* [*Sqdsh.Community*](https://github.com/sqdshcom/)*)*
3. [sdcgo](https://github.com/FedorLap2006/sdcgo) | Go *(By* [*Fedor Lapshin*](https://github.com/FedorLap2006)*)*
4. [sdc\_api\_py](https://github.com/TheKing-OfTime/sdc-api.py) | Python *(By* [*TheKingOfTime*](https://github.com/TheKing-OfTime)*)*
5. [SdcSharp](https://github.com/SdcSharp) | C# *(By* [*Satan1c*](https://github.com/Satan1c)*)*


# Вступление

Всё, что нужно для начала работы с API

## Получение API ключа.

Для получения API ключа необходимо добавить бота на [Сайт](https://bots.server-discord.com) и ожидать подтверждения.\
Зайти на страницу редактирования бота, найти ссылку на эту страницу можно на вкладке "[Мои боты](https://bots.server-discord.com/my)", пролистать в низ страницы и в разделе "API" сгенерировать токен.

### Внимание

{% hint style="danger" %}
SDC Token - это `"SDC {TOKEN}"` (TOKEN - тот самый токен полученый вышеописаным способом)
{% endhint %}

## Ограничения

{% hint style="danger" %}
Вы не можете делать больше 5 запросов за 10 секунд.
{% endhint %}

## SDC API

{% content-ref url="/pages/-LegkT2LhOEp7y1md8tD" %}
[SDC Monitoring](/api/site)
{% endcontent-ref %}

{% content-ref url="/pages/-Legkm7hl8iTfLPNnctf" %}
[SDC Blacklist](/api/nika)
{% endcontent-ref %}

{% content-ref url="/pages/-Lwdo-Ixz2Chbm5RoS4q" %}
[SDC Bots](/api/bots)
{% endcontent-ref %}


# SDC Monitoring

Получение всей возможной информации с мониторинга.

> Данные о сервере на мониторинге.

{% content-ref url="/pages/-Legh6eH\_tohD-ujQAdc" %}
[Guild](/api/site/guild)
{% endcontent-ref %}

> Данные о пользователях.

{% content-ref url="/pages/-LeghFv53FOHJMzEzCXO" %}
[User](/api/site/user)
{% endcontent-ref %}


# Guild

## Get guild

<mark style="color:blue;">`GET`</mark> `https://api.server-discord.com/v2/guild/:id`

Информация о сервере

#### Path Parameters

| Name                                 | Type   | Description |
| ------------------------------------ | ------ | ----------- |
| id<mark style="color:red;">\*</mark> | string | ID сервера  |

#### Headers

| Name                                            | Type   | Description |
| ----------------------------------------------- | ------ | ----------- |
| Authorization<mark style="color:red;">\*</mark> | string | SDC Token   |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "avatar": "a_8f05534e4f750cf535988ae8a91fe9ad", // Хэш аватарки. Подробнее на https://discord.com/developers/docs/reference#image-formatting
  "lang": "ru",
  "name": "SD.Community",
  "des": "Описание сервера",
  "invite": "https://discord.gg/GWTcywt",
  "owner": "MegaVasiliy007#3301",
  "online": 250,
  "members": 500,
  "bot": 1,                                       // Присутствует ли бот SD.C Monitoring#9896 на сервере.
  "boost": 3,
  "status": 8,
  "upCount": 299,
  "tags": "communication,programming,community"
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Если вы хотите проверить, есть ли значок **Пасхантер**, всё что нужно сделать - это использовать побитовый оператор.
{% endhint %}

```javascript
const status = 40;
status & 8    //  True  (Фаворитика)
status & 16   //  False (Баг хантер)
status & 32   //  True  (Пасхантер)
```

{% tabs %}
{% tab title="Информация о статусах" %}

```javascript
sitedev     1
verefied    2
partner     4
favorite    8
bughunter   16
easteregg   32
botdev      64
youtube     128
twitch      256
spamhunt    512
```

{% endtab %}

{% tab title="Список языков" %}

```js
ru, ua, en, all
```

{% endtab %}

{% tab title="Список тегов" %}

```js
eighteen        //  18+
anime           //  Аниме
games           //  Игры
art             //  Искусство
business        //  Бизнес
music           //  Музыка
communication   //  Общение
rp              //  RolePlay
policy          //  Политика
programming     //  Программирование
community       //  Сообщество
technologies    //  Технологии
films           //  Фильмы
humor           //  Юмор
more            //  Другое
```

{% endtab %}
{% endtabs %}

## Get place

<mark style="color:blue;">`GET`</mark> `https://api.server-discord.com/v2/guild/:id/place`

Получить место сервера в списке

#### Path Parameters

| Name                                 | Type   | Description |
| ------------------------------------ | ------ | ----------- |
| id<mark style="color:red;">\*</mark> | string | ID сервера  |

#### Headers

| Name                                            | Type   | Description |
| ----------------------------------------------- | ------ | ----------- |
| Authorization<mark style="color:red;">\*</mark> | string | SDC Token   |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "place": 0
}
```

{% endtab %}
{% endtabs %}

## Get rated

<mark style="color:blue;">`GET`</mark> `https://api.server-discord.com/v2/guild/:id/rated`

Получить всех проголосовавших пользователей и их оценки

#### Path Parameters

| Name                                 | Type   | Description |
| ------------------------------------ | ------ | ----------- |
| id<mark style="color:red;">\*</mark> | string | ID сервера  |

#### Headers

| Name                                            | Type   | Description |
| ----------------------------------------------- | ------ | ----------- |
| Authorization<mark style="color:red;">\*</mark> | string | SDC Token   |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    //1: Положительная оценка. 
    //-1: Отрицательная оценка.
    "000000000000000000": 1,
    "111111111111111111": 1,
    "222222222222222222": 1,
    "333333333333333333": 1
}
```

{% endtab %}
{% endtabs %}


# User

## Get rated servers

<mark style="color:blue;">`GET`</mark> `https://api.server-discord.com/v2/user/:id/rated`

Получение списка id серверов и статуса голосования на них

#### Path Parameters

| Name | Type   | Description     |
| ---- | ------ | --------------- |
| id   | string | ID пользователя |

#### Headers

| Name          | Type   | Description |
| ------------- | ------ | ----------- |
| Authorization | string | SDC Token   |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    //1: Положительная оценка.
    //-1: отрицательная оценка.
    "000000000000000000": 1,
    "111111111111111111": 1,
    "222222222222222222": 1,
    "333333333333333333": 1
}
```

{% endtab %}
{% endtabs %}


# SDC Blacklist

Публичный чёрный список ID спамеров и их гнёзд (серверов).

## Get warns

<mark style="color:blue;">`GET`</mark> `https://api.server-discord.com/v2/warns/:id`

Получить варны человека или сервера

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
| id   | string | ID          |

#### Headers

| Name          | Type   | Description |
| ------------- | ------ | ----------- |
| Authorization | string | SDC Token   |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "id": "000000000000000000",
    "type": "user",
    "warns": 1
}
```

{% endtab %}
{% endtabs %}


# SDC Bots

Отправка данных о количестве серверов и шардов.

## Send bot data

<mark style="color:green;">`POST`</mark> `https://api.server-discord.com/v2/bots/:id/stats`

#### Path Parameters

| Name                                 | Type   | Description |
| ------------------------------------ | ------ | ----------- |
| id<mark style="color:red;">\*</mark> | String | Айди бота   |

#### Headers

| Name                                            | Type   | Description |
| ----------------------------------------------- | ------ | ----------- |
| Authorization<mark style="color:red;">\*</mark> | String | SDC Token   |

#### Request Body

| Name                                      | Type   | Description                     |
| ----------------------------------------- | ------ | ------------------------------- |
| servers<mark style="color:red;">\*</mark> | Number | Количество серверов, не менее 1 |
| shards<mark style="color:red;">\*</mark>  | Number | Количество шардов, не менее 1   |

{% tabs %}
{% tab title="200: OK Данные успешно установлены" %}

```javascript
{
  "status": true
}
```

{% endtab %}

{% tab title="400: Bad Request Формат ошибок" %}

```javascript
{
  "error": {
    "msg": "Page not found",
    "type": "NOT FOUND",
    "code": 404
  }
}
```

{% endtab %}
{% endtabs %}

### Ограничения

{% hint style="danger" %}
Вы не можете делать больше 2 запросов за 1 минуту.
{% endhint %}