Error Handling - Drime Cloud API

HTTP Status Codes

The Drime Cloud API uses standard HTTP codes:

Code	Meaning
`200`	Success
`201`	Created successfully
`400`	Bad request
`401`	Unauthenticated
`403`	Access denied
`404`	Resource not found
`422`	Validation error
`429`	Too many requests
`500`	Server error

Error Formats

Authentication Error (401)

{
  "message": "Unauthenticated."
}

Verify that your token is valid and sent in the Authorization: Bearer TOKEN header

Permission Error (403)

{
  "message": "This action is unauthorized."
}

Validation Error (422)

{
  "status": "error",
  "message": "The given data was invalid.",
  "errors": {
    "email": ["The email field is required."],
    "password": ["The password must be at least 8 characters."]
  }
}

Resource Not Found (404)

{
  "message": "No query results for model [App\\FileEntry] 123456"
}

Best Practices

Always check the status

const response = await fetch(url, options);

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.message || 'Request failed');
}

Handle validation errors

if (response.status === 422) {
  const { errors } = await response.json();
  // Display errors per field
  Object.entries(errors).forEach(([field, messages]) => {
    console.error(`${field}: ${messages.join(', ')}`);
  });
}

Refresh token if expired

if (response.status === 401) {
  // Token expired, reconnect the user
  await refreshToken();
  // Retry the request
}

Rate Limiting

The API limits request rates to ensure stability:

If you receive a 429 error, wait a few seconds before retrying.

async function fetchWithRetry(url, options, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const waitTime = Math.pow(2, i) * 1000; // Exponential backoff
      await new Promise(r => setTimeout(r, waitTime));
      continue;
    }
    
    return response;
  }
  throw new Error('Max retries exceeded');
}

​HTTP Status Codes

​Error Formats

​Authentication Error (401)

​Permission Error (403)

​Validation Error (422)

​Resource Not Found (404)

​Best Practices

​Rate Limiting

HTTP Status Codes

Error Formats

Authentication Error (401)

Permission Error (403)

Validation Error (422)

Resource Not Found (404)

Best Practices

Rate Limiting