Python

SpacePost는 단순한 JSON API이므로 어떤 HTTP 클라이언트든 사용할 수 있습니다. 공식 Python 패키지는 없으니 OpenAPI 명세로 직접 생성하세요.

requests

pip install requests

send.py

import os
import requests

API = "https://api.spacepost.dev"
HEADERS = {"Authorization": f"Bearer {os.environ['SPACEPOST_API_KEY']}"}

def send_email(to: str, subject: str, html: str, idempotency_key: str | None = None) -> dict:
    headers = dict(HEADERS)
    if idempotency_key:
        headers["Idempotency-Key"] = idempotency_key
    r = requests.post(
        f"{API}/emails",
        headers=headers,
        json={"from": "Acme <hello@acme.com>", "to": [to], "subject": subject, "html": html},
        timeout=15,
    )
    body = r.json()
    if not r.ok:
        # {"statusCode": 422, "name": "validation_error", "message": "..."}
        raise RuntimeError(f"{body['name']}: {body['message']}")
    return body  # {"id": "..."}

if __name__ == "__main__":
    print(send_email("delivered@test.spacepost.dev", "Hello from Python", "<p>It works.</p>"))

httpx (비동기)

pip install httpx

send.py

import asyncio
import os
import httpx

async def main() -> None:
    async with httpx.AsyncClient(
        base_url="https://api.spacepost.dev",
        headers={"Authorization": f"Bearer {os.environ['SPACEPOST_API_KEY']}"},
        timeout=15,
    ) as client:
        r = await client.post(
            "/emails",
            json={
                "from": "Acme <hello@acme.com>",
                "to": ["delivered@test.spacepost.dev"],
                "subject": "Hello from httpx",
                "html": "<p>It works.</p>",
            },
        )
        r.raise_for_status()
        print(r.json())

asyncio.run(main())

429는 retry-after 헤더만큼 대기한 뒤 같은 Idempotency-Key로 다시 시도해 처리하세요. 요청 한도와 멱등성 키를 참고하세요.

Django, Flask 등 다른 프레임워크에서는 SMTP 릴레이를 사용할 수도 있습니다.