1{
2  "success": false,
3  "error": {
4    "code": "rate_limit_exceeded",
5    "message": "Rate limit exceeded. Please try again later",
6    "status": 429,
7    "retry_after": 30
8  }
9}

1async function makeApiRequest(url, options, retries = 3) {
2  try {
3    const response = await fetch(url, options);
4    
5    // Check if rate limited
6    if (response.status === 429) {
7      const data = await response.json();
8      const retryAfter = data.error.retry_after || 60; // Default to 60 seconds
9      
10      console.log(`Rate limited. Retrying after ${retryAfter} seconds`);
11      
12      if (retries > 0) {
13        // Wait for the specified time
14        await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
15        
16        // Retry the request with one less retry
17        return makeApiRequest(url, options, retries - 1);
18      } else {
19        throw new Error('Maximum retries reached');
20      }
21    }
22    
23    return response;
24  } catch (error) {
25    console.error('API request failed:', error);
26    throw error;
27  }
28}
29
30// Example usage
31makeApiRequest('https://api.thenews.africca/api/subscribe', {
32  method: 'POST',
33  headers: {
34    'Content-Type': 'application/json',
35    'Authorization': `Bearer ${API_KEY}`
36  },
37  body: JSON.stringify({
38    email: 'subscriber@example.com',
39    name: 'John Doe'
40  })
41})
42.then(response => response.json())
43.then(data => console.log(data))
44.catch(error => console.error('Error:', error));

1{
2  "success": false,
3  "error": {
4    "code": "error_code",
5    "message": "A human-readable error message",
6    "status": 400,
7    "details": { /* Additional error details if available */ }
8  }
9}

1fetch('https://api.thenews.africa/api/subscribe', {
2  method: 'POST',
3  headers: {
4    'Content-Type': 'application/json',
5    'Authorization': `Bearer ${API_KEY}`
6  },
7  body: JSON.stringify({
8    email: 'subscriber@example.com',
9    name: 'John Doe'
10  })
11})
12.then(response => response.json())
13.then(data => {
14  if (!data.success) {
15    // Handle specific error codes
16    switch (data.error.code) {
17      case 'invalid_email':
18        console.error('Please provide a valid email address');
19        break;
20      case 'newsletter_not_found':
21        console.error('The newsletter does not exist');
22        break;
23      case 'subscriber_exists':
24        console.error('This email is already subscribed');
25        break;
26      case 'rate_limit_exceeded':
27        console.error(`Too many requests. Try again in ${data.error.retry_after} seconds`);
28        break;
29      default:
30        console.error(`Error: ${data.error.message}`);
31    }
32    return;
33  }
34  
35  // Handle success
36  console.log('Subscription successful!', data);
37})
38.catch(error => {
39  // Handle network errors
40  console.error('Network error:', error);
41});

1function handleApiError(error) {
2  // Log the error for debugging
3  console.error('API Error:', error);
4  
5  // Handle specific error codes
6  switch (error.code) {
7    case 'invalid_email':
8      return 'Please provide a valid email address';
9    case 'newsletter_not_found':
10      return 'The newsletter category does not exist';
11    case 'subscriber_exists':
12      return 'This email is already subscribed';
13    case 'rate_limit_exceeded':
14      return `Too many requests. Try again in ${error.retry_after} seconds`;
15    default:
16      return 'An error occurred. Please try again later';
17  }
18}
19
20// Example usage
21fetch('https://api.thenews.africa/api/subscribe', {
22  method: 'POST',
23  headers: {
24    'Content-Type': 'application/json',
25    'Authorization': `Bearer ${API_KEY}`
26  },
27  body: JSON.stringify({
28    email: 'subscriber@example.com',
29    newsletter_id: 'news_1a2b3c4d5e6f'
30  })
31})
32.then(response => response.json())
33.then(data => {
34  if (!data.success) {
35    const errorMessage = handleApiError(data.error);
36    showErrorToUser(errorMessage);
37    return;
38  }
39  
40  // Handle success
41  showSuccessToUser('Subscription successful!');
42})
43.catch(error => {
44  // Handle network errors
45  showErrorToUser('Network error. Please check your connection');
46});

1// Simple in-memory cache
2const cache = new Map();
3const CACHE_TTL = 60 * 1000; // 1 minute in milliseconds
4
5async function fetchWithCache(url, options) {
6  const cacheKey = `${url}-${JSON.stringify(options.body || {})}`;
7  
8  // Check if we have a cached response
9  if (cache.has(cacheKey)) {
10    const { data, timestamp } = cache.get(cacheKey);
11    
12    // Check if the cache is still valid
13    if (Date.now() - timestamp < CACHE_TTL) {
14      console.log('Using cached response');
15      return data;
16    }
17    
18    // Cache expired, remove it
19    cache.delete(cacheKey);
20  }
21  
22  // Make the API request
23  const response = await fetch(url, options);
24  const data = await response.json();
25  
26  // Cache the response if it was successful
27  if (data.success) {
28    cache.set(cacheKey, {
29      data,
30      timestamp: Date.now()
31    });
32  }
33  
34  return data;
35}
36
37// Example usage
38fetchWithCache('https://api.thenews.africa/api/newsletters', {
39  method: 'GET',
40  headers: {
41    'Content-Type': 'application/json',
42    'Authorization': `Bearer ${API_KEY}`
43  }
44})
45.then(data => {
46  if (data.success) {
47    displayNewsletters(data.data);
48  } else {
49    handleApiError(data.error);
50  }
51})
52.catch(error => {
53  console.error('Network error:', error);
54});