V2RatelimitLimitResponseData

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/V2RatelimitLimitResponseData",
  "title": "V2RatelimitLimitResponseData",
  "type": "object",
  "properties": {
    "limit": {
      "description": "The maximum number of operations allowed within the time window. This reflects either the default limit specified in the request or an override limit if one exists for this identifier.\n\nThis value helps clients understand their total quota for the current window.",
      "format": "int64",
      "type": "integer"
    },
    "remaining": {
      "description": "The number of operations remaining in the current window before the rate limit is exceeded. Applications should use this value to:\n\n- Implement client-side throttling before hitting limits\n- Display usage information to end users\n- Trigger alerts when approaching limits\n- Adjust request patterns based on available capacity\n\nWhen this reaches zero, requests will be rejected until the window resets.",
      "format": "int64",
      "type": "integer"
    },
    "reset": {
      "description": "The Unix timestamp in milliseconds when the rate limit window will reset and 'remaining' will return to 'limit'.\n\nThis timestamp enables clients to:\n- Calculate and display wait times to users\n- Implement intelligent retry mechanisms\n- Schedule requests to resume after the reset\n- Implement exponential backoff when needed\n\nThe reset time is based on a sliding window from the first request in the current window.",
      "format": "int64",
      "type": "integer"
    },
    "success": {
      "description": "Whether the request passed the rate limit check. If true, the request is allowed to proceed. If false, the request has exceeded the rate limit and should be blocked or rejected.\n\nYou MUST check this field to determine if the request should proceed, as the endpoint always returns `HTTP 200` even when rate limited.",
      "type": "boolean"
    },
    "overrideId": {
      "description": "If a rate limit override was applied for this identifier, this field contains the ID of the override that was used. Empty when no override is in effect.\n\nThis can be useful for:\n- Debugging which override rule was matched\n- Tracking the effects of specific overrides\n- Understanding why limits differ from default values",
      "type": "string",
      "x-go-type-skip-optional-pointer": true,
      "x-go-type-skip-optional-pointer-with-omitzero": true
    }
  },
  "required": [
    "limit",
    "remaining",
    "reset",
    "success"
  ]
}