Example: Claude Code

1
import os
2
import httpx
3
4
BASE = "https://api.listbee.so"
5
6
api_key = os.environ.get("LISTBEE_API_KEY")
7
8
if api_key:
9
    # Verify the key is valid
10
    resp = httpx.get(
11
        f"{BASE}/v1/account",
12
        headers={"Authorization": f"Bearer {api_key}"},
13
    )
14
    if resp.status_code == 200:
15
        print("API key found and valid.")
16
        account = resp.json()
17
    else:
18
        print("API key found but invalid. Will create a new account.")
19
        api_key = None
20
else:
21
    print("No LISTBEE_API_KEY found. Starting account setup.")

1
# Request OTP
2
httpx.post(
3
    f"{BASE}/v1/account/signup",
4
    json={"email": "alex@example.com"},
5
)

1
# Verify and get API key
2
resp = httpx.post(
3
    f"{BASE}/v1/account/verify",
4
    json={"email": "alex@example.com", "code": "847213"},
5
)
6
data = resp.json()
7
8
api_key = data["api_key"]    # lb_...
9
account = data["account"]
10
11
# Persist the key for future sessions
12
print(f"Add this to your environment:\nexport LISTBEE_API_KEY={api_key}")

1
headers = {"Authorization": f"Bearer {api_key}"}
2
3
readiness = account["readiness"]
4
print(readiness["operational"])  # False — Stripe not connected
5
print(readiness["next"])         # "set_stripe_key"
6
7
action = next(a for a in readiness["actions"] if a["code"] == readiness["next"])
8
print(action["kind"])    # "api"
9
print(action["message"]) # "Submit your Stripe secret key to enable payments."

1
# Submit Stripe key
2
resp = httpx.post(
3
    f"{BASE}/v1/account/stripe-key",
4
    headers=headers,
5
    json={"secret_key": "sk_live_51Abc123..."},
6
)
7
account = resp.json()
8
print(account["readiness"]["operational"])  # True

1
import uuid
2
3
resp = httpx.post(
4
    f"{BASE}/v1/listings",
5
    headers={**headers, "Idempotency-Key": str(uuid.uuid4())},
6
    json={
7
        "name": "Python Async Patterns",
8
        "price": 1900,      # $19.00
9
        "deliverable": "https://alex-bucket.s3.amazonaws.com/python-async.pdf",
10
    },
11
)
12
listing = resp.json()
13
14
print(listing["url"])                   # https://buy.listbee.so/r7kq2xy9
15
print(listing["readiness"]["sellable"]) # True

1
if listing["readiness"]["sellable"]:
2
    print(f"Listing is live: {listing['url']}")
3
else:
4
    # Handle any remaining blockers
5
    next_code = listing["readiness"]["next"]
6
    action = next(
7
        a for a in listing["readiness"]["actions"]
8
        if a["code"] == next_code
9
    )
10
    if action["kind"] == "api":
11
        httpx.request(
12
            action["resolve"]["method"],
13
            f"{BASE}{action['resolve']['endpoint']}",
14
            headers=headers,
15
            json=action["resolve"]["params"],
16
        )
17
    else:
18
        print(f"Action required: {action['message']}")
19
        print(f"Visit: {action['resolve']['url']}")

1
import os
2
import uuid
3
import httpx
4
5
BASE = "https://api.listbee.so"
6
7
8
def get_or_create_account() -> tuple[str, dict]:
9
    """Return (api_key, account) — create account if no key in env."""
10
    api_key = os.environ.get("LISTBEE_API_KEY")
11
12
    if api_key:
13
        resp = httpx.get(f"{BASE}/v1/account", headers={"Authorization": f"Bearer {api_key}"})
14
        if resp.is_success:
15
            return api_key, resp.json()
16
17
    email = input("ListBee email: ").strip()
18
    httpx.post(f"{BASE}/v1/account/signup", json={"email": email})
19
20
    code = input("Verification code from inbox: ").strip()
21
    data = httpx.post(
22
        f"{BASE}/v1/account/verify",
23
        json={"email": email, "code": code},
24
    ).json()
25
26
    api_key = data["api_key"]
27
    print(f"\nSave this: export LISTBEE_API_KEY={api_key}\n")
28
    return api_key, data["account"]
29
30
31
def ensure_stripe(api_key: str, account: dict) -> None:
32
    """Submit Stripe key if not connected."""
33
    if account["readiness"]["operational"]:
34
        return
35
36
    headers = {"Authorization": f"Bearer {api_key}"}
37
    next_code = account["readiness"]["next"]
38
39
    if next_code == "set_stripe_key":
40
        stripe_key = input("Stripe secret key (sk_live_...): ").strip()
41
        httpx.post(
42
            f"{BASE}/v1/account/stripe-key",
43
            headers=headers,
44
            json={"secret_key": stripe_key},
45
        )
46
    elif next_code == "connect_stripe":
47
        url = httpx.post(f"{BASE}/v1/account/stripe/connect", headers=headers).json()["url"]
48
        print(f"Connect Stripe: {url}")
49
        input("Press Enter when done...")
50
51
52
def create_listing(api_key: str, name: str, price_cents: int, content_url: str) -> dict:
53
    """Create listing and return response."""
54
    return httpx.post(
55
        f"{BASE}/v1/listings",
56
        headers={
57
            "Authorization": f"Bearer {api_key}",
58
            "Idempotency-Key": str(uuid.uuid4()),
59
        },
60
        json={
61
            "name": name,
62
            "price": price_cents,
63
            "deliverable": content_url,
64
        },
65
    ).json()
66
67
68
# Main
69
api_key, account = get_or_create_account()
70
ensure_stripe(api_key, account)
71
72
listing = create_listing(
73
    api_key,
74
    name="Python Async Patterns",
75
    price_cents=1900,
76
    content_url="https://alex-bucket.s3.amazonaws.com/python-async.pdf",
77
)
78
79
if listing["readiness"]["sellable"]:
80
    print(f"\nListing live: {listing['url']}")
81
else:
82
    print(f"\nNot yet sellable. Next action: {listing['readiness']['next']}")