Эй Пи Ай

Программный интерфейс dirty.ru — сайта в интернете для всех

Это страница предназначена для разработчиков. С помощью этой страницы разработчики могут делать различные вещи: например, могут написать бота, который автоматически ставит теги, или свое приложение для iOS, которое фильтрует все посты по словосочетанию «Дональд Трамп», и всякое такое.

Ниже вы найдете список возможных запросов к серверу и примеры ответов на эти запросы.

Аутентификация

Аутентифицироваться по логину и паролю

POSThttps://dirty.ru/api/auth/login/

Получить значения загловков X-Futuware-UID и X-Futuware-SID для совершения авторизованных запросов

Тело запроса

Схема запроса

Пример запроса

{
    "username": "ntndslkheyifmsgwxnht", 
    "password": "password"
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "uid": "398445464", 
    "sid": "7a69f2d780a651b82066194befe5c2be"
}

Установить новый пароль

POSTAUTHУровень доступа CHANGE_PASSWORDhttps://dirty.ru/api/auth/password_change/

После изменения пароля устаревает идентификаторы сесии (заголовок запроса X-Futuware-SID), чтобы продолжить работу нужно заново авторизоваться (auth/login/)

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "password": "password", 
    "old_password": "old_password"
}

Ответ

MIME-type: application/json

Отправить e-mail на восстановление пароля

POSThttps://dirty.ru/api/auth/password_reset/

Объязателен один из 2-х параметров

Тело запроса

Схема запроса

Пример запроса

{
    "username": "test"
}

Аутентифицироваться с помощью стороннего OAuth2-провайдера

POSThttps://dirty.ru/api/auth/social/login/

Тело запроса

Схема запроса

Пример запроса

{
    "access_token": "<insert_facebook_access_token_here>", 
    "provider": "facebook"
}

Ответ

MIME-type: application/json

Пример ответа

{
    "username": "lumylpusdytdrmtoftjw", 
    "uid": "219656991", 
    "sid": "38a997b34824e717c7b840db34bcd4fe"
}

Привязать к аккаунту пользователя новый аккаунт OAuth-провайдера

POSTAUTHhttps://dirty.ru/api/auth/social/connect/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "access_token": "<insert_facebook_access_token_here>", 
    "provider": "facebook"
}

Ответ

MIME-type: application/json

Пример ответа

{
    "username": [
        "superivan"
    ], 
    "first_name": [
        "Ivan"
    ], 
    "last_name": [
        "Ivanov"
    ], 
    "gender": [
        "male"
    ], 
    "birthday": [
        {
            "year": 1990, 
            "day": 1, 
            "month": 1
        }
    ], 
    "data_provider": [
        "facebook"
    ], 
    "email": [
        "superivan@example.com"
    ]
}

Отвязать аккаунт OAuth-провайдера от аккаунта пользователя

POSTAUTHhttps://dirty.ru/api/auth/social/disconnect/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "provider": "facebook"
}

Ответ

MIME-type: application/json

Посты

Получить список постов со всех поддоменов

GEThttps://dirty.ru/api/posts/

Параметры запроса

Параметр Тип Обязательный Описание Пример значения Значение по умолчанию
page integer False

Порядковый номер страницы результатов

None 1
per_page integer False

Количество результатов на одной странице

None 42
sorting string (Варианты: hotness, rating, date_created, date_changed) False

Сортировка постов

Возможные значения:

  • hotness - алгоритм рейтинг+дата публикации (фид «популярное»)

  • rating - по рейтингу без учёта веса голоса (с параметром threshold_date аналог фида «лучшее»)

  • date_created - по дате создания поста (фид «новое»)

  • date_changed - по дате последнего изменения (фид «пульс»)

None hotness
threshold_rating integer False

Только посты с рейтингом выше заданного

None None
threshold_date string (Варианты: day, week, month, year) False

Только посты за указанные период времени

None None

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "posts": [
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain194632908.localhost", 
                "readers_count": 0, 
                "is_subscribed": false, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain194632908", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 194632908
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 194632783, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/194632783/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [
                "тэг3", 
                "tag1", 
                "tag2"
            ], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 194632781
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 194632783, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }
    ]
}

Создать новый пост

POSTAUTHУровень доступа POSThttps://dirty.ru/api/posts/

Таким образом новая модель организационной деятельности позволяет выполнять важные задания по разработке соответствующий условий активизации.

Параметры запроса

Параметр Тип Обязательный Описание Пример значения Значение по умолчанию
domain_prefix string False

Имя поддомена на котором будет опубликован пост

leprosorium None

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "data": {
        "text": "Post text", 
        "type": "link", 
        "title": "Post title"
    }, 
    "tags": [
        "foo", 
        "bar", 
        "baz"
    ]
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://domain717952854.localhost", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "domain717952854", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 717952854
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {
        "title": "Post title", 
        "text": "Post text", 
        "snippet": null, 
        "link": null, 
        "media": null, 
        "type": "link"
    }, 
    "golden": false, 
    "id": 15, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/15/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "post-title", 
    "tags": [
        "baz", 
        "foo", 
        "bar"
    ], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 717952727
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 717952727, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Получить пост по ID

GEThttps://dirty.ru/api/posts/{post_id}/

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://domain806545913.localhost", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "domain806545913", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 806545913
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {}, 
    "golden": false, 
    "id": 806545788, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/806545788/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "", 
    "tags": [
        "foo", 
        "bar"
    ], 
    "can_moderate": false, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "emnonkshuvktuqdhluxs", 
        "id": 806545787
    }, 
    "can_delete": false, 
    "estimate": 0, 
    "can_unpublish": false, 
    "can_edit": false, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 806545788, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Удалить пост

DELETEAUTHУровень доступа DELETE_POSThttps://dirty.ru/api/posts/{post_id}/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Изменить пост

PATCHAUTHУровень доступа EDIT_POSThttps://dirty.ru/api/posts/{post_id}/

Параметры запроса

Параметр Тип Обязательный Описание Пример значения Значение по умолчанию
domain_prefix string False

Имя поддомена на который переносится пост

leprosorium None

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "data": {
        "title": "new title"
    }
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://domain753540366.localhost", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "domain753540366", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 753540366
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {
        "title": "new title", 
        "text": "Post text", 
        "snippet": null, 
        "link": null, 
        "media": null, 
        "type": "link"
    }, 
    "golden": false, 
    "id": 753540240, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/753540240/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "new-title", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 753540239
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 753540241, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Получить голоса за пост

GETAUTHhttps://dirty.ru/api/posts/{post_id}/votes/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "downvotes": [
        {
            "vote": -1, 
            "changed": 1478617880, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "nmswdkiwfduykjprikqk", 
                "id": 406662007
            }
        }
    ], 
    "page_count": 1, 
    "item_count": 2, 
    "upvotes": [
        {
            "vote": 1, 
            "changed": 1478617880, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "vfeflnmdpgvcryfrpbuj", 
                "id": 406662004
            }
        }
    ], 
    "per_page": 42, 
    "page": 1
}

Проголосовать за пост

POSTAUTHhttps://dirty.ru/api/posts/{post_id}/vote/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "vote": 1
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "post": {
        "votes_down": 0, 
        "rating": 1, 
        "id": 31393760, 
        "votes_up": 1
    }, 
    "value": 1
}

Пометить пост прочтенным

POSTAUTHhttps://dirty.ru/api/posts/{post_id}/view/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Добавить пост в избранное

POSTAUTHhttps://dirty.ru/api/posts/{post_id}/favourite/

Если пост уже был в избранном, то все равно будет ответ с кодом 200 и с неизмененным количеством добавлений в избранное

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "favourites_count": 1
}

Удалить пост из избранного

DELETEAUTHhttps://dirty.ru/api/posts/{post_id}/favourite/

Если пост еще не в избранном, то все равно будет ответ с кодом 200 и с неизмененным количеством добавлений в избранное

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "favourites_count": 1
}

Закрепить пост

POSTAUTHУровень доступа PIN_POSThttps://dirty.ru/api/posts/{post_id}/pin/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Ответ

MIME-type: application/json

Схема ответа

Открепить пост

DELETEAUTHУровень доступа PIN_POSThttps://dirty.ru/api/posts/{post_id}/pin/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Распубликовать пост

POSTAUTHУровень доступа UNPUBLISHhttps://dirty.ru/api/posts/{post_id}/unpublish/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://localhost/drafts", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "/drafts", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 4
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "golden": false, 
    "id": 542121871, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/542121871/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "post", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 542121870
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 542121872, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Получить события поста-трансляции

GEThttps://dirty.ru/api/posts/{post_id}/events/

Параметры запроса

Параметр Тип Обязательный Описание Пример значения Значение по умолчанию
last_seen_event_id integer False

Показать только события, которые случились после событий с данным ID

None None

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "events": [
        {
            "id": "96881280-603f-29d0-0418-be08111183f7", 
            "important": false, 
            "blocks": [], 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 207315919
            }, 
            "created": 207315920
        }
    ]
}

Добавить событие в пост-трансляцию

POSTAUTHУровень доступа CREATE_EVENThttps://dirty.ru/api/posts/{post_id}/events/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "blocks": [
        {
            "text": "Комета в восьми километрах", 
            "type": "text"
        }
    ]
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "id": "a37e73f9-7721-3c25-c010-f47d6ffcd342", 
    "important": false, 
    "blocks": [
        {
            "text": "Комета в восьми километрах", 
            "type": "text"
        }
    ], 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 316117448
    }, 
    "created": 316117449
}

Получить событие в посте-трансляции по ID

GEThttps://dirty.ru/api/posts/{post_id}/events/{event_id}/

Ответ

MIME-type: application/json

Пример ответа

{
    "event": {
        "id": "99bbb461-6d01-ddaf-42c3-b721b0e12f4f", 
        "important": false, 
        "blocks": [], 
        "user": {
            "deleted": false, 
            "gender": "male", 
            "rank": "", 
            "avatar_url": null, 
            "active": true, 
            "login": "post_author", 
            "id": 2996822
        }, 
        "created": 2996823
    }
}

Изменить событие в посте-трансляции

PUTAUTHУровень доступа UPDATE_EVENThttps://dirty.ru/api/posts/{post_id}/events/{event_id}/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "blocks": [
        {
            "text": "foo45", 
            "type": "text"
        }
    ]
}

Ответ

MIME-type: application/json

Пример ответа

{
    "event": {
        "id": "bf3b73b2-f030-a59d-5de5-62fb29576e04", 
        "important": false, 
        "blocks": [
            {
                "text": "foo45", 
                "type": "text"
            }
        ], 
        "user": {
            "deleted": false, 
            "gender": "male", 
            "rank": "", 
            "avatar_url": null, 
            "active": true, 
            "login": "other_user", 
            "id": 980421619
        }, 
        "created": 980421619
    }
}

Удалить событие в посте-трансляции

DELETEAUTHУровень доступа DELETE_EVENThttps://dirty.ru/api/posts/{post_id}/events/{event_id}/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Получить возможные действия над постом

GEThttps://dirty.ru/api/posts/{post_id}/permissions/

Получить список действий над постом доступных для авторизованного пользователя (комментировать, голосовать) и причины почему те или иные действия недоступны

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "disallow_reasons": {
        "can_vote": [
            {
                "owner": {
                    "gender": "male", 
                    "login": "", 
                    "id": "0"
                }, 
                "president": null, 
                "code": "self_voting"
            }
        ]
    }, 
    "can_comment": true, 
    "can_vote": false
}

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

GETAUTHhttps://dirty.ru/api/posts/subscriptions/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "posts": [
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912865, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912865/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912863, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }, 
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912866, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912866/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912864, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }, 
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912864, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912864/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912865, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }
    ]
}

Получить список постов с данного домена

GEThttps://dirty.ru/api/domains/{domain_prefix}/posts/

Параметры запроса

Параметр Тип Обязательный Описание Пример значения Значение по умолчанию
page integer False

Порядковый номер страницы результатов

None 1
per_page integer False

Количество результатов на одной странице

None 42
sorting string (Варианты: hotness, rating, date_created, date_changed) False

Сортировка постов

