Error Reference

HTTP status codes and machine-readable error codes

All AWSYS.CO API errors return a consistent JSON body with a human-readable message and a machine-readable code your application can switch on:

{
  "error": "Human-readable message",
  "code": "MACHINE_READABLE_CODE"
}

HTTP Status Codes

Error Code Reference

Handling Errors in Code

const res = await fetch('https://awsys.co/api/createShort', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.AWSYS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ long: btoa('https://example.com') }),
});

if (!res.ok) {
  const err = await res.json();
  switch (err.code) {
    case 'INVALID_TOKEN':
      console.error('Check your API key in Settings → API');
      break;
    case 'DAILY_LIMIT_REACHED':
      console.error('Daily link limit reached — upgrade to Pro for more');
      break;
    case 'SLUG_TAKEN':
      console.error('Choose a different custom slug');
      break;
    case 'RATE_LIMITED':
      const retryAfter = res.headers.get('Retry-After') || 60;
      console.error(`Rate limited — retry in ${retryAfter}s`);
      break;
    default:
      console.error(`API error ${res.status}: ${err.error}`);
  }
  throw new Error(err.code);
}

const data = await res.json();
console.log('Short link created:', data.url);

Common Mistakes