변경 이력

첫 번째 릴리스입니다. 0.0.8 시점의 TypeScript SDK 전체와 그 뒤로 예정된 변경을 포함합니다. 41개 네임스페이스에 걸친 430개 메서드가 각각 TypeScript 이름을 snake_case로 바꾼 이름으로 제공됩니다. 패리티 검사는 그 모두가 TypeScript 짝이 보내는 것과 정확히 같은 요청을 보낸다는 것을, 옵션 없이 한 번, 모든 옵션을 지정해 한 번 실행하여 증명합니다.

• —OpenEmail과 AsyncOpenEmail에는 emails, threads, templates부터 provider_imports, dns_connections, account까지 모든 네임스페이스에 대응하는 속성이 있습니다. listAll은 list_all, getActive는 get_active, tempMail은 temp_mail입니다.
• —요청 본문은 키가 API의 camelCase 이름을 그대로 쓰는 dict이고, 호출 옵션은 idempotency_key=나 limit= 같은 snake_case 키워드 인자이며, 응답은 dict로 돌아옵니다. 모든 본문과 결과에는 TypeScript와 같은 이름의 TypedDict가 openemail.types에 있습니다.
• —AsyncOpenEmail은 같은 인자를 받는 같은 메서드를 await로 호출하는 형태로 갖추고 있으며, asyncio와 trio 모두에서 동작합니다.
• —페이지로 나뉘는 모든 리소스에는 한 페이지를 위한 list, 모든 항목을 리스트로 받는 list_all, 그리고 항목을 하나씩 내주며 다음 페이지는 거기에 도달했을 때만 가져오는 iterate가 있습니다.
• —API의 거부는 OpenEmailApiError를 발생시키며, 여기에는 status, type, code, param, request_id와 is_validation, is_not_found, is_rate_limited, is_step_up_required, is_retryable 등의 검사가 있습니다. 응답이 아예 없으면 OpenEmailNetworkError를 발생시키며, 기한이 지났다면 is_timeout이 붙습니다.
• —from openemail import openemail은 처음 사용할 때 OPENEMAIL_API_KEY로 만들어지는 미리 준비된 클라이언트이며, init은 시작할 때 이를 한 번 구성합니다. create_temp_mail과 create_async_temp_mail은 자격 증명 없이 일회용 받은편지함을 엽니다.
• —access_token=은 OAuth 액세스 토큰이나 그 토큰을 반환하는 함수를 받으며, 함수는 매 요청 전에 호출됩니다. verify_webhook_signature는 전달을 상수 시간으로 검증하고 파싱된 이벤트를 반환합니다. client.raw.request는 아직 어떤 메서드도 감싸지 않은 엔드포인트에 닿습니다.
• —읽기는 408과 5xx에서 재시도되며, 429는 Retry-After가 있을 때만 재시도됩니다. timeout은 응답 본문까지 포함한 시도 전체의 상한이며, 자격 증명은 이 컴퓨터의 서버가 아니면 암호화되지 않은 HTTP로 보내지지 않습니다.
• —Python 3.10 이상이 필요하며, httpx, anyio, typing-extensions에만 의존합니다.