Возможные значения:

  • hotness - алгоритм рейтинг+дата публикации (фид «популярное»)

  • rating - по рейтингу без учёта веса голоса (с параметром threshold_date аналог фида «лучшее»)

  • date_created - по дате создания поста (фид «новое»)

  • date_changed - по дате последнего изменения (фид «пульс»)

None hotness
threshold_rating integer False

Только посты с рейтингом выше заданного

None None
threshold_date string (Варианты: day, week, month, year) False

Только посты за указанные период времени

None None

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "posts": [
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain67138200.localhost", 
                "readers_count": 0, 
                "is_subscribed": false, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain67138200", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 67138200
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 67138075, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/67138075/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 67138073
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 67138075, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }
    ]
}

Получить закрепленный пост на домеме

GEThttps://dirty.ru/api/domains/{domain_prefix}/posts/pinned/

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://domain297590935.localhost", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "domain297590935", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 297590935
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "can_unpublish": false, 
    "golden": false, 
    "id": 297590810, 
    "pinned": true, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/297590810/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "", 
    "tags": [], 
    "can_moderate": false, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 297590808
    }, 
    "can_delete": false, 
    "estimate": 0, 
    "data": {}, 
    "can_edit": false, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 297590810, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false
}

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

GETAUTHУровень доступа VIEW_DRAFThttps://dirty.ru/api/drafts/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://localhost/drafts", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "/drafts", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 4
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {}, 
    "golden": false, 
    "id": 108448082, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/108448082/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "template": "
<div class="post b-post_preview">
    <div class="b-post_comments_page_header">
			<h3>
				
			</h3>
		<div class="clear"></div>
	</div>
    <div class="dd">
    	<div class="b-post_footer_about">
    		<div class="b-i-post_footer_about">
    			<div class="b-post_footer_opts">
    				<a href="//localhost/user/post_author" class="c_user" data-user_id="108448081">post_author</a> will write - just click Yarrr!
    			</div>
    		</div>
    	</div>
    </div>
    <div class="dt">
    	





<div class="post_body">
	<div class="b-post_body_body">
		
	</div>
</div>


    </div>
</div>
", 
    "url_slug": "", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 108448081
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 108448082, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Создать черновик поста

POSTAUTHhttps://dirty.ru/api/drafts/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "data": {
        "type": "link"
    }
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://localhost/drafts", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "/drafts", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 4
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {
        "snippet": null, 
        "text": null, 
        "type": "link", 
        "link": null, 
        "media": null
    }, 
    "golden": false, 
    "id": 18, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/18/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 287748502
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 287748502, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Удалить черновик поста

DELETEAUTHУровень доступа DELETE_POSThttps://dirty.ru/api/drafts/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Изменить черновик поста

PATCHAUTHУровень доступа EDIT_POSThttps://dirty.ru/api/drafts/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "data": {
        "type": "link"
    }
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://localhost/drafts", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "/drafts", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 4
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {
        "snippet": null, 
        "media": null, 
        "link": null, 
        "type": "link"
    }, 
    "golden": false, 
    "id": 295197944, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/295197944/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 295197943
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 295197944, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Опубликовать черновик

POSTAUTHУровень доступа POSThttps://dirty.ru/api/drafts/{post_id}/publish/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://domain864280627.localhost", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "domain864280627", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 864280627
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {
        "title": "Post title", 
        "text": "post text", 
        "snippet": null, 
        "link": {
            "url": "http://example.com", 
            "type": "web", 
            "thumbnails": null
        }, 
        "media": {
            "url": "http://example.com", 
            "type": "image", 
            "thumbnails": null
        }, 
        "type": "link"
    }, 
    "golden": false, 
    "id": 864280501, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/864280501/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "post-title", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 864280500
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 864280501, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Поиск по комментариям пользователя

GEThttps://dirty.ru/api/users/{login}/comments/search/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Черновики

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

GETAUTHУровень доступа VIEW_DRAFThttps://dirty.ru/api/drafts/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://localhost/drafts", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "/drafts", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 4
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {}, 
    "golden": false, 
    "id": 108448082, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/108448082/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "template": "
<div class="post b-post_preview">
    <div class="b-post_comments_page_header">
			<h3>
				
			</h3>
		<div class="clear"></div>
	</div>
    <div class="dd">
    	<div class="b-post_footer_about">
    		<div class="b-i-post_footer_about">
    			<div class="b-post_footer_opts">
    				<a href="//localhost/user/post_author" class="c_user" data-user_id="108448081">post_author</a> will write - just click Yarrr!
    			</div>
    		</div>
    	</div>
    </div>
    <div class="dt">
    	





<div class="post_body">
	<div class="b-post_body_body">
		
	</div>
</div>


    </div>
</div>
", 
    "url_slug": "", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 108448081
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 108448082, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Создать черновик поста

POSTAUTHhttps://dirty.ru/api/drafts/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "data": {
        "type": "link"
    }
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://localhost/drafts", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "/drafts", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 4
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {
        "snippet": null, 
        "text": null, 
        "type": "link", 
        "link": null, 
        "media": null
    }, 
    "golden": false, 
    "id": 18, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/18/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 287748502
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 287748502, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Удалить черновик поста

DELETEAUTHУровень доступа DELETE_POSThttps://dirty.ru/api/drafts/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Изменить черновик поста

PATCHAUTHУровень доступа EDIT_POSThttps://dirty.ru/api/drafts/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "data": {
        "type": "link"
    }
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://localhost/drafts", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "/drafts", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 4
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {
        "snippet": null, 
        "media": null, 
        "link": null, 
        "type": "link"
    }, 
    "golden": false, 
    "id": 295197944, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/295197944/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 295197943
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 295197944, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Опубликовать черновик

POSTAUTHУровень доступа POSThttps://dirty.ru/api/drafts/{post_id}/publish/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://domain864280627.localhost", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "domain864280627", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 864280627
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "data": {
        "title": "Post title", 
        "text": "post text", 
        "snippet": null, 
        "link": {
            "url": "http://example.com", 
            "type": "web", 
            "thumbnails": null
        }, 
        "media": {
            "url": "http://example.com", 
            "type": "image", 
            "thumbnails": null
        }, 
        "type": "link"
    }, 
    "golden": false, 
    "id": 864280501, 
    "pinned": false, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/864280501/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "post-title", 
    "tags": [], 
    "can_moderate": true, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 864280500
    }, 
    "can_delete": true, 
    "estimate": 0, 
    "can_unpublish": true, 
    "can_edit": true, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 864280501, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false, 
    "can_comment": false
}

Моё

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

GETAUTHhttps://dirty.ru/api/posts/subscriptions/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "posts": [
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912865, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912865/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912863, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }, 
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912866, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912866/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912864, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }, 
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912864, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912864/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912865, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }
    ]
}

Получить текущего пользователя

GETAUTHhttps://dirty.ru/api/my/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "deleted": false, 
    "gender": "male", 
    "rank": "", 
    "email": "test@example.com", 
    "avatar_url": null, 
    "active": true, 
    "login": "khvnxxdwzvbsgpnurrss", 
    "id": 479438086
}

Получить домены связаные с пользователем

GETAUTHhttps://dirty.ru/api/my/domains/related/

Список в ответе будет состоит из доменов которыми владеет пользователь, на которых является адмнистратором и на которые подписан.

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "domains": [
        {
            "url": "http://domain727428341.localhost", 
            "prefix": "domain727428341"
        }, 
        {
            "url": "http://domain727428342.localhost", 
            "prefix": "domain727428342"
        }
    ]
}

Получить домены, на которые подписан пользователь

GETAUTHhttps://dirty.ru/api/my/domains/subscribed/

Список в ответе состоит из доменов, которыми владеет и на которые подписан пользователь

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "domains": [
        {
            "logo_url": "http://localhost/static/i/logo_retina.png", 
            "is_readable_for_everyone": true, 
            "name": "", 
            "title": "", 
            "url": "http://domain511494089.localhost", 
            "readers_count": 0, 
            "is_subscribed": true, 
            "is_adult": false, 
            "can_subscribe": true, 
            "is_ignored": false, 
            "color_schema": {
                "links_system_color": null, 
                "header_color": null, 
                "irony_color": null, 
                "links_color": null, 
                "text_color": null, 
                "links_visited_color": null, 
                "background_color": null, 
                "moderator_color": null
            }, 
            "prefix": "domain511494089", 
            "owner": {
                "deleted": true, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": false, 
                "login": "", 
                "id": 0
            }, 
            "president": null, 
            "is_elections_enabled": false, 
            "id": 511494089, 
            "description": ""
        }
    ], 
    "per_page": 42, 
    "page_count": 1, 
    "page": 1, 
    "item_count": 1
}

Получить за что голосовал пользователь

GETAUTHhttps://dirty.ru/api/my/votes/

Список в ответе будет состоять из постов и комментариев за которые проголосовал пользователь.

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 42, 
    "votes": [
        {
            "vote": 1, 
            "comment": {
                "body": "test comment body", 
                "rating": 1, 
                "domain": {
                    "title": "", 
                    "url": "http://domain454737920.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_ignored": false, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "links_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "background_color": null, 
                        "moderator_color": null
                    }, 
                    "is_adult": false, 
                    "prefix": "domain454737920", 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "id": 454737920
                }, 
                "can_edit": false, 
                "deleted": false, 
                "can_moderate": false, 
                "created": 454737794, 
                "vote_weight": 1, 
                "hidden_rating_time_to_show": null, 
                "can_ban": false, 
                "user": {
                    "deleted": false, 
                    "gender": "male", 
                    "is_ignored": false, 
                    "rank": "", 
                    "avatar_url": null, 
                    "active": true, 
                    "login": "lkipnosvjzoyluztqwvt", 
                    "id": 454737793
                }, 
                "can_delete": false, 
                "post": {
                    "id": 454737790, 
                    "url_slug": ""
                }, 
                "id": 454737791
            }
        }, 
        {
            "vote": 1, 
            "comment": {
                "body": "test comment body", 
                "rating": 1, 
                "domain": {
                    "title": "", 
                    "url": "http://domain454737911.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_ignored": false, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "links_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "background_color": null, 
                        "moderator_color": null
                    }, 
                    "is_adult": false, 
                    "prefix": "domain454737911", 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "id": 454737911
                }, 
                "can_edit": false, 
                "deleted": false, 
                "can_moderate": false, 
                "created": 454737795, 
                "vote_weight": 1, 
                "hidden_rating_time_to_show": null, 
                "can_ban": false, 
                "user": {
                    "deleted": false, 
                    "gender": "male", 
                    "is_ignored": false, 
                    "rank": "", 
                    "avatar_url": null, 
                    "active": true, 
                    "login": "uftcyvgyxkvuhwpwnfzu", 
                    "id": 454737784
                }, 
                "can_delete": false, 
                "post": {
                    "id": 454737781, 
                    "url_slug": ""
                }, 
                "id": 454737782
            }
        }, 
        {
            "vote": 1, 
            "post": {
                "rating": 1, 
                "domain": {
                    "title": "", 
                    "url": "http://domain454737906.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_ignored": false, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "links_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "background_color": null, 
                        "moderator_color": null
                    }, 
                    "is_adult": false, 
                    "prefix": "domain454737906", 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "id": 454737906
                }, 
                "unread_comments_count": 0, 
                "in_favourites": false, 
                "data": {}, 
                "golden": false, 
                "id": 454737777, 
                "pinned": false, 
                "can_ban": false, 
                "_links": [
                    {
                        "href": "http://localhost/api/posts/454737777/report/", 
                        "params": null, 
                        "method": "post", 
                        "rel": "report_post"
                    }, 
                    {
                        "href": "http://domain454737906.localhost/-454737777/", 
                        "params": null, 
                        "method": "get", 
                        "rel": "html"
                    }
                ], 
                "url_slug": "", 
                "tags": [], 
                "can_moderate": false, 
                "hidden_rating_time_to_show": null, 
                "user": {
                    "deleted": false, 
                    "gender": "male", 
                    "is_ignored": false, 
                    "rank": "", 
                    "avatar_url": null, 
                    "active": true, 
                    "login": "cqnrukwnqvwriledkmcg", 
                    "id": 454737779
                }, 
                "can_delete": false, 
                "estimate": 0, 
                "can_unpublish": false, 
                "can_edit": false, 
                "favourites_count": 0, 
                "in_interests": false, 
                "created": 454737796, 
                "changed": null, 
                "vote_weight": 1, 
                "comments_count": 0, 
                "advertising": false, 
                "has_subscribed": false
            }
        }
    ], 
    "page_count": 1, 
    "page": 1, 
    "item_count": 3
}

