sms-api-wrapper/pythonlib/README.md

Conduit Python Client

Small synchronous Python client for the Conduit / Mega API gateway.

from conduit import Client

client = Client.from_env()

print(client.health())
print(client.auth.me())
print(client.keys.list())

Configure it with environment variables:

export MEGA_API_BASE_URL=https://api.cowtunnel.com
export MEGA_API_KEY='mega_sk_live_...'

Do not put raw API keys in source files. Mega API keys are shown once by the gateway and should live in environment variables, a secret manager, or a local ignored config file.

Common Calls

from conduit import Client

client = Client(base_url="https://api.cowtunnel.com", api_key="...")

client.services.list()
client.sms.history(limit=1)
client.dns.server_status()
client.compute.resources(type="vm")
client.media.library.search(term="matrix", limit=5)
client.media.ingest.jobs()

Key management:

created = client.keys.create(
    display_name="automation",
    scopes=["gateway:read", "sms:read"],
)
print(created["key"])  # shown only once

client.keys.revoke(created["key_prefix"])

Admin audit:

client.admin.audit(scope="sms:send", result="denied")

Errors

The library raises:

Exception	Meaning
MegaAPIConfigError	Invalid/missing client configuration
MegaAPIHTTPError	Non-2xx response; includes status_code, detail, and body
MegaAPIConnectionError	Could not reach the gateway
MegaAPIResponseError	Gateway returned malformed JSON where JSON was expected

Naming

The import package is conduit for the private package registry. The public PyPI name conduit is already used by an unrelated project, so publish publicly as conduit-client if this ever leaves the private registry. megaapi remains as a compatibility import alias.