API › Rate limit

Rate limit

Каждый action имеет лимит запросов. Ключ ведра зависит от природы action: по IP (для анонимных), по user_id (для авторизованных) или по session.

Превышение → ответ {"ok":false,"error":"rate_limited"} с HTTP-заголовком Retry-After: <seconds>.

Сводная таблица

act	лимит	окно	ключ	источник
`csrf_token`	60	1 мин	session	custom
`auth_me`	60	1 мин	ip	default
`auth_login`	10	1 ч	ip	custom
`auth_signup`	3	1 ч	ip	custom
`auth_logout`	30	1 мин	user	default
`auth_token_issue`	10	1 ч	ip	custom
`auth_token_revoke`	30	1 ч	user	custom
`auth_password_reset_request`	3	1 ч	ip	custom
`auth_password_reset_confirm`	10	1 ч	ip	custom
`im_load_users`	120	1 мин	user	default
`im_show_history`	120	1 мин	user	default
`im_unread_total`	120	1 мин	user	default
`im_search`	120	1 мин	user	default
`im_send`	60	1 мин	user	custom
`im_send_voice`	20	1 мин	user	custom
`im_send_circle`	20	1 мин	user	custom
`im_mark_read`	30	1 мин	user	default
`im_delete_pm`	30	1 мин	user	default
`im_edit_pm`	30	1 мин	user	default
`im_delete_convo`	30	1 мин	user	default
`im_start`	30	1 мин	user	default
`im_start_group`	20	1 мин	user	custom
`im_add_peers`	30	1 мин	user	custom
`im_remove_peer`	30	1 мин	user	custom
`im_leave`	30	1 мин	user	custom
`im_set_subject`	30	1 мин	user	custom
`im_convo_peers`	120	1 мин	user	default
`im_typing`	120	1 мин	user	custom
`im_typing_get`	120	1 мин	user	default
`home_list`	120	1 мин	user	default
`home_set_type`	30	1 мин	user	default
`search`	30	1 мин	user	custom
`post_get`	120	1 мин	user	default
`post_comments_list`	120	1 мин	user	default
`post_create`	10	1 ч	user	custom
`post_edit`	30	1 мин	user	default
`post_delete`	30	1 мин	user	default
`post_set_fixed`	30	1 мин	user	default
`post_comment_add`	30	1 мин	user	custom
`post_comment_delete`	30	1 мин	user	default
`post_comment_edit`	30	1 мин	user	default
`group_list`	60	1 мин	user	custom
`group_get`	120	1 мин	user	default
`group_topics_list`	60	1 мин	user	custom
`group_join`	30	1 ч	user	custom
`group_leave`	30	1 ч	user	custom
`group_create`	10	1 ч	user	custom
`group_edit`	30	1 ч	user	custom
`group_photo_upload`	30	1 мин	user	default
`group_photo_delete`	30	1 мин	user	default
`group_invite`	30	1 ч	user	custom
`group_members`	120	1 мин	user	default
`group_member_approve`	60	1 мин	user	custom
`group_member_reject`	60	1 мин	user	custom
`group_member_remove`	60	1 мин	user	custom
`group_member_set_rank`	60	1 мин	user	custom
`group_post_get`	120	1 мин	user	default
`group_post_comments_list`	120	1 мин	user	default
`group_post_create`	20	1 ч	user	custom
`group_post_edit`	30	1 ч	user	custom
`group_post_delete`	30	1 мин	user	default
`group_post_comment_add`	30	1 мин	user	custom
`group_post_comment_delete`	30	1 мин	user	default
`group_post_comment_edit`	30	1 мин	user	default
`group_post_set_sticky`	60	1 ч	user	custom
`group_blacklist_list`	120	1 мин	user	default
`group_blacklist_add`	30	1 ч	user	custom
`group_blacklist_remove`	30	1 ч	user	custom
`like_list`	120	1 мин	user	default
`like_check`	120	1 мин	user	default
`like_add`	120	1 мин	user	custom
`like_remove`	120	1 мин	user	custom
`like_toggle`	120	1 мин	user	custom
`notify_counters`	120	1 мин	user	default
`notify_summary`	120	1 мин	user	default
`notify_delete`	60	1 мин	user	custom
`notify_delete_all`	5	1 мин	user	custom
`user_get`	120	1 мин	user	default
`user_search`	30	1 мин	user	custom
`user_update`	30	1 мин	user	default
`user_photo_upload`	30	1 мин	user	default
`user_photo_delete`	30	1 мин	user	default
`profile_fields_get`	120	1 мин	user	default
`profile_fields_set`	30	1 мин	user	default
`profile_comments_list`	120	1 мин	user	default
`profile_comment_add`	30	1 мин	user	default
`profile_comment_delete`	30	1 мин	user	default
`profile_comment_edit`	30	1 мин	user	default
`comment_subscribe_get`	120	1 мин	user	default
`comment_subscribe_set`	30	1 мин	user	default
`device_register`	30	1 мин	user	default
`device_unregister`	30	1 мин	user	default
`friend_list`	120	1 мин	user	default
`friend_requests`	120	1 мин	user	default
`friend_requests_outgoing`	120	1 мин	user	default
`friend_check`	120	1 мин	user	default
`friend_add`	20	1 ч	user	custom
`friend_accept`	30	1 мин	user	default
`friend_reject`	30	1 мин	user	default
`friend_cancel`	30	1 мин	user	default
`friend_remove`	30	1 мин	user	default
`blog_list`	120	1 мин	user	default
`blog_cats`	120	1 мин	user	default
`blog_cat_create`	20	1 ч	user	custom
`blog_cat_rename`	30	1 ч	user	custom
`blog_cat_delete`	30	1 ч	user	custom
`subs_list`	120	1 мин	user	default
`subs_followers`	120	1 мин	user	default
`subs_add`	30	1 ч	user	custom
`subs_remove`	30	1 мин	user	default
`gift_catalog`	120	1 мин	user	default
`gift_send`	30	1 мин	user	default
`gift_received`	120	1 мин	user	default
`gift_sent`	120	1 мин	user	default
`invite_send`	5	1 ч	user	custom
`report_send`	10	1 ч	user	custom
`block_list`	120	1 мин	user	default
`block_add`	30	1 ч	user	custom
`block_remove`	30	1 ч	user	custom
`account_privacy_get`	120	1 мин	user	default
`account_privacy_set`	30	1 ч	user	custom
`account_password_change`	10	1 ч	user	custom
`account_email_change`	5	1 ч	user	custom
`account_captcha_submit`	20	1 ч	user	custom
`account_delete`	3	1 ч	user	custom
`account_notify_get`	120	1 мин	user	default
`account_notify_set`	30	1 мин	user	default

Стратегии ключей

ip

Один лимит на IP-адрес. Используется для анонимных и public-actions.

user

Один лимит на user_id текущего пользователя.

session

Один лимит на PHP-сессию / bearer-токен.

Дефолты

Для action без явной политики применяются дефолтные значения из api_rl_resolve():

Тип action	Лимит	Окно	Ключ
read · auth	120	1 мин	`user`
read · public	60	1 мин	`ip`
write · auth	30	1 мин	`user`
write · public	10	1 мин	`ip`

При недоступности backend-storage (cache) лимит fail-open — запросы не блокируются, чтобы не положить сайт из-за проблем с кэшем.