Получить все уведомления пользователя

GETAUTHhttps://dirty.ru/api/my/notifications/

Уведомления отсортированы в обратном хронологическом порядке (чем раньше, тем ниже). При передаче параметра "detailed" будет возвращена более детальная информация о данных

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 42, 
    "notifications": [
        {
            "updated": 646800735, 
            "type": "subscribed_to_post", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/66/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "post_id": 646800734, 
                        "type": "subscribed_to_post"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_post"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "user_id": 646800735, 
                        "type": "subscribed_to_post"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_user"
                }
            ], 
            "data": {
                "post": {
                    "is_hidden": true
                }
            }, 
            "id": 66, 
            "is_unread": true
        }, 
        {
            "updated": 646800731, 
            "type": "post_from_subscribed_user", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/65/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "user_id": 646800732, 
                        "type": "post_from_subscribed_user"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_user"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "post_from_subscribed_user", 
                        "domain_id": 646800856
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800857.localhost", 
                        "id": 646800857, 
                        "prefix": "domain646800857", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800729, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "nicwnvgagwibrkbfjtrq", 
                        "id": 646800730
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800731/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800857.localhost/-646800731/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800731, 
                    "url_slug": ""
                }
            }, 
            "id": 65, 
            "is_unread": false
        }, 
        {
            "updated": 646800727, 
            "type": "election_nomination_start", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/64/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "election_nomination_start", 
                        "domain_id": 646800856
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800856.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": "FFFFFF", 
                        "header_color": "FFFFFF", 
                        "irony_color": "FFFFFF", 
                        "background_color": "FFFFFF", 
                        "text_color": "FFFFFF", 
                        "links_visited_color": "FFFFFF", 
                        "links_color": "FFFFFF", 
                        "moderator_color": "FFFFFF"
                    }, 
                    "prefix": "domain646800856", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800856, 
                    "is_readable_for_everyone": true
                }, 
                "election": {
                    "nomination_ends_at": 0, 
                    "state": "nomination", 
                    "rule_ends_at": 0, 
                    "candidates_count": 0, 
                    "vote_ends_at": 0, 
                    "id": 4
                }
            }, 
            "id": 64, 
            "is_unread": true
        }, 
        {
            "updated": 646800726, 
            "type": "election_voting_start", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/63/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "election_voting_start", 
                        "domain_id": 646800855
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800855.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": "FFFFFF", 
                        "header_color": "FFFFFF", 
                        "irony_color": "FFFFFF", 
                        "background_color": "FFFFFF", 
                        "text_color": "FFFFFF", 
                        "links_visited_color": "FFFFFF", 
                        "links_color": "FFFFFF", 
                        "moderator_color": "FFFFFF"
                    }, 
                    "prefix": "domain646800855", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800855, 
                    "is_readable_for_everyone": true
                }, 
                "election": {
                    "nomination_ends_at": 0, 
                    "state": "nomination", 
                    "rule_ends_at": 0, 
                    "candidates_count": 0, 
                    "vote_ends_at": 0, 
                    "id": 3
                }
            }, 
            "id": 63, 
            "is_unread": true
        }, 
        {
            "updated": 646800725, 
            "type": "president_elected", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/62/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800854.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "background_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "links_color": null, 
                        "moderator_color": null
                    }, 
                    "prefix": "domain646800854", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800854, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 62, 
            "is_unread": true
        }, 
        {
            "updated": 646800724, 
            "type": "unban", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/61/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "unban", 
                        "domain_id": 646800853
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800853.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": "FFFFFF", 
                        "header_color": "FFFFFF", 
                        "irony_color": "FFFFFF", 
                        "background_color": "FFFFFF", 
                        "text_color": "FFFFFF", 
                        "links_visited_color": "FFFFFF", 
                        "links_color": "FFFFFF", 
                        "moderator_color": "FFFFFF"
                    }, 
                    "prefix": "domain646800853", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800853, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 61, 
            "is_unread": false
        }, 
        {
            "updated": 646800723, 
            "type": "ban", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/60/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "ban", 
                        "domain_id": 646800852
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800852.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": "FFFFFF", 
                        "header_color": "FFFFFF", 
                        "irony_color": "FFFFFF", 
                        "background_color": "FFFFFF", 
                        "text_color": "FFFFFF", 
                        "links_visited_color": "FFFFFF", 
                        "links_color": "FFFFFF", 
                        "moderator_color": "FFFFFF"
                    }, 
                    "prefix": "domain646800852", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800852, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 60, 
            "is_unread": true
        }, 
        {
            "updated": 646800722, 
            "type": "given_gold", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/59/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }
            ], 
            "data": {
                "comment": {
                    "body": "test comment body", 
                    "rating": 0, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800848.localhost", 
                        "id": 646800848, 
                        "prefix": "domain646800848", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "created": 646800721, 
                    "snippet": null, 
                    "user_vote": null, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "inqfrilmyowqjddzzury", 
                        "id": 646800721
                    }, 
                    "post": {
                        "_links": [
                            {
                                "href": "http://localhost/api/posts/646800722/report/", 
                                "params": null, 
                                "method": "post", 
                                "rel": "report_post"
                            }, 
                            {
                                "href": "http://domain646800848.localhost/-646800722/", 
                                "params": null, 
                                "method": "get", 
                                "rel": "html"
                            }
                        ], 
                        "id": 646800722, 
                        "title": ""
                    }, 
                    "id": 646800723
                }
            }, 
            "id": 59, 
            "is_unread": true
        }, 
        {
            "updated": 646800718, 
            "type": "given_gold", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/58/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800845.localhost", 
                        "id": 646800845, 
                        "prefix": "domain646800845", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800717, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "fzkgenqfwcygkhtjsmlj", 
                        "id": 646800718
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800719/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800845.localhost/-646800719/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800719, 
                    "url_slug": ""
                }
            }, 
            "id": 58, 
            "is_unread": true
        }, 
        {
            "updated": 646800715, 
            "type": "permission_grant", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/57/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "permission_grant", 
                        "domain_id": 646800844
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800844.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "background_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "links_color": null, 
                        "moderator_color": null
                    }, 
                    "prefix": "domain646800844", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800844, 
                    "is_readable_for_everyone": true
                }, 
                "permission": "moderator"
            }, 
            "id": 57, 
            "is_unread": true
        }, 
        {
            "updated": 646800714, 
            "type": "post_became_gold", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/56/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800841.localhost", 
                        "id": 646800841, 
                        "prefix": "domain646800841", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800713, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "mvpfyqnagglaygqzsvmy", 
                        "id": 646800714
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800715/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800841.localhost/-646800715/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800715, 
                    "url_slug": ""
                }
            }, 
            "id": 56, 
            "is_unread": true
        }, 
        {
            "updated": 646800711, 
            "type": "new_comment", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/55/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "post_id": 646800712, 
                        "type": "new_comment"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_post"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800838.localhost", 
                        "id": 646800838, 
                        "prefix": "domain646800838", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800710, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "vevsqqbkjaygxkagbhqv", 
                        "id": 646800711
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800712/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800838.localhost/-646800712/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800712, 
                    "url_slug": ""
                }, 
                "comments_count": 1
            }, 
            "id": 55, 
            "is_unread": true
        }, 
        {
            "updated": 646800708, 
            "type": "mention", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/54/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "post_id": 646800708, 
                        "type": "mention"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_post"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "user_id": 646800709, 
                        "type": "mention"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_user"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800834.localhost", 
                        "id": 646800834, 
                        "prefix": "domain646800834", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800706, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "djsjsmxhlivwekglcpzv", 
                        "id": 646800707
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800708/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800834.localhost/-646800708/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800708, 
                    "url_slug": ""
                }
            }, 
            "id": 54, 
            "is_unread": true
        }, 
        {
            "updated": 646800704, 
            "type": "comment_answer", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/53/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "post_id": 646800695, 
                        "type": "comment_answer"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_post"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "comment_id": 646800697, 
                        "type": "comment_answer"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_comment"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "user_id": 646800705, 
                        "type": "comment_answer"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_user"
                }
            ], 
            "data": {
                "comment": {
                    "body": "test comment body", 
                    "rating": 0, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800829.localhost", 
                        "id": 646800829, 
                        "prefix": "domain646800829", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "created": 646800702, 
                    "snippet": null, 
                    "user_vote": null, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "wnzlqejnuzdsftbxsjvt", 
                        "id": 646800702
                    }, 
                    "post": {
                        "_links": [
                            {
                                "href": "http://localhost/api/posts/646800703/report/", 
                                "params": null, 
                                "method": "post", 
                                "rel": "report_post"
                            }, 
                            {
                                "href": "http://domain646800829.localhost/-646800703/", 
                                "params": null, 
                                "method": "get", 
                                "rel": "html"
                            }
                        ], 
                        "id": 646800703, 
                        "title": ""
                    }, 
                    "id": 646800704
                }, 
                "post": {
                    "is_hidden": true
                }, 
                "parent_comment": {
                    "is_hidden": true
                }
            }, 
            "id": 53, 
            "is_unread": true
        }
    ], 
    "page_count": 1, 
    "page": 1, 
    "item_count": 14
}

Получить все непрочитанные уведомления пользователя

GETAUTHhttps://dirty.ru/api/my/notifications/unread/

Уведомления отсортированы в обратном хронологическом порядке (чем раньше, тем ниже)

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 42, 
    "notifications": [
        {
            "updated": 851073032, 
            "type": "unban", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/74/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "unban", 
                        "domain_id": 851073159
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain851073159.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "background_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "links_color": null, 
                        "moderator_color": null
                    }, 
                    "prefix": "domain851073159", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 851073159, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 74, 
            "is_unread": true
        }, 
        {
            "updated": 851073031, 
            "type": "ban", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/73/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "ban", 
                        "domain_id": 851073159
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain851073159.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "background_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "links_color": null, 
                        "moderator_color": null
                    }, 
                    "prefix": "domain851073159", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 851073159, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 73, 
            "is_unread": true
        }
    ], 
    "page_count": 1, 
    "page": 1, 
    "item_count": 2
}

Получить количество непрочитанных уведомлений

GETAUTHhttps://dirty.ru/api/my/notifications/unread/count/

Суммарное количество непрочитанных уведомлений.

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "count": 4
}

Получить количество непрочитанных уведомлений сгруппированных по типу

GETAUTHhttps://dirty.ru/api/my/notifications/unread/count_by_type/

Количество непрочитанных уведомлений и по каждому типу.

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "count": {
        "ban": 2, 
        "post_became_gold": 1, 
        "president_elected": 1
    }
}

Подписаться или отписаться от уведомлений

POSTAUTHhttps://dirty.ru/api/my/notifications/subscriptions/

У каждого из типов уведомлений есть параметры на основе которых можно оформить подписку или отписаться.

Например от уведомлений типа mention можно отписаться в определенном посте, передва параметр post_id, от определенного пользовтеля, передав user_id

Список возможных параметров приводится ниже в описании параметров запроса.

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Пример запроса

{
    "action": "subscribe", 
    "post_id": 1000, 
    "type": "comment_answer"
}

Получить настройки ленты уведомлений пользователя

GETAUTHhttps://dirty.ru/api/my/notifications/feed_settings/

Для каждого пользователя сущесвуют настройки его ленты уведомлений позволяющие включить или выключить определённый тип уведолмения из фида и индикатора непрочтённых.

В отличие от механизма подписки / отписки скрытые уведомления продолжают создаваться для пользователя и появляются снова при обратном включении.

