Configuration Models

from intapp_rest_client import OAuth2Config, OAuth2GrantType
 
config = OAuth2Config(
    token_url="https://api.example.com/oauth/token",
    client_id="your_client_id",
    client_secret="your_secret",
    grant_type=OAuth2GrantType.CLIENT_CREDENTIALS,  # Default
    scope="data",
    token_refresh_margin=30  # Refresh 30s before expiry
)

from intapp_rest_client import OAuth2GrantType
 
OAuth2GrantType.CLIENT_CREDENTIALS  # Default, for service-to-service
OAuth2GrantType.PASSWORD            # For user credentials
OAuth2GrantType.REFRESH_TOKEN       # Token refresh
OAuth2GrantType.AUTHORIZATION_CODE  # Interactive OAuth flow

from intapp_rest_client import JWTConfig
 
config = JWTConfig(
    secret_key="your-secret-key",
    algorithm="HS256",
    token_lifetime=3600,
    issuer="my-service",
    audience="api.example.com",
    custom_claims={"user_id": 123}
)

from intapp_rest_client import RetryConfig
 
config = RetryConfig(
    max_retries=5,
    backoff_factor=2.0,
    retryable_statuses=(429, 500, 502, 503, 504),
    respect_retry_after=True,
    max_backoff=60.0,
    retry_count_by_status={429: 10, 500: 2},
    jitter=True,
    jitter_min=0.5,
    jitter_max=1.5
)

config = RetryConfig(...)
 
# Get retry count for a specific status
count = config.get_max_retries_for_status(429)  # Returns per-status or default
 
# Check if status should trigger retry
should_retry = config.should_retry(429)  # True if in retryable_statuses
 
# Copy that drops given statuses from retry lists (e.g. custom transports / fail-fast on 429)
no_429 = config.without_retry_on_statuses(429)

from intapp_rest_client import ConnectionPoolConfig
 
config = ConnectionPoolConfig(
    max_connections=100,
    max_keepalive_connections=20,
    keepalive_expiry=5.0
)

from intapp_rest_client import RestClient, SSLConfig
 
# Custom CA bundle for internal APIs
client = RestClient(
    base_url="https://api.example.com",
    api_key="key",
    ssl_config=SSLConfig(ca_bundle="/etc/ssl/certs/company-ca.crt")
)
 
# Mutual TLS (client certificate)
client = RestClient(
    base_url="https://api.example.com",
    api_key="key",
    ssl_config=SSLConfig(
        client_cert="/path/to/client.crt",
        client_key="/path/to/client.key"
    )
)

from intapp_rest_client import CircuitBreakerConfig
 
config = CircuitBreakerConfig(
    failure_threshold=5,
    reset_timeout=60.0,
    half_open_requests=1,
    failure_statuses=(500, 502, 503, 504),
    count_network_errors=True
)

from intapp_rest_client import CircuitState
 
CircuitState.CLOSED     # Normal operation
CircuitState.OPEN       # Failing fast
CircuitState.HALF_OPEN  # Testing recovery

from intapp_rest_client import EntraConfig
 
config = EntraConfig(
    tenant_id="your-tenant-id",
    client_id="your-client-id",
    client_secret="your-client-secret",
    scope="api://your-api/.default"
)

from intapp_rest_client import OktaConfig
 
config = OktaConfig(
    domain="your-org.okta.com",
    client_id="your-client-id",
    client_secret="your-client-secret",
    scope="api-scope"
)

from intapp_rest_client import LogLevel
 
LogLevel.DEBUG     # 10 - All details
LogLevel.INFO      # 20 - Standard (default)
LogLevel.WARNING   # 30 - Warnings and errors
LogLevel.ERROR     # 40 - Errors only
LogLevel.CRITICAL  # 50 - Critical only

from intapp_rest_client import AuthType
 
AuthType.NONE                      # No authentication
AuthType.OAUTH2_CLIENT_CREDENTIALS # OAuth2 client credentials
AuthType.OAUTH2_PASSWORD           # OAuth2 password grant
AuthType.OAUTH2_REFRESH_TOKEN      # OAuth2 refresh token
AuthType.API_KEY                   # API key (header or query)
AuthType.JWT                       # JWT token
AuthType.BASIC                     # HTTP Basic auth
AuthType.ENTRA_ID                  # Microsoft Entra ID
AuthType.OKTA                      # Okta

from intapp_rest_client import RestClient, ErrorHandling
 
ErrorHandling.FAIL_FAST   # Raise on first error (default)
ErrorHandling.COLLECT     # Collect all errors, return (results, errors)
ErrorHandling.LOG_ONLY    # Log errors and continue, return (results, errors)