itd-api

Тема

Методы API ​

Здесь перечислены поддерживаемые маршруты API и соответствующие им публичные методы itd-api. Колонка «Основной контракт» фиксирует отправляемые поля и форму полезного результата. В колонке «Авторизация» значение нет означает, что SDK намеренно не отправляет Bearer-токен, необязательно — маршрут работает без сессии, но клиент с настроенной сессией может отправить токен, а Bearer — маршрут требует access token.

Авторизация и сессии ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/v1/auth/captcha/provideritd.auth.captchaProvider()нетактивный провайдер и поле token либо turnstileToken2026-09-01, 200
GET /api/v1/auth/captcha/pageitd.auth.captchaPage()нетактивный провайдер, поле и адрес страницы виджета2026-09-02, 200
POST /api/v1/auth/sign-upitd.auth.signUp()нетemail, password, подтверждение капчи → flowToken—
POST /api/v1/auth/sign-initd.auth.signIn()нетemail, password, подтверждение капчи → access token или flowToken—
POST /api/v1/auth/verify-otpitd.auth.verifyOtp()нетemail, password, otp, flowToken → access token—
POST /api/v1/auth/resend-otpitd.auth.resendOtp()нетemail, flowToken—
POST /api/v1/auth/refreshitd.auth.refresh()refresh cookieответ: access token—
POST /api/v1/auth/logoutitd.auth.logout(), itd.auth.logoutAll()Bearer + refresh cookiebody отсутствует—
POST /api/v1/auth/forgot-passworditd.auth.forgotPassword()нетemail, подтверждение капчи → flowToken—
POST /api/v1/auth/reset-passworditd.auth.resetPassword()нетemail, newPassword, otp, flowToken—
POST /api/v1/auth/change-passworditd.auth.changePassword()BearercurrentPassword, newPassword—
GET /api/profileitd.auth.check()необязательноответ: authenticated, banned, user2026-08-22, 200
GET /api/v1/auth/sessionsitd.auth.sessions()Bearerответ: sessions[]2026-08-13, 200
DELETE /api/v1/auth/sessions/{sessionId}itd.auth.revokeSession()Bearerидентификатор сессии в пути—
DELETE /api/v1/auth/sessionsitd.auth.revokeOtherSessions(), itd.auth.logoutAll()Bearerзавершение остальных сессий—
POST /api/v1/auth/qr/startitd.auth.startQrLogin()нетновая QR-сессия: qrId, claimToken, payload, expiresIn, captchaRequired2026-09-01, 201
POST /api/v1/auth/qr/streamitd.auth.streamQrLogin()нетqrId, claimToken → SSE-статусы QR-сессии2026-09-01, 200
POST /api/v1/auth/qr/claimitd.auth.claimQrLogin()нетсекреты QR, при необходимости подтверждение капчи → статус или access token2026-09-01, 200
POST /api/v1/auth/qr/scanitd.auth.scanQrLogin()мобильный BearerqrId, secret из кода → описание устройства, которое просит вход2026-09-02, 200
POST /api/v1/auth/qr/approveitd.auth.approveQrLogin()мобильный BearerqrId, secret из кода2026-09-02, 200
POST /api/v1/auth/qr/rejectitd.auth.rejectQrLogin()мобильный BearerqrId, secret из кода2026-09-02, 401 без токена

signInWithOtp() объединяет sign-in и verify-otp, resetPasswordWithOtp() — forgot-password и reset-password, поэтому отдельных маршрутов для них нет.

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

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/users/meitd.users.me()Bearerответ: текущий пользователь2026-08-13, 200
PUT /api/users/meitd.users.updateMe(), setBanner(), removeBanner()Bearerизменяемые поля профиля—
DELETE /api/users/meitd.users.deactivate()Bearerbody отсутствует—
POST /api/users/me/restoreitd.users.restore()Bearerbody отсутствует—
POST /api/users/profileitd.users.createProfile()Bearerusername, displayName, avatar—
GET /api/users/{user}itd.users.get()Bearerid или username в path2026-08-13, 200
GET /api/users/check-usernameitd.users.checkUsername()необязательноquery: username2026-08-22, 200
GET /api/users/suggestions/who-to-followitd.users.whoToFollow()Bearerответ: users[]2026-08-13, 200
GET /api/users/stats/top-clansitd.users.topClans()Bearerответ: clans[]2026-08-13, 200
POST /api/users/{user}/followitd.users.follow()Bearerid или username в path2026-08-13, 200
DELETE /api/users/{user}/followitd.users.unfollow()Bearerid или username в path2026-08-13, 200
GET /api/users/{user}/followersitd.users.followers(), iterateFollowers()Bearerquery: page, limit2026-08-13, 200
GET /api/users/{user}/followingitd.users.following(), iterateFollowing()Bearerquery: page, limit2026-08-13, 200
POST /api/users/follow-statusitd.users.followStatus()BeareruserIds[] → карта статусов2026-08-13, 200
POST /api/users/{user}/blockitd.users.block()Bearerid или username в path2026-08-13, 200
DELETE /api/users/{user}/blockitd.users.unblock()Bearerid или username в path2026-08-13, 200
GET /api/users/me/blockeditd.users.blocked(), iterateBlocked()Bearerquery: page, limit2026-08-13, 200
GET /api/users/me/privacyitd.users.getPrivacy()Bearerответ: настройки приватности2026-08-13, 200
PUT /api/users/me/privacyitd.users.updatePrivacy()Bearerизменяемые настройки приватности—
GET /api/users/me/pinsitd.users.pins()Bearerответ: pins[], activePin2026-08-13, 200
PUT /api/users/me/pinitd.users.setPin()Bearerslug2026-08-13, 200
DELETE /api/users/me/pinitd.users.removePin()Bearerbody отсутствует2026-08-13, 200