В ответе True соответствует включённому уведомлению, False выключенному

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "election_voting_start": false, 
    "comment_answer": true, 
    "post_from_subscribed_user": true, 
    "post_became_gold": true, 
    "permission_grant": true, 
    "subscribed_to_post": true, 
    "given_gold": true, 
    "mention": true, 
    "president_elected": true, 
    "new_comment": true, 
    "ban": true, 
    "unban": false, 
    "election_nomination_start": false
}

Изменить настройки ленты уведомлений пользователя

PATCHAUTHhttps://dirty.ru/api/my/notifications/feed_settings/

Для включения / выключения уведомлений определённых типов отправляется PATCH запрос со словарём где каждому типу уведомления соответствует True / False (включено / выключено)

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "ban": false, 
    "unban": true
}

Ответ

MIME-type: application/json

Пример ответа

{
    "election_voting_start": false, 
    "comment_answer": true, 
    "post_from_subscribed_user": true, 
    "post_became_gold": true, 
    "permission_grant": true, 
    "subscribed_to_post": true, 
    "given_gold": true, 
    "mention": true, 
    "president_elected": true, 
    "new_comment": true, 
    "ban": false, 
    "unban": true, 
    "election_nomination_start": false
}

Пометить все уведомления пользователя как прочитанные

POSTAUTHhttps://dirty.ru/api/my/notifications/mark_read/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

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

POSTAUTHhttps://dirty.ru/api/my/notifications/{notification_id}/mark_read/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Комментарии

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

GEThttps://dirty.ru/api/posts/{post_id}/comments/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "comments": [
        {
            "rating": 30, 
            "can_edit": false, 
            "date_order": 2, 
            "user_vote": null, 
            "created": 463293407, 
            "deleted": true, 
            "can_moderate": false, 
            "vote_weight": 1, 
            "rating_order": 0, 
            "can_remove_comment_threads": false, 
            "parent_id": null, 
            "hidden_rating_time_to_show": null, 
            "can_ban": false, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 463293403
            }, 
            "can_delete": false, 
            "unread": true, 
            "id": 463293406, 
            "tree_level": 0
        }, 
        {
            "body": "test comment body", 
            "rating": 10, 
            "date_order": 0, 
            "user_vote": null, 
            "can_edit": false, 
            "deleted": false, 
            "can_moderate": false, 
            "created": 463293408, 
            "vote_weight": 1, 
            "rating_order": 1, 
            "can_remove_comment_threads": false, 
            "parent_id": null, 
            "hidden_rating_time_to_show": null, 
            "can_ban": false, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 463293403
            }, 
            "can_delete": false, 
            "unread": true, 
            "id": 463293405, 
            "tree_level": 0
        }, 
        {
            "body": "test comment body", 
            "rating": 20, 
            "date_order": 1, 
            "user_vote": null, 
            "can_edit": false, 
            "deleted": false, 
            "can_moderate": false, 
            "created": 463293409, 
            "vote_weight": 1, 
            "rating_order": 2, 
            "can_remove_comment_threads": false, 
            "parent_id": 463293405, 
            "hidden_rating_time_to_show": null, 
            "can_ban": false, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 463293403
            }, 
            "can_delete": false, 
            "unread": true, 
            "id": 463293407, 
            "tree_level": 0
        }
    ]
}

Написать комментарий

POSTAUTHhttps://dirty.ru/api/posts/{post_id}/comments/

Чтобы приложит картинку нужно сначала ее зарузить используя ресурс api/images

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "body": "before image%img%after image", 
    "media_id": 2
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "body": "before image<img src="http://d3.dev/uploads/a5/04/1462951669-a5043416554c3d16700a7919abc30916.jpeg" width="275" height="183" alt="275x183 px" title="275x183 px" border="0">after image", 
    "rating": 0, 
    "can_edit": true, 
    "created": 700240117, 
    "deleted": false, 
    "can_moderate": true, 
    "vote_weight": 1, 
    "user_vote": null, 
    "hidden_rating_time_to_show": null, 
    "can_ban": false, 
    "parent_id": null, 
    "can_delete": true, 
    "id": 3, 
    "tree_level": 0, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "ajfnjidjgaplbnflgstd", 
        "id": 700240114
    }
}

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

GETAUTHhttps://dirty.ru/api/comments/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 42, 
    "page_count": 1, 
    "page": 1, 
    "comments": [
        {
            "body": "test comment body", 
            "rating": 20, 
            "domain": {
                "url": "http://domain374280629.localhost", 
                "prefix": "domain374280629", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 374280629
            }, 
            "can_edit": true, 
            "deleted": false, 
            "can_moderate": true, 
            "created": 374280507, 
            "vote_weight": 1, 
            "user_vote": null, 
            "hidden_rating_time_to_show": null, 
            "can_ban": true, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "tomjbgeflbasdmqunwzc", 
                "id": 374280503
            }, 
            "can_delete": true, 
            "post": {
                "rating": 0, 
                "domain": {
                    "url": "http://domain374280629.localhost", 
                    "prefix": "domain374280629", 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "id": 374280629
                }, 
                "created": 374280508, 
                "ip": "0", 
                "changed": null, 
                "user": {
                    "deleted": false, 
                    "gender": "male", 
                    "is_ignored": false, 
                    "rank": "", 
                    "avatar_url": null, 
                    "active": true, 
                    "login": "tomjbgeflbasdmqunwzc", 
                    "id": 374280503
                }, 
                "data": {}, 
                "id": 374280504, 
                "url_slug": ""
            }, 
            "id": 374280507
        }, 
        {
            "body": "test comment body", 
            "rating": 10, 
            "domain": {
                "url": "http://domain374280629.localhost", 
                "prefix": "domain374280629", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 374280629
            }, 
            "can_edit": true, 
            "deleted": false, 
            "can_moderate": true, 
            "created": 374280509, 
            "vote_weight": 1, 
            "user_vote": null, 
            "hidden_rating_time_to_show": null, 
            "can_ban": true, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "tomjbgeflbasdmqunwzc", 
                "id": 374280503
            }, 
            "can_delete": true, 
            "post": {
                "rating": 0, 
                "domain": {
                    "url": "http://domain374280629.localhost", 
                    "prefix": "domain374280629", 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "id": 374280629
                }, 
                "created": 374280510, 
                "ip": "0", 
                "changed": null, 
                "user": {
                    "deleted": false, 
                    "gender": "male", 
                    "is_ignored": false, 
                    "rank": "", 
                    "avatar_url": null, 
                    "active": true, 
                    "login": "tomjbgeflbasdmqunwzc", 
                    "id": 374280503
                }, 
                "data": {}, 
                "id": 374280504, 
                "url_slug": ""
            }, 
            "id": 374280505
        }
    ], 
    "item_count": 2
}

Получить картинку коментария для шэринга

GEThttps://dirty.ru/api/comments/{comment_id}/sharing_image/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "url": "http://d3.dev/uploads/01/47/100001-01470ef67afea092348caddee0b74262.gif", 
    "width": 1, 
    "height": 1
}

Получить голоса за комментарий

GETAUTHhttps://dirty.ru/api/comments/{comment_id}/votes/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "downvotes": [
        {
            "vote": -1, 
            "changed": 1478694642, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "goecgskdzkbxoelsiuwl", 
                "id": 883382077
            }
        }
    ], 
    "page_count": 1, 
    "item_count": 2, 
    "upvotes": [
        {
            "vote": 1, 
            "changed": 1478694642, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "lmfnkufnsxmvyzobjmbj", 
                "id": 883382073
            }
        }
    ], 
    "per_page": 42, 
    "page": 1
}

Проголосовать за комментарий

POSTAUTHhttps://dirty.ru/api/comments/{comment_id}/vote/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "vote": 1
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "comment": {
        "votes_down": 0, 
        "rating": 1, 
        "id": 677621193, 
        "votes_up": 1
    }, 
    "value": 1
}

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

GEThttps://dirty.ru/api/inbox/{inbox_id}/comments/

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "comments": [
        {
            "body": "test comment body", 
            "can_edit": false, 
            "created": 119162940, 
            "deleted": false, 
            "can_moderate": false, 
            "parent_id": null, 
            "can_ban": false, 
            "tree_level": 0, 
            "can_delete": false, 
            "unread": true, 
            "id": 119162937, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "request_user", 
                "id": 119162934
            }
        }, 
        {
            "body": "test comment body", 
            "can_edit": false, 
            "created": 119162941, 
            "deleted": false, 
            "can_moderate": false, 
            "parent_id": 119162937, 
            "can_ban": false, 
            "tree_level": 0, 
            "can_delete": false, 
            "unread": true, 
            "id": 119162939, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "mksguwbldpocnnfssmio", 
                "id": 119162935
            }
        }, 
        {
            "body": "", 
            "can_edit": false, 
            "created": 119162942, 
            "deleted": true, 
            "can_moderate": false, 
            "parent_id": null, 
            "can_ban": false, 
            "tree_level": 0, 
            "can_delete": false, 
            "unread": true, 
            "id": 119162938, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "request_user", 
                "id": 119162934
            }
        }
    ]
}

Написать комментарий

POSTAUTHhttps://dirty.ru/api/inbox/{inbox_id}/comments/

Чтобы приложить картинку нужно сначала ее зарузить используя ресурс api/images

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "body": "before image%img%after image", 
    "media_id": 2
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "body": "before image<img src="http://d3.dev/uploads/30/76/1463392318-3076e230d1f7df902f8228a1465ce723.jpeg" width="275" height="183" alt="275x183 px" title="275x183 px" border="0">after image", 
    "can_edit": true, 
    "created": 918569898, 
    "deleted": false, 
    "can_moderate": true, 
    "parent_id": null, 
    "can_ban": false, 
    "tree_level": 0, 
    "can_delete": true, 
    "id": 3, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "request_user", 
        "id": 918569895
    }
}

Поиск по постам пользователя

GEThttps://dirty.ru/api/users/{login}/posts/search/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

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

GEThttps://dirty.ru/api/users/{login}/comments/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 1, 
    "page_count": 2, 
    "page": 1, 
    "comments": [
        {
            "body": "test comment body", 
            "can_edit": false, 
            "domain": {
                "title": "", 
                "url": "http://domain161741284.localhost", 
                "readers_count": 0, 
                "is_subscribed": false, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain161741284", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 161741284
            }, 
            "rating": 0, 
            "deleted": false, 
            "can_moderate": false, 
            "created": 161741165, 
            "vote_weight": 1, 
            "user_vote": null, 
            "hidden_rating_time_to_show": null, 
            "can_ban": false, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "target_user", 
                "id": 161741157
            }, 
            "can_delete": false, 
            "post": {
                "id": 161741159, 
                "url_slug": ""
            }, 
            "id": 161741161
        }
    ], 
    "item_count": 2
}

Пользователь

Получить список банов пользователя

GEThttps://dirty.ru/api/users/{login}/bans/

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "bans": [
        {
            "moderator": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "moderator", 
                "id": 432458207
            }, 
            "reason": "Причина бана 1", 
            "expires": null, 
            "domain": {
                "url": "http://domain432458336.localhost", 
                "prefix": "domain432458336"
            }, 
            "created": 432458208
        }, 
        {
            "moderator": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "moderator", 
                "id": 432458207
            }, 
            "reason": "Причина бана 2", 
            "expires": null, 
            "domain": {
                "url": "http://domain432458337.localhost", 
                "prefix": "domain432458337"
            }, 
            "created": 432458209
        }
    ]
}

Получить список постов пользователя

GEThttps://dirty.ru/api/users/{login}/posts/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 1, 
    "page_count": 2, 
    "posts": [
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain793712115.localhost", 
                "readers_count": 0, 
                "is_subscribed": false, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain793712115", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 793712115
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "data": {}, 
            "golden": false, 
            "id": 793711991, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/793711991/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": false, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "target_user", 
                "id": 793711988
            }, 
            "can_delete": false, 
            "estimate": 0, 
            "can_unpublish": false, 
            "can_edit": false, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 793711990, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false
        }
    ], 
    "page": 1, 
    "item_count": 2
}

Поиск по постам пользователя

GEThttps://dirty.ru/api/users/{login}/posts/search/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

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

