Errors

{
  "errors": [
    {
      "message": "The template_id must start with 'd-'",
      "field": "template_id",
      "help": "https://scaisend.scailabs.ai/docs/06-reference/02-mail-send#template-id"
    }
  ]
}

{
  "detail": "Template not found: d-abc123"
}

def extract_error(resp) -> str:
    try:
        body = resp.json()
    except ValueError:
        return resp.text
    if "errors" in body:
        return "; ".join(e.get("message", "") for e in body["errors"])
    if "detail" in body:
        return body["detail"] if isinstance(body["detail"], str) else str(body["detail"])
    return resp.text

{"detail": "Missing Authorization header"}

{"detail": "Invalid API key"}

{"detail": "JWT expired"}

{"detail": "Missing required scope: mail.send"}

{
  "errors": [
    {"message": "Field required", "field": "personalizations"},
    {"message": "Input should be a valid email", "field": "from.email"}
  ]
}

{
  "errors": [
    {"message": "template_id must start with 'd-'", "field": "template_id"}
  ]
}

HTTP/1.1 429 Too Many Requests
Retry-After: 5

{"detail": "Rate limit exceeded"}

{"detail": "Request body exceeds maximum size of 20 MB"}

{"detail": "Template not found: d-abc123"}

import os, time, random, httpx

RETRYABLE = {429, 500, 503}


def request_with_retry(method: str, path: str, *, max_attempts: int = 4, **kwargs):
    url = f"https://scaisend.scailabs.ai{path}"
    headers = {
        "Authorization": f"Bearer {os.environ['SCAISEND_API_KEY']}",
        **kwargs.pop("headers", {}),
    }
    for attempt in range(max_attempts):
        resp = httpx.request(method, url, headers=headers, **kwargs)
        if resp.is_success:
            return resp
        if resp.status_code not in RETRYABLE or attempt == max_attempts - 1:
            resp.raise_for_status()
        retry_after = int(resp.headers.get("Retry-After", "0"))
        time.sleep(retry_after or (2 ** attempt) + random.random())
    raise RuntimeError("unreachable")

const RETRYABLE = new Set([429, 500, 503]);

async function request<T>(
  method: string,
  path: string,
  body?: unknown,
  maxAttempts = 4,
): Promise<T> {
  const url = `https://scaisend.scailabs.ai${path}`;
  const headers: Record<string, string> = {
    "Authorization": `Bearer ${process.env.SCAISEND_API_KEY}`,
    "Content-Type": "application/json",
  };
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const resp = await fetch(url, {
      method,
      headers,
      body: body ? JSON.stringify(body) : undefined,
    });
    if (resp.ok) return resp.json() as Promise<T>;
    if (!RETRYABLE.has(resp.status) || attempt === maxAttempts - 1) {
      const detail = await resp.text();
      throw new Error(`ScaiSend ${resp.status}: ${detail}`);
    }
    const retryAfter = Number(resp.headers.get("Retry-After") ?? 0);
    const delay = (retryAfter || Math.pow(2, attempt) + Math.random()) * 1000;
    await new Promise((r) => setTimeout(r, delay));
  }
  throw new Error("unreachable");
}