Errors & Status Codes

const axios = require('axios');
async function callSoftymizeApi(endpoint, payload) {
  try {
    const response = await axios.post(`https://api.softymize.com/api/v1${endpoint}`, payload, {
      headers: {
        'X-Softymize-API-Key': process.env.SOFTYMIZE_API_KEY,
        'Content-Type': 'application/json'
      }
    });
    return response.data;
  } catch (err) {
    if (err.response) {
      const { status, data } = err.response;
      const requestId = data.meta?.request_id;
      const errorCode = data.error?.code;
      console.error(`[Softymize API Error ${status}] Code: ${errorCode} | Request ID: ${requestId}`);
      switch (status) {
        case 401:
          // Invalid API Key - alert devops
          throw new Error('Softymize API Key is invalid or expired.');
        case 403:
          // Scope or permission mismatch
          throw new Error(`Permission Denied: ${data.error?.message}`);
        case 422:
          // Validation error - do not retry automatically!
          console.error('Payload validation failed:', data.error);
          throw new Error(`Validation Error: ${data.error?.message}`);
        case 429:
          // Rate limited - inspect retry_after
          const retrySeconds = data.error?.retry_after || 10;
          console.warn(`Rate limited. Need to wait ${retrySeconds}s before next call.`);
          break;
        case 500:
        case 502:
        case 503:
          // Server error - safe to retry with exponential backoff
          console.warn('Transient server error. Scheduling retry...');
          break;
        default:
          throw err;
      }
    } else {
      // Network or connection timeout
      console.error('Network Error:', err.message);
    }
    throw err;
  }
}