GEThttps://dirty.ru/api/users/{login}/comments/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 1, 
    "page_count": 2, 
    "page": 1, 
    "comments": [
        {
            "body": "test comment body", 
            "can_edit": false, 
            "domain": {
                "title": "", 
                "url": "http://domain161741284.localhost", 
                "readers_count": 0, 
                "is_subscribed": false, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain161741284", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 161741284
            }, 
            "rating": 0, 
            "deleted": false, 
            "can_moderate": false, 
            "created": 161741165, 
            "vote_weight": 1, 
            "user_vote": null, 
            "hidden_rating_time_to_show": null, 
            "can_ban": false, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "target_user", 
                "id": 161741157
            }, 
            "can_delete": false, 
            "post": {
                "id": 161741159, 
                "url_slug": ""
            }, 
            "id": 161741161
        }
    ], 
    "item_count": 2
}

Поиск по комментариям пользователя

GEThttps://dirty.ru/api/users/{login}/comments/search/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Получить список доменов пользователя

GEThttps://dirty.ru/api/users/{login}/domains/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "domains": [
        {
            "logo_url": "http://localhost/static/i/logo_retina.png", 
            "is_readable_for_everyone": true, 
            "name": "", 
            "title": "", 
            "url": "http://domain440984472.localhost", 
            "readers_count": 2, 
            "is_subscribed": false, 
            "is_adult": false, 
            "can_subscribe": false, 
            "is_ignored": false, 
            "color_schema": {
                "links_system_color": null, 
                "header_color": null, 
                "irony_color": null, 
                "links_color": null, 
                "text_color": null, 
                "links_visited_color": null, 
                "background_color": null, 
                "moderator_color": null
            }, 
            "prefix": "domain440984472", 
            "owner": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "target_user", 
                "id": 440984341
            }, 
            "president": null, 
            "is_elections_enabled": false, 
            "id": 440984472, 
            "description": ""
        }
    ], 
    "per_page": 1, 
    "page_count": 2, 
    "page": 1, 
    "item_count": 2
}

Получить список избранных постов пользователя

GEThttps://dirty.ru/api/users/{login}/favourites/posts/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 1, 
    "page_count": 2, 
    "posts": [
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain876532084.localhost", 
                "readers_count": 0, 
                "is_subscribed": false, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain876532084", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 876532084
            }, 
            "unread_comments_count": 0, 
            "in_favourites": true, 
            "data": {}, 
            "golden": false, 
            "id": 876531960, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/876531960/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "target_user", 
                "id": 876531957
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "can_unpublish": true, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 876531966, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false
        }
    ], 
    "page": 1, 
    "item_count": 2
}

Начать игнорировать пользователя

POSTAUTHhttps://dirty.ru/api/users/{login}/ignore/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Перестать игнорировать пользователя

DELETEAUTHhttps://dirty.ru/api/users/{login}/ignore/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

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

GEThttps://dirty.ru/api/users/{login}/votes/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "downvotes": [
        {
            "vote": -1, 
            "changed": 1478617880, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "nmswdkiwfduykjprikqk", 
                "id": 406662007
            }
        }
    ], 
    "page_count": 1, 
    "item_count": 2, 
    "upvotes": [
        {
            "vote": 1, 
            "changed": 1478617880, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "vfeflnmdpgvcryfrpbuj", 
                "id": 406662004
            }
        }
    ], 
    "per_page": 42, 
    "page": 1
}

Аутентифицироваться по логину и паролю

POSThttps://dirty.ru/api/auth/login/

Получить значения загловков X-Futuware-UID и X-Futuware-SID для совершения авторизованных запросов

Тело запроса

Схема запроса

Пример запроса

{
    "username": "ntndslkheyifmsgwxnht", 
    "password": "password"
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "uid": "398445464", 
    "sid": "7a69f2d780a651b82066194befe5c2be"
}

Установить новый пароль

POSTAUTHУровень доступа CHANGE_PASSWORDhttps://dirty.ru/api/auth/password_change/

После изменения пароля устаревает идентификаторы сесии (заголовок запроса X-Futuware-SID), чтобы продолжить работу нужно заново авторизоваться (auth/login/)

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "password": "password", 
    "old_password": "old_password"
}

Ответ

MIME-type: application/json

Отправить e-mail на восстановление пароля

POSThttps://dirty.ru/api/auth/password_reset/

Объязателен один из 2-х параметров

Тело запроса

Схема запроса

Пример запроса

{
    "username": "test"
}

Привязать к аккаунту пользователя новый аккаунт OAuth-провайдера

POSTAUTHhttps://dirty.ru/api/auth/social/connect/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "access_token": "<insert_facebook_access_token_here>", 
    "provider": "facebook"
}

Ответ

MIME-type: application/json

Пример ответа

{
    "username": [
        "superivan"
    ], 
    "first_name": [
        "Ivan"
    ], 
    "last_name": [
        "Ivanov"
    ], 
    "gender": [
        "male"
    ], 
    "birthday": [
        {
            "year": 1990, 
            "day": 1, 
            "month": 1
        }
    ], 
    "data_provider": [
        "facebook"
    ], 
    "email": [
        "superivan@example.com"
    ]
}

Отвязать аккаунт OAuth-провайдера от аккаунта пользователя

POSTAUTHhttps://dirty.ru/api/auth/social/disconnect/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "provider": "facebook"
}

Ответ

MIME-type: application/json

Получить топ-пользователей (по подписчикам) имя которых начинается с указанного префикса

GEThttps://dirty.ru/api/autocomplete/users/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "users": [
        {
            "gender": "male", 
            "login": "user1", 
            "avatar_url": null, 
            "id": 929591722
        }, 
        {
            "gender": "male", 
            "login": "user2", 
            "avatar_url": null, 
            "id": 929591723
        }
    ]
}

Подписки

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

GETAUTHhttps://dirty.ru/api/posts/subscriptions/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "posts": [
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912865, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912865/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912863, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }, 
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912866, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912866/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912864, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }, 
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain852912990.localhost", 
                "readers_count": 0, 
                "is_subscribed": true, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain852912990", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 852912990
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 852912864, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/852912864/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 852912863
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 852912865, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }
    ]
}

Поддомены

Получить список доменов

GEThttps://dirty.ru/api/domains/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "domains": [
        {
            "logo_url": "http://localhost/static/i/logo_retina.png", 
            "is_readable_for_everyone": true, 
            "name": "", 
            "title": "", 
            "url": "http://domain86951812.localhost", 
            "readers_count": 0, 
            "is_subscribed": false, 
            "is_adult": false, 
            "can_subscribe": true, 
            "is_ignored": false, 
            "color_schema": {
                "links_system_color": null, 
                "header_color": null, 
                "irony_color": null, 
                "links_color": null, 
                "text_color": null, 
                "links_visited_color": null, 
                "background_color": null, 
                "moderator_color": null
            }, 
            "prefix": "domain86951812", 
            "owner": {
                "deleted": true, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": false, 
                "login": "", 
                "id": 0
            }, 
            "president": null, 
            "is_elections_enabled": false, 
            "id": 86951812, 
            "description": ""
        }
    ], 
    "per_page": 42, 
    "page_count": 1, 
    "page": 1, 
    "item_count": 1
}

Создать домен

POSTAUTHhttps://dirty.ru/api/domains/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "logo": "JmXSsxwUMr", 
    "prefix": "foo", 
    "title": "baz", 
    "description": "bar", 
    "tags": [
        "123", 
        "234", 
        "345"
    ]
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "is_elections_enabled": false, 
    "is_readable_for_everyone": true, 
    "name": "foo", 
    "title": "baz", 
    "url": "http://foo.localhost", 
    "readers_count": 0, 
    "is_subscribed": false, 
    "is_adult": false, 
    "can_subscribe": true, 
    "is_ignored": false, 
    "prefix": "foo", 
    "id": 128, 
    "owner": {
        "deleted": false, 
        "gender": "male", 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "serlaeurupdkqdjjwbgb", 
        "id": 232432011
    }, 
    "president": null, 
    "logo_url": "http://JmXSsxwUMr", 
    "color_schema": {
        "links_system_color": null, 
        "header_color": null, 
        "irony_color": null, 
        "links_color": null, 
        "text_color": null, 
        "links_visited_color": null, 
        "background_color": null, 
        "moderator_color": null
    }, 
    "description": "bar"
}

Получить домен

GEThttps://dirty.ru/api/domains/{domain_prefix}/

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "logo_url": "http://localhost/static/i/logo_retina.png", 
    "description": "место для вашей рекламы", 
    "domain_leaders": [
        {
            "rating": 200, 
            "login": "qcupuqrgxvrygjjenesy", 
            "vote_weight": 5, 
            "id": 502390854
        }, 
        {
            "rating": 100, 
            "login": "rnryyegwciukdudrvxac", 
            "vote_weight": 5, 
            "id": 502390853
        }
    ], 
    "title": "", 
    "url": "http://domain502390980.localhost", 
    "readers_count": 0, 
    "is_subscribed": false, 
    "is_ignored": false, 
    "is_adult": false, 
    "top_tags": [
        "good", 
        "bad", 
        "ugly"
    ], 
    "is_readable_for_everyone": true, 
    "prefix": "domain502390980", 
    "id": 502390980, 
    "can_subscribe": false, 
    "president": null, 
    "owner": {
        "deleted": true, 
        "gender": "male", 
        "rank": "", 
        "avatar_url": null, 
        "active": false, 
        "login": "", 
        "id": 0
    }, 
    "moderators": [
        {
            "login": "rnryyegwciukdudrvxac", 
            "id": 502390853
        }
    ], 
    "is_elections_enabled": false, 
    "color_schema": {
        "links_system_color": null, 
        "header_color": null, 
        "irony_color": null, 
        "links_color": null, 
        "text_color": null, 
        "links_visited_color": null, 
        "background_color": null, 
        "moderator_color": null
    }, 
    "name": "some domain"
}

Получить список постов с данного домена

GEThttps://dirty.ru/api/domains/{domain_prefix}/posts/

Параметры запроса

Параметр Тип Обязательный Описание Пример значения Значение по умолчанию
page integer False

Порядковый номер страницы результатов

None 1
per_page integer False

Количество результатов на одной странице

None 42
sorting string (Варианты: hotness, rating, date_created, date_changed) False

Сортировка постов

Возможные значения:

  • hotness - алгоритм рейтинг+дата публикации (фид «популярное»)

  • rating - по рейтингу без учёта веса голоса (с параметром threshold_date аналог фида «лучшее»)

  • date_created - по дате создания поста (фид «новое»)

  • date_changed - по дате последнего изменения (фид «пульс»)

None hotness
threshold_rating integer False

Только посты с рейтингом выше заданного

None None
threshold_date string (Варианты: day, week, month, year) False

Только посты за указанные период времени

None None

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "posts": [
        {
            "rating": 0, 
            "domain": {
                "title": "", 
                "url": "http://domain67138200.localhost", 
                "readers_count": 0, 
                "is_subscribed": false, 
                "is_ignored": false, 
                "color_schema": {
                    "links_system_color": null, 
                    "header_color": null, 
                    "irony_color": null, 
                    "links_color": null, 
                    "text_color": null, 
                    "links_visited_color": null, 
                    "background_color": null, 
                    "moderator_color": null
                }, 
                "is_adult": false, 
                "prefix": "domain67138200", 
                "logo_url": "http://localhost/static/i/logo_retina.png", 
                "id": 67138200
            }, 
            "unread_comments_count": 0, 
            "in_favourites": false, 
            "can_unpublish": true, 
            "golden": false, 
            "id": 67138075, 
            "pinned": false, 
            "user_vote": null, 
            "can_ban": false, 
            "_links": [
                {
                    "href": "http://localhost/api/posts/67138075/report/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "report_post"
                }
            ], 
            "url_slug": "", 
            "tags": [], 
            "can_moderate": true, 
            "hidden_rating_time_to_show": null, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 67138073
            }, 
            "can_delete": true, 
            "estimate": 0, 
            "data": {}, 
            "can_edit": true, 
            "favourites_count": 0, 
            "in_interests": false, 
            "created": 67138075, 
            "changed": null, 
            "vote_weight": 1, 
            "comments_count": 0, 
            "advertising": false, 
            "has_subscribed": false
        }
    ]
}

