Public Endpoints (v1)

This section documents all public-facing endpoints that do not require authentication. These endpoints are accessible to end users and customers.

note

Important: Public endpoints are accessible without authentication. They are designed for customer-facing features like storefronts, vCards, and public evaluations.

Storefront

• List Stores - Get all public storefronts
• Get Store by Slug - Get storefront by slug
• Meta catalog feed (CSV) - Scheduled product feed URL for Meta Commerce (token query)
• Storefront Content Pages - List content pages and get a page by URL slug (including custom pages)
• Lookup Storefront Products by IDs - Batch public product lookup (e.g. guest favorites)
• Storefront Customer Favorites - List / merge / add / remove favorites (authenticated customer)
• Instant Translate - Machine-translate catalog strings to EN/HE (Customer; requires owner toggle)
• List Public Product Reviews - Published reviews for a product (average + list)
• Create Public Product Review - Submit star rating and optional comment (store must be published)

info

More storefront endpoints (categories, products, orders, etc.) are available but not yet fully documented. They follow similar patterns to the documented endpoints.

vCard

• Get vCard by Slug - Get public vCard

Tracking

• Record Visit - Record a visit to vCard or storefront
• Record Page View - Record a page view within a visit session

Evaluation

• Get Session by Token - Get session data using evaluation token
• Update Evaluation - Submit session evaluation using token

Client Self-Registration

• Get Public Client Registration - Workspace meta for the public registration page
• Register Client Publicly - Customer self-registers into People Management clients

Form (استمارات)

• Get Public Form by Token - Get form and workspace branding by token
• Submit Public Form by Token - Submit form answers by token

Website Support

• Send Email Website - Submit contact form (sends support ticket to service@placio.app)

Labs

• Send Patient OTP - Send OTP to patient phone for lab results access
• Verify Patient OTP - Verify OTP, return lab results, and issue a session token
• Refresh Patient Results - Refresh lab results using the session token
• Get Public Lab Visit Print Payload - Public (no-auth) payload for rendering the lab visit print view
• Resolve Short Link - Resolve code to targetPath for browser redirects (e.g. base/links/{code})

Lucky Wheel (دولاب الحظ)

• Get Lucky Wheel - Shared public wheel slices (labels only)
• Spin Lucky Wheel - Server-side weighted spin
• Translate Lucky Wheel Labels - Translate slice labels to Turkish (Customer; Google Translate)
• Unlock Lucky Wheel Manage - Password gate for managing items
• Update Lucky Wheel - Replace shared items for every visitor