itd-api

Тема

Матрица покрытия endpoint ​

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

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

EndpointМетод библиотекиАвторизацияОсновной контрактПроверено
POST /api/v1/auth/sign-upitd.auth.signUp()нетemail, password, turnstileToken → flowToken—
POST /api/v1/auth/sign-initd.auth.signIn()нетemail, password, turnstileToken → 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, turnstileToken → 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-07-30, 200
GET /api/v1/auth/sessionsitd.auth.sessions()Bearerответ: sessions[]2026-07-30, 200
DELETE /api/v1/auth/sessions/{sessionId}itd.auth.revokeSession()Bearerидентификатор сессии в path—
DELETE /api/v1/auth/sessionsitd.auth.revokeOtherSessions(), itd.auth.logoutAll()Bearerзавершение остальных сессий—

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

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

EndpointМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/users/meitd.users.me()Bearerответ: текущий пользователь2026-07-30, 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-07-30, 200
GET /api/users/check-usernameitd.users.checkUsername()Bearerquery: username2026-07-30, 200
GET /api/users/searchitd.users.search()Bearerquery: q, limit2026-07-30, 200
GET /api/users/suggestions/who-to-followitd.users.whoToFollow()Bearerответ: users[]2026-07-30, 200
GET /api/users/stats/top-clansitd.users.topClans()Bearerответ: clans[]2026-07-30, 200
POST /api/users/{user}/followitd.users.follow()Bearerid или username в path—
DELETE /api/users/{user}/followitd.users.unfollow()Bearerid или username в path—
GET /api/users/{user}/followersitd.users.followers(), iterateFollowers()Bearerquery: page, limit2026-07-30, 200
GET /api/users/{user}/followingitd.users.following(), iterateFollowing()Bearerquery: page, limit2026-07-30, 200
POST /api/users/follow-statusitd.users.followStatus()BeareruserIds[] → карта статусов—
POST /api/users/{user}/blockitd.users.block()Bearerid или username в path—
DELETE /api/users/{user}/blockitd.users.unblock()Bearerid или username в path—
GET /api/users/me/blockeditd.users.blocked(), iterateBlocked()Bearerquery: page, limit2026-07-30, 200
GET /api/users/me/privacyitd.users.getPrivacy()Bearerответ: настройки приватности2026-07-30, 200
PUT /api/users/me/privacyitd.users.updatePrivacy()Bearerизменяемые настройки приватности—
GET /api/users/me/pinsitd.users.pins()Bearerответ: pins[], activePin2026-07-30, 200
PUT /api/users/me/pinitd.users.setPin()Bearerslug—
DELETE /api/users/me/pinitd.users.removePin()Bearerbody отсутствует—

Посты ​

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

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

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

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

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

Уведомления и realtime ​

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

Файлы ​

EndpointМетод библиотекиАвторизацияОсновной контрактПроверено
POST /api/files/uploaditd.files.upload(), uploadMany()Bearermultipart/form-data, поле file—
GET /api/files/{fileId}itd.files.get()Bearerидентификатор файла в path → сведения о файле—
DELETE /api/files/{fileId}itd.files.remove()Bearerидентификатор файла в path—

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

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

Подписка ​

EndpointМетод библиотекиАвторизацияОсновной контрактПроверено
GET /api/v1/subscription/itd.subscription.status()Bearerответ: состояние подписки2026-07-30, 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-07-30, 200
POST /api/v1/subscription/methods/{methodId}/defaultitd.subscription.setDefaultMethod()Bearerидентификатор способа оплаты в path—
DELETE /api/v1/subscription/methods/{methodId}itd.subscription.removeMethod()Bearerидентификатор способа оплаты в path—

Платформа ​

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

Телеметрия ​

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

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

MIT License