canonical: https://jentic.com/apis/fungenerators.com/fungenerators-qrcode # Fun Generators API The Fun Generators QR Code API generates QR Code images for many common payload types: arbitrary text, raw bytes, URLs, phone numbers, SMS messages, Skype contacts, email addresses, and vCard-style business cards. It also decodes QR Code images into the encoded contents. The API is a focused image-generation and decoding service that fits checkout flows, marketing collateral, contact-sharing apps, and customer support tools. Eight generator endpoints plus a single decode endpoint make integration straightforward. ## For AI agents Generate QR Code images for text, URLs, phone, SMS, email, Skype, or business cards, and decode QR Code images back to their contents. ## Scope Does not provide barcode generation, image styling, or analytics on scans - use for QR Code generation and decoding only. ## Capabilities - Generate a QR Code image for an arbitrary URL or text payload - Encode contact details into a vCard-style QR Code business card - Produce QR Codes for phone numbers, SMS messages, and Skype handles - Encode an email address with optional subject and body into a scannable QR Code - Decode an uploaded QR Code image to retrieve the encoded payload - Generate raw-byte QR Codes for application-specific payloads ## Use cases ### QR Codes on Marketing Collateral Marketing teams generate QR Codes that send scanners to landing pages, app store listings, or campaign URLs. The API takes a URL and returns a scannable image suitable for print or digital placement. Teams can batch-generate codes for variants of a campaign and embed them directly in design tooling. Example prompt: Call GET `/qrcode/url` with the campaign URL and save the response image as a PNG for the print spec sheet. ### Contact Sharing with vCard QR Codes Sales teams and event hosts hand out QR Codes that scan into a contact card. The API's business card endpoint accepts contact fields and returns a scannable image, which is faster than maintaining a vCard generator in-house. Example prompt: Call GET `/qrcode/business_card` with the contact fields and email the resulting image to the user as their digital business card. ### Decoding QR Codes for Support Tools Customer support teams sometimes need to decode QR Codes a customer has photographed to confirm what payload was scanned. The decode endpoint accepts a QR Code image and returns the encoded contents, which support agents can paste into their workflow. Example prompt: POST a QR Code image to `/qrcode/decode` and return the decoded text to the support agent in their helpdesk console. ### AI Agent QR Code Tool Wire QR Code generation into Jentic so any agent can produce a QR Code image when a user asks. The agent searches by intent through Jentic, the API key stays vaulted, and the agent receives the image binary or URL. This is a small but high-utility tool for chat assistants and customer-facing bots. Example prompt: Use Jentic to search 'generate a qr code for a url', load GET `/qrcode/url`, and execute it with the user's URL. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/qrcode/url` | Generate a QR Code for a URL | | GET | `/qrcode/text` | Generate a QR Code for arbitrary text | | GET | `/qrcode/email` | Generate a QR Code for an email payload | | GET | `/qrcode/phone` | Generate a QR Code for a phone number | | GET | `/qrcode/sms` | Generate a QR Code for an SMS payload | | GET | `/qrcode/business_card` | Generate a QR Code for a vCard contact | | POST | `/qrcode/decode` | Decode a QR Code image to its contents | ## Key resources - **Text QR Code** — Encode arbitrary text as a QR Code image - **URL QR Code** — Encode a URL as a scannable QR Code - **Email QR Code** — Encode an email address with optional subject and body - **Phone and SMS QR Code** — Encode phone numbers and SMS payloads - **Business Card QR Code** — Encode contact fields as a vCard-style QR Code - **QR Code Decode** — Decode an uploaded QR Code image ## Why Jentic - **Setup:** Wiring the Fungenerators QR Code API by hand means picking between the secret-key request header and a bearer token, sending it on every call to api.fungenerators.com, and mapping a route per payload type yourself. Through Jentic you install once, import the Fun Generators API from the API Directory, store the credential once, and your agent calls it. - **Permission scoping:** The QR Code API takes its input in query and body parameters rather than a resource path, so you limit the agent to the operations it needs, such as generating a QR code for a url or decoding one. You choose which operations it may call, and nothing outside that set runs. - **Credential handling:** Your Fungenerators API key or bearer token is stored once, encrypted, by your own Jentic One instance and injected into the request at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'generate a QR code for a url' or 'decode a QR code', and Jentic returns the matching GET `/qrcode/url` or POST `/qrcode/decode` operation with its parameter schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **UUID Generation API** — Same vendor; pairs unique IDs with QR Codes for tracked links and tickets - **Name Generation API** — Same vendor; supplies labels and names for QR Code campaigns and assets - **Facts API** — Same vendor; embeds short fact payloads inside generated QR Codes ## FAQ ### What authentication does the Fun Generators QR Code API use? The spec exposes two schemes: an API key in the X-Fungenerators-API-Secret header and HTTP bearer token authentication. Through Jentic either credential is held encrypted and applied at execution time. ### Can I generate a QR Code for a URL with this API? Yes. Call GET `/qrcode/url` with the URL as a query parameter and the response is a scannable QR Code image. Use GET `/qrcode/text` for arbitrary string payloads instead. ### What are the rate limits for the QR Code API? The OpenAPI spec does not declare explicit rate limits. Fungenerators applies plan-based quotas listed on the subscription page at fungenerators.com, so consult the plan you signed up for. ### How do I decode a QR Code image through Jentic? Search 'decode a qr code image' via the Jentic SDK, load the POST `/qrcode/decode` operation, and execute it with the image payload. Install with pip install jentic and authenticate using your ak_* key. ### Can I generate a vCard or business card QR Code? Yes. Call GET `/qrcode/business_card` with the contact fields supported by the endpoint. The response is a QR Code image that scanners decode into a contact entry. ### Does the API support customising QR Code colours or logos? The spec only exposes payload-shaping endpoints, not styling options for colour or embedded logos. For branded QR Codes use a styling layer on the resulting image after generation. ### Can I limit what my agent is allowed to do with the Fun Generators QR Code API? Yes. Because you self-host Jentic One, your own rules decide which of the QR Code operations the agent may call, so you can allow just GET `/qrcode/url` for generating codes from links while blocking POST `/qrcode/decode`, or expose only the generator endpoints your workflow needs. Since the API takes its input in query and body parameters rather than a resource path, you scope access at the operation level and nothing outside the set you approve runs. Your Fungenerators API key or bearer token stays stored by your instance and is injected only when an approved operation executes.