Посты ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/postsitd.posts.list(), iterate()Bearerquery: tab, limit, cursor2026-08-13, 200
POST /api/postsitd.posts.create()Bearerконтент, spans, вложения, опрос2026-08-13, 201
GET /api/posts/{postId}itd.posts.get()Bearerидентификатор поста в path2026-08-13, 200
PUT /api/posts/{postId}itd.posts.update()Bearercontent, spans2026-08-13, 200
DELETE /api/posts/{postId}itd.posts.remove()Bearerидентификатор поста в path2026-08-13, 204
POST /api/posts/{postId}/restoreitd.posts.restore()Bearerидентификатор поста в path2026-08-13, 204
POST /api/posts/{postId}/likeitd.posts.like()Bearerидентификатор поста в path2026-08-13, 200
DELETE /api/posts/{postId}/likeitd.posts.unlike()Bearerидентификатор поста в path2026-08-13, 200
POST /api/posts/{postId}/repostitd.posts.repost()Bearercontent2026-08-13, 201
DELETE /api/posts/{postId}/repostitd.posts.unrepost()Bearerидентификатор поста в path2026-08-13, 200
POST /api/posts/{postId}/pinitd.posts.pin()Bearerидентификатор поста в path2026-08-13, 200
DELETE /api/posts/{postId}/pinitd.posts.unpin()Bearerидентификатор поста в path2026-08-13, 200
POST /api/posts/{postId}/poll/voteitd.posts.vote()BeareroptionIds[]2026-08-13, 200
POST /api/posts/statsitd.posts.stats()Bearerids[] → статистика постов2026-08-13, 200
GET /api/posts/user/{user}itd.posts.byUser(), iterateByUser()Bearerquery: limit, cursor, sort, pinnedPostId2026-08-13, 200
GET /api/posts/user/{user}/likeditd.posts.likedByUser(), iterateLikedByUser()Bearerquery: limit, cursor2026-08-13, 200
GET /api/posts/{postId}/commentsitd.posts.comments(), iterateComments()Bearerquery: limit, cursor, sort2026-08-13, 200
POST /api/posts/{postId}/commentsitd.posts.comment(), voiceComment()Bearercontent, attachmentIds[]2026-08-13, 201

Комментарии ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/comments/{commentId}/repliesitd.comments.replies(), iterateReplies()Bearerquery: limit, page2026-08-13, 200
POST /api/comments/{commentId}/repliesitd.comments.reply()Bearercontent, attachmentIds[], replyToUserId2026-08-13, 201
PATCH /api/comments/{commentId}itd.comments.update()Bearercontent2026-08-13, 200
DELETE /api/comments/{commentId}itd.comments.remove()Bearerидентификатор комментария в path2026-08-13, 204
POST /api/comments/{commentId}/restoreitd.comments.restore()Bearerидентификатор комментария в path2026-08-13, 204
POST /api/comments/{commentId}/likeitd.comments.like()Bearerидентификатор комментария в path2026-08-13, 200
DELETE /api/comments/{commentId}/likeitd.comments.unlike()Bearerидентификатор комментария в path2026-08-13, 200

Хештеги и поиск ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/hashtags/trendingitd.hashtags.trending()необязательноquery: limit2026-08-22, 200
GET /api/hashtags/{tag}/postsitd.hashtags.posts(), iteratePosts()необязательноquery: limit, cursor2026-08-22, 200
GET /api/searchitd.search.all()необязательноquery: q → пользователи и хештеги2026-08-22, 200

