Streaming API Docs
vCard QR Code Generator supports Server-Sent Events for agent workflows that need progress feedback instead of waiting for one final response.
SSE Endpoint
Use GET https://vcardqrcodegenerator.com/v1/stream or GET https://vcardqrcodegenerator.com/api/v1/stream. The response content type is text/event-stream.
curl -N "https://vcardqrcodegenerator.com/v1/stream?operation=create_vcard_payload"
Event Shape
event: progress
data: {"operation":"create_vcard_payload","step":"validated","percent":45,"message":"Inputs and agent contract validated."}
event: complete
data: {"operation":"create_vcard_payload","percent":100,"message":"Streaming contract complete."}
Agents can parse each data object as JSON and show progress to the user while long-running future QR workflows execute.
JSON Error Contract
API errors are returned as JSON with error.code, error.message, error.hint, error.docsUrl, and error.status. Agents should use the hint field to recover automatically.