me-qr 1.0.0

Official Python SDK for the ME-QR API

ME-QR Python SDK

Official Python client for the ME-QR API.

Requirements

• Python 3.9+
• httpx (optional, recommended) or standard urllib

Installation

pip install me-qr
# with faster HTTP client (recommended):
pip install "me-qr[httpx]"

Or copy me_qr.py directly into your project.

Quick Start

from me_qr import MEQRClient

client = MEQRClient(token="YOUR_API_TOKEN")

# URL QR code → save to file
result = client.create_link("https://me-qr.com")
result.save("qr.png")

# Get as data URL for web embedding
print(result.to_data_url())  # data:image/png;base64,...

Usage

Run the example

python example.py

URL QR code

result = client.create_link("https://example.com")
result.save("link.png")

Styled QR code

from me_qr import QROptions

options = QROptions(
    size=600,
    foreground_color="#2563eb",
    background_color="#f8fafc",
    error_correction="H",
)
result = client.create_link("https://me-qr.com", format="svg", options=options)
result.save("styled.svg")

Wi-Fi QR code

from me_qr import WIFI_ENC_WPA  # 'wpa/wpa2'

result = client.create_wifi(
    ssid="MyNetwork",
    password="secret",
    encryption=WIFI_ENC_WPA,  # 'wpa/wpa2' | 'wpa3' | 'wep' | 'none' | 'raw'
)
result.save("wifi.png")

vCard QR code

result = client.create_vcard(
    name="Alex",
    last_name="Smith",
    phones=[{"phone": "[phone]", "type": 0}],  # type: 0=general, 1=work
    emails=[{"email": "[e-mail]", "type": 0}],  # type: 0=general, 1=corporate
    organization="ACME Corp",
)
result.save("vcard.png")

Email QR code

result = client.create_email(
    email="[e-mail]",
    subject="Hello",
    body="Message body",
)
result.save("email.png")

Plain text QR code

result = client.create_text("Hello, World!")
result.save("text.png")

Full control (create)

from me_qr import QRType

result = client.create(
    qr_type=QRType.WIFI,
    title="Office Wi-Fi",
    qr_fields_data={"ssid": "Corp", "password": "pass", "encryption": "wpa/wpa2"},
    format="svg",
)

QR Type IDs (QRType enum)

Value	ID	Description
QRType.LINK	1	URL / website
QRType.PDF	4	PDF document
QRType.EMAIL	5	Email
QRType.VCARD	7	Contact card
QRType.APP_STORE	8	App Store / Play
QRType.WHATSAPP	9	WhatsApp
QRType.AUDIO	10	Audio file
QRType.MAP	11	GPS location
QRType.TEXT	15	Plain text
QRType.IMAGE	16	Image gallery
QRType.WIFI	17	Wi-Fi credentials
QRType.PHONE	27	Phone call
QRType.SMS	28	SMS
QRType.VIDEO	29	Video

Error Handling

from me_qr import MEQRError

try:
    result = client.create_link("https://example.com")
except MEQRError as e:
    print(f"Error {e.status_code}: {e}")
    print(e.response)

Output Formats

Format	Use case
png	Print, web, general use
jpeg	Smaller file size
svg	High-resolution / infinite scale
json	Raw QR matrix data

---

Links

• 🌐 Website: me-qr.com
• 📖 API Docs: me-qr.com/api/doc
• 💰 Pricing: me-qr.com/pricing
• 🐛 Issues: GitHub Issues
• 🐍 PyPI: pypi.org/project/me-qr

---

License

MIT © ME-QR