Уведомления и события ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/notifications/itd.notifications.list(), iterate()Bearerquery: limit, offset2026-08-13, 200
GET /api/notifications/countitd.notifications.count()Bearerответ: count2026-08-13, 200
POST /api/notifications/{notificationId}/readitd.notifications.markRead()Bearerответ: markedCount2026-08-13, 200
POST /api/notifications/read-batchitd.notifications.markReadBatch()Bearerids[] → markedCount2026-08-13, 200
POST /api/notifications/read-allitd.notifications.markAllRead()Bearerответ: markedCount2026-08-13, 200
GET /api/notifications/settingsitd.notifications.getSettings()Bearerответ: настройки уведомлений2026-08-13, 200
PUT /api/notifications/settingsitd.notifications.updateSettings()Bearerизменяемые настройки уведомлений—
GET /api/notifications/streamitd.notifications.eventsBearerSSE-поток уведомлений2026-07-30, 200

Файлы ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
POST /api/files/uploaditd.files.upload(), uploadMany()Bearermultipart/form-data, поле file2026-08-13, 201
GET /api/files/{fileId}itd.files.get()Bearerидентификатор файла в path2026-08-13, 404
DELETE /api/files/{fileId}itd.files.remove()Bearerидентификатор файла в path2026-08-13, 204

Жалобы и верификация ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
POST /api/reportsitd.reports.create()Bearerцель, причина и комментарий жалобы—
GET /api/verification/statusitd.verification.status()Bearerответ: статус заявки2026-08-13, 200
POST /api/verification/submititd.verification.submit()BearervideoUrl—

Подписка ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/v1/subscription/itd.subscription.status()Bearerответ: состояние подписки2026-08-13, 200
POST /api/v1/subscription/payitd.subscription.pay()Bearerbody отсутствует—
POST /api/v1/subscription/auto-renewalitd.subscription.setAutoRenewal()Bearerenabled—
POST /api/v1/subscription/bind-carditd.subscription.bindCard()Bearerbody отсутствует—
GET /api/v1/subscription/methodsitd.subscription.methods()Bearerответ: способы оплаты2026-08-13, 200
POST /api/v1/subscription/methods/{methodId}/defaultitd.subscription.setDefaultMethod()Bearerидентификатор способа оплаты в path—
DELETE /api/v1/subscription/methods/{methodId}itd.subscription.removeMethod()Bearerидентификатор способа оплаты в path—

Платформа ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/platform/versionitd.platform.version()неткарта клиентов с minVersion, latestVersion, updateUrl2026-08-22, 200
GET /api/platform/changelogitd.platform.changelog()необязательноответ: список изменений2026-08-22, 200
GET /api/platform/announcementsitd.platform.announcements()необязательноответ: announcements[]2026-08-22, 200
GET /api/v1/portalitd.platform.portal()необязательноответ: данные портала2026-08-22, 200
GET /api/statusitd.platform.status()нетотдельный status host; ответ: состояние сервисов2026-08-22, 200

Телеметрия ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
POST /api/v1/iitd.telemetry.dwell()Bearerсобытия просмотра sid, e[]2026-08-13, 204
POST /api/v1/xitd.telemetry.interaction()Bearerсобытия взаимодействия sid, e[]2026-08-13, 204

Магазин ​

МаршрутМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/v1/shop/productsitd.shop.products.list()необязательноответ: товары2026-08-13, 200
GET /api/v1/shop/products/{productId}itd.shop.products.get()необязательноидентификатор товара в path; 404 → null2026-08-13, 200
GET /api/v1/shop/delivery/countriesitd.shop.delivery.countries()необязательноответ: страны доставки2026-08-13, 200
GET /api/v1/shop/delivery/citiesitd.shop.delivery.cities()необязательноquery: q, country2026-08-13, 200
GET /api/v1/shop/delivery/pointsitd.shop.delivery.points()необязательноquery: cityCode2026-08-13, 200
POST /api/v1/shop/delivery/calculateitd.shop.delivery.calculate()необязательнопозиции заказа и город доставки2026-08-13
POST /api/v1/shop/ordersitd.shop.orders.create()необязательнозаказ; заголовок Idempotency-Key—
GET /api/v1/shop/orders/myitd.shop.orders.list()Bearer или X-Order-Tokenответ: заказы покупателя2026-08-13, 200
GET /api/v1/shop/orders/{number}itd.shop.orders.get()Bearer или X-Order-Tokenномер заказа в path—
POST /api/v1/shop/orders/{number}/payitd.shop.orders.pay()Bearer или X-Order-TokenreturnUrl → адрес оплаты—
POST /api/v1/shop/orders/lookup/requestitd.shop.orders.requestAccessCode()нетадрес почты; ответ отбрасывается—
POST /api/v1/shop/orders/lookup/verifyitd.shop.orders.verifyAccessCode()нетадрес почты и код → X-Order-Token—
POST /api/v1/shop/consentsitd.shop.consents.record()необязательносогласия и контекст формы—

Документация itd-api

MIT License