Numbers

import { configure, numbers, pricing } from '@trysaperly/sdk'

configure({ apiKey: process.env.SAPERLY_API_KEY! })

// 1. Quote the price
const { data: quote } = await pricing.quote({
  query: { country: 'US', numberType: 'local' },
})
// → { customerMonthlyCents, customerUpfrontCents }

// 2. Provision a number (reserves funds + starts metering rent)
const { data: number } = await numbers.provision({
  body: { country: 'US', numberType: 'local', areaCode: '415' },
})

// 3. Bind a connection (its handler)
await numbers.assignConnection({
  path: { id: number!.id },
  body: { connectionId: 'conn_…' },
})

// 4. (Optional, legacy) Set the per-number manual-mode brain URL — NOT event delivery
await numbers.setWebhook({
  path: { id: number!.id },
  body: { url: 'https://example.com/hooks/saperly' },
})

// 5. Later — release it (sets releasedAt, stops the rent)
await numbers.release({ path: { id: number!.id } })

import os
import httpx

BASE = "https://api.saperly.com"
headers = {
    "Authorization": f"Bearer {os.environ['SAPERLY_API_KEY']}",
    "Content-Type": "application/json",
}

with httpx.Client(base_url=BASE, headers=headers) as http:
    # 1. Quote the price
    quote = http.get(
        "/pricing/quote", params={"country": "US", "numberType": "local"}
    ).json()
    # → { "customerMonthlyCents": ..., "customerUpfrontCents": ... }

    # 2. Provision a number (reserves funds + starts metering rent)
    number = http.post(
        "/numbers",
        json={"country": "US", "numberType": "local", "areaCode": "415"},
    ).json()

    # 3. Bind a connection (its handler)
    http.post(
        f"/numbers/{number['id']}/connection",
        json={"connectionId": "conn_…"},
    )

    # 4. (Optional, legacy) Set the per-number manual-mode brain URL — NOT event delivery
    http.post(
        f"/numbers/{number['id']}/webhook",
        json={"url": "https://example.com/hooks/saperly"},
    )

    # 5. Later — release it (sets releasedAt, stops the rent)
    http.post(f"/numbers/{number['id']}/release")

export BASE=https://api.saperly.com

# 1. Quote the price
curl "$BASE/pricing/quote?country=US&numberType=local" \
  -H "Authorization: Bearer $SAPERLY_API_KEY"

# 2. Provision a number (reserves funds + starts metering rent)
curl -X POST "$BASE/numbers" \
  -H "Authorization: Bearer $SAPERLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "country": "US", "numberType": "local", "areaCode": "415" }'

# 3. Bind a connection (its handler)
curl -X POST "$BASE/numbers/$NUMBER_ID/connection" \
  -H "Authorization: Bearer $SAPERLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "connectionId": "conn_…" }'

# 4. (Optional, legacy) Set the per-number manual-mode brain URL — NOT event delivery
curl -X POST "$BASE/numbers/$NUMBER_ID/webhook" \
  -H "Authorization: Bearer $SAPERLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/hooks/saperly" }'

# 5. Later — release it (sets releasedAt, stops the rent)
curl -X POST "$BASE/numbers/$NUMBER_ID/release" \
  -H "Authorization: Bearer $SAPERLY_API_KEY"