Error Handling

The SDK provides detailed error handling through NoCloudAPIError and the NoCloudError enum.

Basic Error Handling

import { NoCloud, NoCloudAPIError } from "@nocloud/sdk";

const cloud = new NoCloud("your-api-key");

try {
  await cloud.storage.upload(file);
} catch (error) {
  if (error instanceof NoCloudAPIError) {
    console.error(`API Error: ${error.message}`);
    console.error(`Status: ${error.status}`);
    console.error(`Code: ${error.code}`);
  }
}

Check for Specific Errors

Use the static isError method to check for specific error types:

import { NoCloudAPIError, NoCloudError } from "@nocloud/sdk";

try {
  await cloud.storage.upload(file);
} catch (error) {
  if (NoCloudAPIError.isError(error, NoCloudError.RATE_LIMIT_EXCEEDED)) {
    console.log("Rate limited, retry later");
  } else if (NoCloudAPIError.isError(error, NoCloudError.INVALID_API_KEY)) {
    console.log("Check your API key");
  } else if (NoCloudAPIError.isError(error)) {
    console.log(`Other API error: ${error.code}`);
  }
}

Error Codes

Code	HTTP Status	Description
`INVALID_API_KEY`	401	Invalid or missing API key
`BAD_REQUEST`	400	Invalid request parameters
`RATE_LIMIT_EXCEEDED`	429	Too many requests
`RESOURCE_NOT_FOUND`	404	File or resource not found
`INTERNAL_SERVER_ERROR`	500	Server error
`UNKNOWN_ERROR`	—	Unexpected error

NoCloudAPIError Properties

Property	Type	Description
`message`	`string`	Human-readable error message
`status`	`number`	HTTP status code
`code`	`NoCloudError`	Error code enum value

Retry Logic

The SDK includes built-in retry logic for transient failures. You can configure the retry behavior when initializing:

const cloud = new NoCloud({
  apiKey: "your-api-key",
  retries: 5, // Retry up to 5 times
  retryDelayMs: 2000 // Wait 2 seconds between retries
});

The SDK will automatically retry failed requests for transient errors (like network issues). It will not retry for client errors like invalid API keys or bad requests.

Handling Rate Limits

When you exceed the rate limit, the SDK throws a RATE_LIMIT_EXCEEDED error:

import { NoCloudAPIError, NoCloudError } from "@nocloud/sdk";

async function uploadWithRetry(file: File, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await cloud.storage.upload(file);
    } catch (error) {
      if (NoCloudAPIError.isError(error, NoCloudError.RATE_LIMIT_EXCEEDED)) {
        // Wait before retrying
        await new Promise((resolve) => setTimeout(resolve, 5000));
        continue;
      }
      throw error;
    }
  }
  throw new Error("Max retries exceeded");
}

CFX SDK

CFX NUI SDK

Node.js SDK

Error Handling

Basic Error Handling

Check for Specific Errors

Error Codes

NoCloudAPIError Properties

Retry Logic

Handling Rate Limits

​Basic Error Handling

​Check for Specific Errors

​Error Codes

​NoCloudAPIError Properties

​Retry Logic

​Handling Rate Limits

Basic Error Handling

Check for Specific Errors

Error Codes

NoCloudAPIError Properties

Retry Logic

Handling Rate Limits