APIエラー

What It Means

The request is malformed or missing required parameters.

Common Causes

• Missing required field in request body
• Invalid parameter value
• Malformed JSON
• Invalid phone number format

How to Fix

1. 1.Check request body has all required fields
2. 2.Verify parameter values are correct type
3. 3.Validate JSON syntax
4. 4.Review API documentation for requirements

What It Means

Authentication failed. Invalid or missing API key.

Common Causes

• API key not provided
• API key is invalid
• API key has expired
• API key revoked

How to Fix

1. 1.Check API key is included in Authorization header
2. 2.Verify API key format: Bearer YOUR_API_KEY
3. 3.Generate new API key in Settings
4. 4.Check API key hasn't been revoked

What It Means

You don't have permission to access this resource.

Common Causes

• API key lacks required permissions
• Accessing another tenant's data
• Feature not available on your plan

How to Fix

1. 1.Check API key has required scopes
2. 2.Verify you're accessing your own data
3. 3.Upgrade plan if feature requires it
4. 4.Contact support for permission issues

What It Means

The requested resource doesn't exist.

Common Causes

• Resource ID is invalid
• Resource has been deleted
• Wrong endpoint URL

How to Fix

1. 1.Verify resource ID is correct
2. 2.Check resource hasn't been deleted
3. 3.Review API documentation for correct endpoint
4. 4.Use list endpoints to find valid IDs

What It Means

You've exceeded the API rate limit.

Common Causes

• Too many requests in short time
• Burst requests without delays
• Account quality rating is low

How to Fix

1. 1.Implement exponential backoff
2. 2.Add delays between requests (100-500ms)
3. 3.Use batch endpoints when available
4. 4.Contact support for rate limit increase

What It Means

Something went wrong on our servers.

Common Causes

• Temporary service outage
• Database error
• Service deployment in progress

How to Fix

1. 1.Wait a few minutes and retry
2. 2.Check status page: status.beecastly.com
3. 3.Implement exponential backoff
4. 4.Contact support if error persists

What It Means

The API service is temporarily unavailable.

Common Causes

• Scheduled maintenance
• Service overload
• Deployment in progress

How to Fix

1. 1.Check status page for maintenance window
2. 2.Wait and retry after 5-10 minutes
3. 3.Implement retry logic with exponential backoff
4. 4.Subscribe to status page updates