Получить закрепленный пост на домеме

GEThttps://dirty.ru/api/domains/{domain_prefix}/posts/pinned/

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "rating": 0, 
    "domain": {
        "title": "", 
        "url": "http://domain297590935.localhost", 
        "readers_count": 0, 
        "is_subscribed": false, 
        "is_ignored": false, 
        "color_schema": {
            "links_system_color": null, 
            "header_color": null, 
            "irony_color": null, 
            "links_color": null, 
            "text_color": null, 
            "links_visited_color": null, 
            "background_color": null, 
            "moderator_color": null
        }, 
        "is_adult": false, 
        "prefix": "domain297590935", 
        "logo_url": "http://localhost/static/i/logo_retina.png", 
        "id": 297590935
    }, 
    "unread_comments_count": 0, 
    "in_favourites": false, 
    "can_unpublish": false, 
    "golden": false, 
    "id": 297590810, 
    "pinned": true, 
    "user_vote": null, 
    "can_ban": false, 
    "_links": [
        {
            "href": "http://localhost/api/posts/297590810/report/", 
            "params": null, 
            "method": "post", 
            "rel": "report_post"
        }
    ], 
    "url_slug": "", 
    "tags": [], 
    "can_moderate": false, 
    "hidden_rating_time_to_show": null, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 297590808
    }, 
    "can_delete": false, 
    "estimate": 0, 
    "data": {}, 
    "can_edit": false, 
    "favourites_count": 0, 
    "in_interests": false, 
    "created": 297590810, 
    "changed": null, 
    "vote_weight": 1, 
    "comments_count": 0, 
    "advertising": false, 
    "has_subscribed": false
}

Получить права пользователя на данном домене

GETAUTHhttps://dirty.ru/api/domains/{domain_id}/permissions/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Начать игнорировать домен

POSTAUTHhttps://dirty.ru/api/domains/{domain_id}/ignore/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Перестать игнорировать домен

DELETEAUTHhttps://dirty.ru/api/domains/{domain_id}/ignore/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Подписаться на домен

POSTAUTHhttps://dirty.ru/api/domains/{domain_id}/subscribe/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Отписаться от домена

DELETEAUTHhttps://dirty.ru/api/domains/{domain_id}/subscribe/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Получить домены связаные с пользователем

GETAUTHhttps://dirty.ru/api/my/domains/related/

Список в ответе будет состоит из доменов которыми владеет пользователь, на которых является адмнистратором и на которые подписан.

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "domains": [
        {
            "url": "http://domain727428341.localhost", 
            "prefix": "domain727428341"
        }, 
        {
            "url": "http://domain727428342.localhost", 
            "prefix": "domain727428342"
        }
    ]
}

Получить домены, на которые подписан пользователь

GETAUTHhttps://dirty.ru/api/my/domains/subscribed/

Список в ответе состоит из доменов, которыми владеет и на которые подписан пользователь

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "domains": [
        {
            "logo_url": "http://localhost/static/i/logo_retina.png", 
            "is_readable_for_everyone": true, 
            "name": "", 
            "title": "", 
            "url": "http://domain511494089.localhost", 
            "readers_count": 0, 
            "is_subscribed": true, 
            "is_adult": false, 
            "can_subscribe": true, 
            "is_ignored": false, 
            "color_schema": {
                "links_system_color": null, 
                "header_color": null, 
                "irony_color": null, 
                "links_color": null, 
                "text_color": null, 
                "links_visited_color": null, 
                "background_color": null, 
                "moderator_color": null
            }, 
            "prefix": "domain511494089", 
            "owner": {
                "deleted": true, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": false, 
                "login": "", 
                "id": 0
            }, 
            "president": null, 
            "is_elections_enabled": false, 
            "id": 511494089, 
            "description": ""
        }
    ], 
    "per_page": 42, 
    "page_count": 1, 
    "page": 1, 
    "item_count": 1
}

Получить список доменов пользователя

GEThttps://dirty.ru/api/users/{login}/domains/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "domains": [
        {
            "logo_url": "http://localhost/static/i/logo_retina.png", 
            "is_readable_for_everyone": true, 
            "name": "", 
            "title": "", 
            "url": "http://domain440984472.localhost", 
            "readers_count": 2, 
            "is_subscribed": false, 
            "is_adult": false, 
            "can_subscribe": false, 
            "is_ignored": false, 
            "color_schema": {
                "links_system_color": null, 
                "header_color": null, 
                "irony_color": null, 
                "links_color": null, 
                "text_color": null, 
                "links_visited_color": null, 
                "background_color": null, 
                "moderator_color": null
            }, 
            "prefix": "domain440984472", 
            "owner": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "target_user", 
                "id": 440984341
            }, 
            "president": null, 
            "is_elections_enabled": false, 
            "id": 440984472, 
            "description": ""
        }
    ], 
    "per_page": 1, 
    "page_count": 2, 
    "page": 1, 
    "item_count": 2
}

Голосование

Получить голоса за пост

GETAUTHhttps://dirty.ru/api/posts/{post_id}/votes/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "downvotes": [
        {
            "vote": -1, 
            "changed": 1478617880, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "nmswdkiwfduykjprikqk", 
                "id": 406662007
            }
        }
    ], 
    "page_count": 1, 
    "item_count": 2, 
    "upvotes": [
        {
            "vote": 1, 
            "changed": 1478617880, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "vfeflnmdpgvcryfrpbuj", 
                "id": 406662004
            }
        }
    ], 
    "per_page": 42, 
    "page": 1
}

Проголосовать за пост

POSTAUTHhttps://dirty.ru/api/posts/{post_id}/vote/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "vote": 1
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "post": {
        "votes_down": 0, 
        "rating": 1, 
        "id": 31393760, 
        "votes_up": 1
    }, 
    "value": 1
}

Получить голоса за комментарий

GETAUTHhttps://dirty.ru/api/comments/{comment_id}/votes/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "downvotes": [
        {
            "vote": -1, 
            "changed": 1478694642, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "goecgskdzkbxoelsiuwl", 
                "id": 883382077
            }
        }
    ], 
    "page_count": 1, 
    "item_count": 2, 
    "upvotes": [
        {
            "vote": 1, 
            "changed": 1478694642, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "lmfnkufnsxmvyzobjmbj", 
                "id": 883382073
            }
        }
    ], 
    "per_page": 42, 
    "page": 1
}

Проголосовать за комментарий

POSTAUTHhttps://dirty.ru/api/comments/{comment_id}/vote/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "vote": 1
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "comment": {
        "votes_down": 0, 
        "rating": 1, 
        "id": 677621193, 
        "votes_up": 1
    }, 
    "value": 1
}

Получить за что голосовал пользователь

GETAUTHhttps://dirty.ru/api/my/votes/

Список в ответе будет состоять из постов и комментариев за которые проголосовал пользователь.

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 42, 
    "votes": [
        {
            "vote": 1, 
            "comment": {
                "body": "test comment body", 
                "rating": 1, 
                "domain": {
                    "title": "", 
                    "url": "http://domain454737920.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_ignored": false, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "links_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "background_color": null, 
                        "moderator_color": null
                    }, 
                    "is_adult": false, 
                    "prefix": "domain454737920", 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "id": 454737920
                }, 
                "can_edit": false, 
                "deleted": false, 
                "can_moderate": false, 
                "created": 454737794, 
                "vote_weight": 1, 
                "hidden_rating_time_to_show": null, 
                "can_ban": false, 
                "user": {
                    "deleted": false, 
                    "gender": "male", 
                    "is_ignored": false, 
                    "rank": "", 
                    "avatar_url": null, 
                    "active": true, 
                    "login": "lkipnosvjzoyluztqwvt", 
                    "id": 454737793
                }, 
                "can_delete": false, 
                "post": {
                    "id": 454737790, 
                    "url_slug": ""
                }, 
                "id": 454737791
            }
        }, 
        {
            "vote": 1, 
            "comment": {
                "body": "test comment body", 
                "rating": 1, 
                "domain": {
                    "title": "", 
                    "url": "http://domain454737911.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_ignored": false, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "links_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "background_color": null, 
                        "moderator_color": null
                    }, 
                    "is_adult": false, 
                    "prefix": "domain454737911", 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "id": 454737911
                }, 
                "can_edit": false, 
                "deleted": false, 
                "can_moderate": false, 
                "created": 454737795, 
                "vote_weight": 1, 
                "hidden_rating_time_to_show": null, 
                "can_ban": false, 
                "user": {
                    "deleted": false, 
                    "gender": "male", 
                    "is_ignored": false, 
                    "rank": "", 
                    "avatar_url": null, 
                    "active": true, 
                    "login": "uftcyvgyxkvuhwpwnfzu", 
                    "id": 454737784
                }, 
                "can_delete": false, 
                "post": {
                    "id": 454737781, 
                    "url_slug": ""
                }, 
                "id": 454737782
            }
        }, 
        {
            "vote": 1, 
            "post": {
                "rating": 1, 
                "domain": {
                    "title": "", 
                    "url": "http://domain454737906.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_ignored": false, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "links_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "background_color": null, 
                        "moderator_color": null
                    }, 
                    "is_adult": false, 
                    "prefix": "domain454737906", 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "id": 454737906
                }, 
                "unread_comments_count": 0, 
                "in_favourites": false, 
                "data": {}, 
                "golden": false, 
                "id": 454737777, 
                "pinned": false, 
                "can_ban": false, 
                "_links": [
                    {
                        "href": "http://localhost/api/posts/454737777/report/", 
                        "params": null, 
                        "method": "post", 
                        "rel": "report_post"
                    }, 
                    {
                        "href": "http://domain454737906.localhost/-454737777/", 
                        "params": null, 
                        "method": "get", 
                        "rel": "html"
                    }
                ], 
                "url_slug": "", 
                "tags": [], 
                "can_moderate": false, 
                "hidden_rating_time_to_show": null, 
                "user": {
                    "deleted": false, 
                    "gender": "male", 
                    "is_ignored": false, 
                    "rank": "", 
                    "avatar_url": null, 
                    "active": true, 
                    "login": "cqnrukwnqvwriledkmcg", 
                    "id": 454737779
                }, 
                "can_delete": false, 
                "estimate": 0, 
                "can_unpublish": false, 
                "can_edit": false, 
                "favourites_count": 0, 
                "in_interests": false, 
                "created": 454737796, 
                "changed": null, 
                "vote_weight": 1, 
                "comments_count": 0, 
                "advertising": false, 
                "has_subscribed": false
            }
        }
    ], 
    "page_count": 1, 
    "page": 1, 
    "item_count": 3
}

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

GEThttps://dirty.ru/api/users/{login}/votes/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "downvotes": [
        {
            "vote": -1, 
            "changed": 1478617880, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "nmswdkiwfduykjprikqk", 
                "id": 406662007
            }
        }
    ], 
    "page_count": 1, 
    "item_count": 2, 
    "upvotes": [
        {
            "vote": 1, 
            "changed": 1478617880, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "vfeflnmdpgvcryfrpbuj", 
                "id": 406662004
            }
        }
    ], 
    "per_page": 42, 
    "page": 1
}

Инбоксы

Создать новый инбокс

POSTAUTHУровень доступа POSThttps://dirty.ru/api/inbox/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "text": "Hello", 
    "recipients": [
        {
            "id": 684918874
        }
    ]
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "unread_comments_count": 0, 
    "can_moderate": true, 
    "changed": null, 
    "created": 684918875, 
    "comments_count": 0, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "lbzmihrbkbnmbpdrvwrt", 
        "id": 684918873
    }, 
    "data": {
        "snippet": null, 
        "text": "Hello", 
        "type": "inbox"
    }, 
    "id": 2
}

Получить инбокс

GEThttps://dirty.ru/api/inbox/{post_id}/

