25 lines
1.4 KiB
Markdown
25 lines
1.4 KiB
Markdown
# 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.
|