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 中继。