persona-hello-world

# Persona Hello World ## Overview Create a Persona inquiry, generate an embed URL for the verification flow, and poll for the inquiry status. Uses the real Persona REST API with sandbox credentials. ## Prerequisites - Completed `persona-install-auth` setup - An Inquiry Template ID from the Persona Dashboard (format: `itmpl_*`) ## Instructions ### Step 1: Create an Inquiry ```python import os, requests API_KEY = os.environ["PERSONA_API_KEY"] BASE = "https://withpersona.com/api/v1" HEADERS = { "Authorization": f"Bearer {API_KEY}", "Persona-Version": "2023-01-05", "Content-Type": "application/json", } # Create a new inquiry from a template resp = requests.post(f"{BASE}/inquiries", headers=HEADERS, json={ "data": { "attributes": { "inquiry-template-id": "itmpl_YOUR_TEMPLATE_ID", "reference-id": "user-12345", # Your internal user ID } } }) resp.raise_for_status() inquiry = resp.json()["data"] inquiry_id = inquiry["id"] status = inquiry["attributes"]["status"] print(f"Inquiry created: {inquiry_id} (status: {status})") ``` ### Step 2: Get the Verification URL ```python # The inquiry includes a session token for the embedded flow session_token = inquiry["attributes"].get("session-token") if session_token: # Option A: Hosted flow (redirect user to Persona) hosted_url = f"https://withpersona.com/verify?inquiry-id={inquiry_id}&session-token={session_token}" print(f"Send user to: {hosted_url}") # Option ...