Схема параметров

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "unread_comments_count": 0, 
    "can_moderate": true, 
    "changed": null, 
    "created": 257436799, 
    "comments_count": 0, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "omjwgcxgnmvogombllyu", 
        "id": 257436796
    }, 
    "data": {
        "snippet": null, 
        "text": "Foo", 
        "type": "inbox"
    }, 
    "id": 7
}

Редактировать инбокс

PATCHAUTHУровень доступа EDIT_POSThttps://dirty.ru/api/inbox/{post_id}/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "text": "Foo", 
    "recipients": [
        {
            "id": 257436798
        }
    ]
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "unread_comments_count": 0, 
    "can_moderate": true, 
    "changed": null, 
    "created": 257436799, 
    "comments_count": 0, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "omjwgcxgnmvogombllyu", 
        "id": 257436796
    }, 
    "data": {
        "snippet": null, 
        "text": "Foo", 
        "type": "inbox"
    }, 
    "id": 7
}

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

GEThttps://dirty.ru/api/inbox/{inbox_id}/comments/

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "comments": [
        {
            "body": "test comment body", 
            "can_edit": false, 
            "created": 119162940, 
            "deleted": false, 
            "can_moderate": false, 
            "parent_id": null, 
            "can_ban": false, 
            "tree_level": 0, 
            "can_delete": false, 
            "unread": true, 
            "id": 119162937, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "request_user", 
                "id": 119162934
            }
        }, 
        {
            "body": "test comment body", 
            "can_edit": false, 
            "created": 119162941, 
            "deleted": false, 
            "can_moderate": false, 
            "parent_id": 119162937, 
            "can_ban": false, 
            "tree_level": 0, 
            "can_delete": false, 
            "unread": true, 
            "id": 119162939, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "mksguwbldpocnnfssmio", 
                "id": 119162935
            }
        }, 
        {
            "body": "", 
            "can_edit": false, 
            "created": 119162942, 
            "deleted": true, 
            "can_moderate": false, 
            "parent_id": null, 
            "can_ban": false, 
            "tree_level": 0, 
            "can_delete": false, 
            "unread": true, 
            "id": 119162938, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "is_ignored": false, 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "request_user", 
                "id": 119162934
            }
        }
    ]
}

Написать комментарий

POSTAUTHhttps://dirty.ru/api/inbox/{inbox_id}/comments/

Чтобы приложить картинку нужно сначала ее зарузить используя ресурс api/images

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "body": "before image%img%after image", 
    "media_id": 2
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "body": "before image<img src="http://d3.dev/uploads/30/76/1463392318-3076e230d1f7df902f8228a1465ce723.jpeg" width="275" height="183" alt="275x183 px" title="275x183 px" border="0">after image", 
    "can_edit": true, 
    "created": 918569898, 
    "deleted": false, 
    "can_moderate": true, 
    "parent_id": null, 
    "can_ban": false, 
    "tree_level": 0, 
    "can_delete": true, 
    "id": 3, 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "is_ignored": false, 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "request_user", 
        "id": 918569895
    }
}

Пометить инбокс прочтенным

POSTAUTHhttps://dirty.ru/api/inbox/{inbox_id}/view/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Получить список инбоксов

GETAUTHhttps://dirty.ru/api/inboxes/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "page_count": 1, 
    "per_page": 42, 
    "inboxes": [
        {
            "unread_comments_count": 0, 
            "can_moderate": true, 
            "changed": null, 
            "created": 842306454, 
            "comments_count": 0, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "ujzrlmjmquibkbaqfsch", 
                "id": 842306448
            }, 
            "data": {
                "snippet": null, 
                "text": "Hello", 
                "type": "inbox"
            }, 
            "id": 842306453
        }
    ], 
    "page": 1, 
    "item_count": 1
}

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

GETAUTHhttps://dirty.ru/api/inboxes/unread/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "page_count": 1, 
    "per_page": 42, 
    "inboxes": [
        {
            "unread_comments_count": 0, 
            "can_moderate": true, 
            "changed": null, 
            "created": 842306454, 
            "comments_count": 0, 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "ujzrlmjmquibkbaqfsch", 
                "id": 842306448
            }, 
            "data": {
                "snippet": null, 
                "text": "Hello", 
                "type": "inbox"
            }, 
            "id": 842306453
        }
    ], 
    "page": 1, 
    "item_count": 1
}

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

GETAUTHhttps://dirty.ru/api/inboxes/unread/count/

Количество непрочитанных инбоксов

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "count": 1
}

Трансляции

Это особый тип поста

Получить события поста-трансляции

GEThttps://dirty.ru/api/posts/{post_id}/events/

Параметры запроса

Параметр Тип Обязательный Описание Пример значения Значение по умолчанию
last_seen_event_id integer False

Показать только события, которые случились после событий с данным ID

None None

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "events": [
        {
            "id": "96881280-603f-29d0-0418-be08111183f7", 
            "important": false, 
            "blocks": [], 
            "user": {
                "deleted": false, 
                "gender": "male", 
                "rank": "", 
                "avatar_url": null, 
                "active": true, 
                "login": "post_author", 
                "id": 207315919
            }, 
            "created": 207315920
        }
    ]
}

Добавить событие в пост-трансляцию

POSTAUTHУровень доступа CREATE_EVENThttps://dirty.ru/api/posts/{post_id}/events/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "blocks": [
        {
            "text": "Комета в восьми километрах", 
            "type": "text"
        }
    ]
}

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "id": "a37e73f9-7721-3c25-c010-f47d6ffcd342", 
    "important": false, 
    "blocks": [
        {
            "text": "Комета в восьми километрах", 
            "type": "text"
        }
    ], 
    "user": {
        "deleted": false, 
        "gender": "male", 
        "rank": "", 
        "avatar_url": null, 
        "active": true, 
        "login": "post_author", 
        "id": 316117448
    }, 
    "created": 316117449
}

Получить событие в посте-трансляции по ID

GEThttps://dirty.ru/api/posts/{post_id}/events/{event_id}/

Ответ

MIME-type: application/json

Пример ответа

{
    "event": {
        "id": "99bbb461-6d01-ddaf-42c3-b721b0e12f4f", 
        "important": false, 
        "blocks": [], 
        "user": {
            "deleted": false, 
            "gender": "male", 
            "rank": "", 
            "avatar_url": null, 
            "active": true, 
            "login": "post_author", 
            "id": 2996822
        }, 
        "created": 2996823
    }
}

Изменить событие в посте-трансляции

PUTAUTHУровень доступа UPDATE_EVENThttps://dirty.ru/api/posts/{post_id}/events/{event_id}/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "blocks": [
        {
            "text": "foo45", 
            "type": "text"
        }
    ]
}

Ответ

MIME-type: application/json

Пример ответа

{
    "event": {
        "id": "bf3b73b2-f030-a59d-5de5-62fb29576e04", 
        "important": false, 
        "blocks": [
            {
                "text": "foo45", 
                "type": "text"
            }
        ], 
        "user": {
            "deleted": false, 
            "gender": "male", 
            "rank": "", 
            "avatar_url": null, 
            "active": true, 
            "login": "other_user", 
            "id": 980421619
        }, 
        "created": 980421619
    }
}

Удалить событие в посте-трансляции

DELETEAUTHУровень доступа DELETE_EVENThttps://dirty.ru/api/posts/{post_id}/events/{event_id}/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Уведомления

Получить все уведомления пользователя

GETAUTHhttps://dirty.ru/api/my/notifications/

