exit lab
~/lab/api

API Design

Endpoint conventions, auth flows, and response shapes — sampled from the REST APIs behind each project.

H-Phsar — B2B Marketplace API

POST/authorization

Sign up, log in, and password reset flows

POST/authorization/api/v1/otp

Generate and email a 4-digit OTP to verify an account

POST/api/v1/retailer/orders

Add to cart, save drafts, and confirm a cart as a live order

GET/api/v1/distributor/reports

Order activity reports by month and year

Hengo — Focused Korean Learning Platform

POST/api/ai/chat/stream

Stream an authenticated AI coaching conversation

POST/api/ai/analyzer

Analyze workplace Korean tone and meaning

POST/api/ai/vocab/generate

Generate a structured vocabulary deck

POST/api/ai/message-generator

Generate workplace Korean at an appropriate formality level

POST/api/ai/korean/feedback

Return structured feedback for Korean voice practice

Luyra — Personal Finance Workspace

GET/api/finance/overview

Load the authenticated finance dashboard summary

GET/api/finance/analytics

Return spending and cash-flow analytics

POST/api/finance/money-coach

Ask the optional AI Money Coach about personal finance data

GET/api/finance/review

Build a financial review from recent activity

We Commerce — Multi-Vendor Marketplace

POST/api/v1/auth/register

Register with a phone number; returns JWT access + refresh tokens

POST/api/v1/auth/refresh-token

Rotate an expired access token

GET/api/v1/item/popular

Popular products ranked by view count

POST/api/v1/purchase

Place an order and generate a receipt

AuthHub — Reusable Authentication Service

POST/api/auth/login

Authenticate with credentials; issues JWT access + refresh tokens

POST/api/auth/oauth2/google

Log in by verifying a Google ID token server-side

POST/api/auth/mfa/verify

Complete login with a TOTP code or a one-time backup code

GET/api/admin/audit-logs

Query the audit trail of security events (admin)

VSTV Agent — Real Estate Platform & Operations Console

GET/api/v1/units

Searchable, paginated private unit inventory

POST/api/v1/units/import/preview

Parse and classify a CSV without persisting rows

POST/api/v1/units/import

Persist confirmed unit import rows

PATCH/api/v1/units/{id}/availability

Change a unit's availability state

POST/api/v1/units/{id}/verify

Mark a unit as verified