API

Kumir developers

Native iOS/Android and partner integrations use versioned /api/v1. The machine-readable contract is OpenAPI 3.1 at GET /api/v1/openapi. Do not invent Stripe, APNs, FCM, or OAuth keys — missing providers return 501 or log-only, never a fake success.

Auth: POST /api/v1/auth/login returns an HS256 access token (1 hour) and a rotating refresh token (30 days). Send Authorization: Bearer … and X-Fameo-Channel: ios|android. Health probes /api/v1/health and /ready stay unauthenticated.

admin

GET /api/v1/admin/analytics
Admin marketplace analytics cards (optional q) · Admin
GET /api/v1/admin/applications
GET admin · applications · Admin
GET /api/v1/admin/audit
Append-only admin audit log (q + action) · Admin
GET /api/v1/admin/categories
Admin taxonomy list (q + active/archived) · Admin
POST /api/v1/admin/categories
Create a browse category (slug stays stable) · Admin
PATCH /api/v1/admin/categories/{slug}
Rename, reorder, nest, or archive a category · Admin
GET /api/v1/admin/leads
Admin business leads (q + sales/license_extension/support) · Admin
GET /api/v1/admin/merch
Admin merch queue (q + status) with refund/credit/chargeback flags · Admin
POST /api/v1/admin/merch/{publicId}/chargeback
Record a merch payment dispute and claw unpaid earnings · Admin
POST /api/v1/admin/merch/{publicId}/refund
Refund merch to card or issue Kumir credit · Admin
GET /api/v1/admin/newsletter
Admin newsletter signups (q email) · Admin
POST /api/v1/admin/newsletter/remove
Admin remove a newsletter email (audited) · Admin
GET /api/v1/admin/ops
GET admin · ops · Admin
GET /api/v1/admin/orders
Admin order queue (q + status) with override action flags · Admin
POST /api/v1/admin/orders/{publicId}/chargeback
POST admin · orders · :publicId · chargeback · Admin
POST /api/v1/admin/orders/{publicId}/credit
POST admin · orders · :publicId · credit · Admin
POST /api/v1/admin/orders/{publicId}/expire
POST admin · orders · :publicId · expire · Admin
POST /api/v1/admin/orders/{publicId}/refund
POST admin · orders · :publicId · refund · Admin
POST /api/v1/admin/orders/{publicId}/remake
POST admin · orders · :publicId · remake · Admin
GET /api/v1/admin/overview
Admin ops home (optional q, queue counts + GMV + repeat) · Admin
GET /api/v1/admin/partners
Admin partner applications (q + pending/approved/rejected/all) · Admin
POST /api/v1/admin/partners/approve
POST admin · partners · approve · Admin
POST /api/v1/admin/partners/reject
POST admin · partners · reject · Admin
GET /api/v1/admin/payments
Admin payment ledger (q + succeeded/failed/refunded/pending) · Admin
GET /api/v1/admin/promos
Admin promo codes (q + active/off) · Admin
PATCH /api/v1/admin/promos
Activate or deactivate a promo code · Admin
POST /api/v1/admin/promos
Create an honest percent or fixed promo · Admin
GET /api/v1/admin/refunds
Admin refunds + chargebacks (q + kind/status) · Admin
GET /api/v1/admin/reports
Admin AUP reports (q + open/resolved/dismissed/all) · Admin
POST /api/v1/admin/reports/resolve
POST admin · reports · resolve · Admin
GET /api/v1/admin/reviews
Admin review queue (q + public/hidden) · Admin
POST /api/v1/admin/reviews/visibility
Hide or publish a fan review on storefronts · Admin
GET /api/v1/admin/settings
Admin runtime flags (optional q, no secret values) + host readiness issues · Admin
GET /api/v1/admin/stars
Admin star catalog with merchandising, payout hold, and intro/approve flags · Admin
POST /api/v1/admin/stars/approve
POST admin · stars · approve · Admin
POST /api/v1/admin/stars/merchandising
Toggle Featured / Hot / SAG / Kids / Instant or pin Top 10 · Admin
POST /api/v1/admin/stars/payout-hold
Place or release an AML payout hold · Admin
POST /api/v1/admin/stars/reject
POST admin · stars · reject · Admin
GET /api/v1/admin/support
GET admin · support · Admin
GET /api/v1/admin/support/{userId}
GET admin · support · :userId · Admin
POST /api/v1/admin/support/impersonate
POST admin · support · impersonate · Admin
POST /api/v1/admin/support/impersonate/stop
POST admin · support · impersonate · stop · Admin
GET /api/v1/admin/users
Admin user directory (q + active/banned) with ban/unban flags · Admin
POST /api/v1/admin/users/ban
POST admin · users · ban · Admin
POST /api/v1/admin/users/unban
POST admin · users · unban · Admin