Уведомления отсортированы в обратном хронологическом порядке (чем раньше, тем ниже). При передаче параметра "detailed" будет возвращена более детальная информация о данных

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 42, 
    "notifications": [
        {
            "updated": 646800735, 
            "type": "subscribed_to_post", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/66/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "post_id": 646800734, 
                        "type": "subscribed_to_post"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_post"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "user_id": 646800735, 
                        "type": "subscribed_to_post"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_user"
                }
            ], 
            "data": {
                "post": {
                    "is_hidden": true
                }
            }, 
            "id": 66, 
            "is_unread": true
        }, 
        {
            "updated": 646800731, 
            "type": "post_from_subscribed_user", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/65/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "user_id": 646800732, 
                        "type": "post_from_subscribed_user"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_user"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "post_from_subscribed_user", 
                        "domain_id": 646800856
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800857.localhost", 
                        "id": 646800857, 
                        "prefix": "domain646800857", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800729, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "nicwnvgagwibrkbfjtrq", 
                        "id": 646800730
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800731/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800857.localhost/-646800731/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800731, 
                    "url_slug": ""
                }
            }, 
            "id": 65, 
            "is_unread": false
        }, 
        {
            "updated": 646800727, 
            "type": "election_nomination_start", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/64/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "election_nomination_start", 
                        "domain_id": 646800856
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800856.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": "FFFFFF", 
                        "header_color": "FFFFFF", 
                        "irony_color": "FFFFFF", 
                        "background_color": "FFFFFF", 
                        "text_color": "FFFFFF", 
                        "links_visited_color": "FFFFFF", 
                        "links_color": "FFFFFF", 
                        "moderator_color": "FFFFFF"
                    }, 
                    "prefix": "domain646800856", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800856, 
                    "is_readable_for_everyone": true
                }, 
                "election": {
                    "nomination_ends_at": 0, 
                    "state": "nomination", 
                    "rule_ends_at": 0, 
                    "candidates_count": 0, 
                    "vote_ends_at": 0, 
                    "id": 4
                }
            }, 
            "id": 64, 
            "is_unread": true
        }, 
        {
            "updated": 646800726, 
            "type": "election_voting_start", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/63/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "election_voting_start", 
                        "domain_id": 646800855
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800855.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": "FFFFFF", 
                        "header_color": "FFFFFF", 
                        "irony_color": "FFFFFF", 
                        "background_color": "FFFFFF", 
                        "text_color": "FFFFFF", 
                        "links_visited_color": "FFFFFF", 
                        "links_color": "FFFFFF", 
                        "moderator_color": "FFFFFF"
                    }, 
                    "prefix": "domain646800855", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800855, 
                    "is_readable_for_everyone": true
                }, 
                "election": {
                    "nomination_ends_at": 0, 
                    "state": "nomination", 
                    "rule_ends_at": 0, 
                    "candidates_count": 0, 
                    "vote_ends_at": 0, 
                    "id": 3
                }
            }, 
            "id": 63, 
            "is_unread": true
        }, 
        {
            "updated": 646800725, 
            "type": "president_elected", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/62/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800854.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "background_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "links_color": null, 
                        "moderator_color": null
                    }, 
                    "prefix": "domain646800854", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800854, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 62, 
            "is_unread": true
        }, 
        {
            "updated": 646800724, 
            "type": "unban", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/61/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "unban", 
                        "domain_id": 646800853
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800853.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": "FFFFFF", 
                        "header_color": "FFFFFF", 
                        "irony_color": "FFFFFF", 
                        "background_color": "FFFFFF", 
                        "text_color": "FFFFFF", 
                        "links_visited_color": "FFFFFF", 
                        "links_color": "FFFFFF", 
                        "moderator_color": "FFFFFF"
                    }, 
                    "prefix": "domain646800853", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800853, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 61, 
            "is_unread": false
        }, 
        {
            "updated": 646800723, 
            "type": "ban", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/60/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "ban", 
                        "domain_id": 646800852
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800852.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": "FFFFFF", 
                        "header_color": "FFFFFF", 
                        "irony_color": "FFFFFF", 
                        "background_color": "FFFFFF", 
                        "text_color": "FFFFFF", 
                        "links_visited_color": "FFFFFF", 
                        "links_color": "FFFFFF", 
                        "moderator_color": "FFFFFF"
                    }, 
                    "prefix": "domain646800852", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800852, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 60, 
            "is_unread": true
        }, 
        {
            "updated": 646800722, 
            "type": "given_gold", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/59/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }
            ], 
            "data": {
                "comment": {
                    "body": "test comment body", 
                    "rating": 0, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800848.localhost", 
                        "id": 646800848, 
                        "prefix": "domain646800848", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "created": 646800721, 
                    "snippet": null, 
                    "user_vote": null, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "inqfrilmyowqjddzzury", 
                        "id": 646800721
                    }, 
                    "post": {
                        "_links": [
                            {
                                "href": "http://localhost/api/posts/646800722/report/", 
                                "params": null, 
                                "method": "post", 
                                "rel": "report_post"
                            }, 
                            {
                                "href": "http://domain646800848.localhost/-646800722/", 
                                "params": null, 
                                "method": "get", 
                                "rel": "html"
                            }
                        ], 
                        "id": 646800722, 
                        "title": ""
                    }, 
                    "id": 646800723
                }
            }, 
            "id": 59, 
            "is_unread": true
        }, 
        {
            "updated": 646800718, 
            "type": "given_gold", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/58/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800845.localhost", 
                        "id": 646800845, 
                        "prefix": "domain646800845", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800717, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "fzkgenqfwcygkhtjsmlj", 
                        "id": 646800718
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800719/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800845.localhost/-646800719/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800719, 
                    "url_slug": ""
                }
            }, 
            "id": 58, 
            "is_unread": true
        }, 
        {
            "updated": 646800715, 
            "type": "permission_grant", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/57/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "permission_grant", 
                        "domain_id": 646800844
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain646800844.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "background_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "links_color": null, 
                        "moderator_color": null
                    }, 
                    "prefix": "domain646800844", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 646800844, 
                    "is_readable_for_everyone": true
                }, 
                "permission": "moderator"
            }, 
            "id": 57, 
            "is_unread": true
        }, 
        {
            "updated": 646800714, 
            "type": "post_became_gold", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/56/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800841.localhost", 
                        "id": 646800841, 
                        "prefix": "domain646800841", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800713, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "mvpfyqnagglaygqzsvmy", 
                        "id": 646800714
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800715/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800841.localhost/-646800715/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800715, 
                    "url_slug": ""
                }
            }, 
            "id": 56, 
            "is_unread": true
        }, 
        {
            "updated": 646800711, 
            "type": "new_comment", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/55/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "post_id": 646800712, 
                        "type": "new_comment"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_post"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800838.localhost", 
                        "id": 646800838, 
                        "prefix": "domain646800838", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800710, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "vevsqqbkjaygxkagbhqv", 
                        "id": 646800711
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800712/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800838.localhost/-646800712/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800712, 
                    "url_slug": ""
                }, 
                "comments_count": 1
            }, 
            "id": 55, 
            "is_unread": true
        }, 
        {
            "updated": 646800708, 
            "type": "mention", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/54/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "post_id": 646800708, 
                        "type": "mention"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_post"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "user_id": 646800709, 
                        "type": "mention"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_user"
                }
            ], 
            "data": {
                "post": {
                    "golden": false, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800834.localhost", 
                        "id": 646800834, 
                        "prefix": "domain646800834", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "favourites_count": 0, 
                    "created": 646800706, 
                    "rating": 0, 
                    "title": "", 
                    "changed": null, 
                    "comments_count": 0, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "djsjsmxhlivwekglcpzv", 
                        "id": 646800707
                    }, 
                    "unread_comments_count": 0, 
                    "_links": [
                        {
                            "href": "http://localhost/api/posts/646800708/report/", 
                            "params": null, 
                            "method": "post", 
                            "rel": "report_post"
                        }, 
                        {
                            "href": "http://domain646800834.localhost/-646800708/", 
                            "params": null, 
                            "method": "get", 
                            "rel": "html"
                        }
                    ], 
                    "id": 646800708, 
                    "url_slug": ""
                }
            }, 
            "id": 54, 
            "is_unread": true
        }, 
        {
            "updated": 646800704, 
            "type": "comment_answer", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/53/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "post_id": 646800695, 
                        "type": "comment_answer"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_post"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "comment_id": 646800697, 
                        "type": "comment_answer"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_comment"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "user_id": 646800705, 
                        "type": "comment_answer"
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_user"
                }
            ], 
            "data": {
                "comment": {
                    "body": "test comment body", 
                    "rating": 0, 
                    "domain": {
                        "name": "", 
                        "url": "http://domain646800829.localhost", 
                        "id": 646800829, 
                        "prefix": "domain646800829", 
                        "logo_url": "http://localhost/static/i/logo_retina.png", 
                        "color_schema": {
                            "links_system_color": null, 
                            "header_color": null, 
                            "irony_color": null, 
                            "background_color": null, 
                            "text_color": null, 
                            "links_visited_color": null, 
                            "links_color": null, 
                            "moderator_color": null
                        }
                    }, 
                    "created": 646800702, 
                    "snippet": null, 
                    "user_vote": null, 
                    "user": {
                        "deleted": false, 
                        "gender": "male", 
                        "is_ignored": false, 
                        "rank": "", 
                        "avatar_url": null, 
                        "active": true, 
                        "login": "wnzlqejnuzdsftbxsjvt", 
                        "id": 646800702
                    }, 
                    "post": {
                        "_links": [
                            {
                                "href": "http://localhost/api/posts/646800703/report/", 
                                "params": null, 
                                "method": "post", 
                                "rel": "report_post"
                            }, 
                            {
                                "href": "http://domain646800829.localhost/-646800703/", 
                                "params": null, 
                                "method": "get", 
                                "rel": "html"
                            }
                        ], 
                        "id": 646800703, 
                        "title": ""
                    }, 
                    "id": 646800704
                }, 
                "post": {
                    "is_hidden": true
                }, 
                "parent_comment": {
                    "is_hidden": true
                }
            }, 
            "id": 53, 
            "is_unread": true
        }
    ], 
    "page_count": 1, 
    "page": 1, 
    "item_count": 14
}

Получить все непрочитанные уведомления пользователя

GETAUTHhttps://dirty.ru/api/my/notifications/unread/

Уведомления отсортированы в обратном хронологическом порядке (чем раньше, тем ниже)

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "per_page": 42, 
    "notifications": [
        {
            "updated": 851073032, 
            "type": "unban", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/74/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "unban", 
                        "domain_id": 851073159
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain851073159.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "background_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "links_color": null, 
                        "moderator_color": null
                    }, 
                    "prefix": "domain851073159", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 851073159, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 74, 
            "is_unread": true
        }, 
        {
            "updated": 851073031, 
            "type": "ban", 
            "_links": [
                {
                    "href": "http://localhost/api/my/notifications/73/mark_read/", 
                    "params": null, 
                    "method": "post", 
                    "rel": "mark_read"
                }, 
                {
                    "href": "http://localhost/api/my/notifications/subscriptions/", 
                    "params": {
                        "action": "unsubscribe", 
                        "type": "ban", 
                        "domain_id": 851073159
                    }, 
                    "method": "post", 
                    "rel": "unsubscribe_domain"
                }
            ], 
            "data": {
                "domain": {
                    "is_ignored": false, 
                    "logo_url": "http://localhost/static/i/logo_retina.png", 
                    "description": "", 
                    "name": "", 
                    "title": "", 
                    "url": "http://domain851073159.localhost", 
                    "readers_count": 0, 
                    "is_subscribed": false, 
                    "is_adult": false, 
                    "can_subscribe": true, 
                    "color_schema": {
                        "links_system_color": null, 
                        "header_color": null, 
                        "irony_color": null, 
                        "background_color": null, 
                        "text_color": null, 
                        "links_visited_color": null, 
                        "links_color": null, 
                        "moderator_color": null
                    }, 
                    "prefix": "domain851073159", 
                    "owner": null, 
                    "president": null, 
                    "is_elections_enabled": false, 
                    "id": 851073159, 
                    "is_readable_for_everyone": true
                }
            }, 
            "id": 73, 
            "is_unread": true
        }
    ], 
    "page_count": 1, 
    "page": 1, 
    "item_count": 2
}

Получить количество непрочитанных уведомлений

GETAUTHhttps://dirty.ru/api/my/notifications/unread/count/

Суммарное количество непрочитанных уведомлений.

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "count": 4
}

Получить количество непрочитанных уведомлений сгруппированных по типу

GETAUTHhttps://dirty.ru/api/my/notifications/unread/count_by_type/

Количество непрочитанных уведомлений и по каждому типу.

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "count": {
        "ban": 2, 
        "post_became_gold": 1, 
        "president_elected": 1
    }
}

Подписаться или отписаться от уведомлений

POSTAUTHhttps://dirty.ru/api/my/notifications/subscriptions/

У каждого из типов уведомлений есть параметры на основе которых можно оформить подписку или отписаться.

Например от уведомлений типа mention можно отписаться в определенном посте, передва параметр post_id, от определенного пользовтеля, передав user_id

Список возможных параметров приводится ниже в описании параметров запроса.

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Пример запроса

{
    "action": "subscribe", 
    "post_id": 1000, 
    "type": "comment_answer"
}

Получить настройки ленты уведомлений пользователя

GETAUTHhttps://dirty.ru/api/my/notifications/feed_settings/

Для каждого пользователя сущесвуют настройки его ленты уведомлений позволяющие включить или выключить определённый тип уведолмения из фида и индикатора непрочтённых.

В отличие от механизма подписки / отписки скрытые уведомления продолжают создаваться для пользователя и появляются снова при обратном включении.

В ответе True соответствует включённому уведомлению, False выключенному

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "election_voting_start": false, 
    "comment_answer": true, 
    "post_from_subscribed_user": true, 
    "post_became_gold": true, 
    "permission_grant": true, 
    "subscribed_to_post": true, 
    "given_gold": true, 
    "mention": true, 
    "president_elected": true, 
    "new_comment": true, 
    "ban": true, 
    "unban": false, 
    "election_nomination_start": false
}

Изменить настройки ленты уведомлений пользователя

PATCHAUTHhttps://dirty.ru/api/my/notifications/feed_settings/

Для включения / выключения уведомлений определённых типов отправляется PATCH запрос со словарём где каждому типу уведомления соответствует True / False (включено / выключено)

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса

Схема запроса

Пример запроса

{
    "ban": false, 
    "unban": true
}

Ответ

MIME-type: application/json

Пример ответа

{
    "election_voting_start": false, 
    "comment_answer": true, 
    "post_from_subscribed_user": true, 
    "post_became_gold": true, 
    "permission_grant": true, 
    "subscribed_to_post": true, 
    "given_gold": true, 
    "mention": true, 
    "president_elected": true, 
    "new_comment": true, 
    "ban": false, 
    "unban": true, 
    "election_nomination_start": false
}

Пометить все уведомления пользователя как прочитанные

POSTAUTHhttps://dirty.ru/api/my/notifications/mark_read/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

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

POSTAUTHhttps://dirty.ru/api/my/notifications/{notification_id}/mark_read/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Media

Создать изображение

POSTAUTHУровень доступа CREATE_IMAGEhttps://dirty.ru/api/images/

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Тело запроса (multipart/form-data)

Параметры формы

Параметр Тип Обязательный Описание Пример значения Значение по умолчанию
file file True None None

Ответ

MIME-type: application/json

Пример ответа

{
    "media_id": null, 
    "preview_url": "http://d3.dev/uploads/b0/c9/1454491682-b0c91a3eb5b39872efe6099df6ef69f6.jpeg", 
    "media_url": "http://d3.dev/uploads/b0/c9/1454491682-b0c91a3eb5b39872efe6099df6ef69f6.jpeg"
}

Автокомплит

Получить топ-пользователей (по подписчикам) имя которых начинается с указанного префикса

GEThttps://dirty.ru/api/autocomplete/users/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Схема ответа

Пример ответа

{
    "users": [
        {
            "gender": "male", 
            "login": "user1", 
            "avatar_url": null, 
            "id": 929591722
        }, 
        {
            "gender": "male", 
            "login": "user2", 
            "avatar_url": null, 
            "id": 929591723
        }
    ]
}

Получить тэги, которые начинаются с указанного префикса

GEThttps://dirty.ru/api/autocomplete/tags/

Схема параметров

HTTP заголовки запроса

Заголовок Описание Пример значения
X-Futuware-UID

User ID

1
X-Futuware-SID

Session ID

f0d0cf6a67427c3008e0f721ef4881be

Ответ

MIME-type: application/json

Пример ответа

{
    "tags": [
        "tag1", 
        "tag2"
    ]
}