randomayzer/docs/VK_ERROR_MODEL.md

1.4 KiB

VK API Error Model & Mapping

Randomayzer translates raw VK API response errors into typed error classes under src/integrations/vk/vk-errors.ts.


Error Classification & Retry Matrix

Error Class Category VK Error Code(s) Retryable? Description
VkAuthError AUTH 4, 5, 28 No Invalid, expired, or unauthorized access token.
VkPermissionError PERMISSION 7, 260 No Permission to perform action denied.
VkPrivateResourceError PRIVATE_RESOURCE 15, 30, 203 No Target profile, group, or wall post is private.
VkNotFoundError NOT_FOUND 104, 210, 214 No Post or community does not exist.
VkValidationError VALIDATION 100, 113, 150 No Invalid query parameters or bad request.
VkRateLimitError RATE_LIMIT 6, 9, 29 Yes Too many requests per second or flood control.
VkTemporaryError TEMPORARY 1, 10, 500..504 Yes Unknown or internal VK server error.
VkNetworkError NETWORK - Yes Socket error, connection drop, DNS resolution failure.
VkTimeoutError TIMEOUT - Yes Request exceeded timeout duration.

Token Redaction in Error Traces

All error messages and request_params returned by VK are passed through a strict sanitizer that redacts any access_token parameter before instantiating the error object.