{
  "application_id": "123abc987def456fed789cba432bcdaa",
  "enrollees": [],
  "message": "The request could not be processed due to validation errors.",
  "errors": [
    {
      "error_code": "INVALID_SSN_FORMAT",
      "message": "The SSN provided is invalid. Please verify and resubmit."
    }
  ]
}

import time
import random

def retry_with_backoff(request_func, max_retries=3):
    """Retry a request with exponential backoff."""
    for attempt in range(max_retries):
        response = request_func()

        if response.status_code != 503:
            return response

        # Exponential backoff with jitter
        wait_time = (2 ** attempt) + random.uniform(0, 1)
        time.sleep(wait_time)

    return response  # Return last response after all retries

{
  "application_id": null,
  "enrollees": [],
  "message": "The request could not be processed due to validation errors.",
  "errors": [
    {
      "error_code": "INVALID_SSN_FORMAT",
      "message": "The SSN provided is invalid. Please verify and resubmit."
    },
    {
      "error_code": "INVALID_DATE_FORMAT",
      "message": "The date format is invalid."
    }
  ]
}

{
  "application_id": "abc123def456789012345678abcdef12",
  "enrollees": [],
  "message": "The request could not be processed due to validation errors.",
  "errors": [
    {
      "error_code": "MEMBER_NOT_FOUND",
      "message": "Could not match the member to an existing record."
    }
  ]
}

{
  "application_id": null,
  "enrollees": [],
  "message": "The service is temporarily unavailable. Please retry.",
  "errors": [
    {
      "error_code": "SERVICE_TEMPORARILY_UNAVAILABLE",
      "message": "There are pending transactions for this member. Please try again later."
    }
  ]
}

{
  "application_id": "def456abc789012345678901fedcba98",
  "enrollees": [],
  "message": "An error occurred processing your request.",
  "errors": [
    {
      "error_code": "ELIGIBILITY_CONFLICT",
      "message": "An eligibility conflict was detected. Please contact Oscar support."
    }
  ]
}

import requests

def update_membership(request_data):
    response = requests.post(
        "https://ichra-api.hioscar.com:444/ichra-api/v1/memberships/update-membership",
        json=request_data,
        cert=("client.crt", "client.key"),
    )

    if response.status_code == 200:
        return response.json()

    error_response = response.json()

    # Handle by category
    if response.status_code == 400:
        # ACTIONABLE: Fix the request
        for error in error_response.get("errors", []):
            print(f"Fix {error['error_code']}: {error['message']}")
        raise ValueError("Request validation failed")

    elif response.status_code == 503:
        # RETRY: Transient error
        raise RetryableError("Service temporarily unavailable")

    elif response.status_code == 500:
        # ESCALATE: Contact Oscar support
        app_id = error_response.get("application_id")
        raise InternalError(f"Contact Oscar support. Application ID: {app_id}")

    else:
        raise Exception(f"Unexpected error: {response.status_code}")

async function updateMembership(requestData) {
  const response = await fetch(
    'https://ichra-api.hioscar.com:444/ichra-api/v1/memberships/update-membership',
    {
      method: 'POST',
      headers: {'Content-Type': 'application/json'},
      body: JSON.stringify(requestData),
    },
  );

  const data = await response.json();

  if (response.ok) {
    return data;
  }

  // Handle by status code
  switch (response.status) {
    case 400:
      // ACTIONABLE: Log errors for fixing
      data.errors.forEach((error) => {
        console.error(`${error.error_code}: ${error.message}`);
      });
      throw new ValidationError(data.errors);

    case 503:
      // RETRY: Throw retryable error
      throw new RetryableError(data.message);

    case 500:
      // ESCALATE: Log application_id for support
      console.error(`Contact Oscar support. Application ID: ${data.application_id}`);
      throw new InternalError(data.message);

    default:
      throw new Error(`Unexpected error: ${response.status}`);
  }
}