Documentation

Partner API overview

Two APIs share this portal: catalog manufacturers (nameCode Bearer keys) and print partners (fulfillment tokens). JSON routes live on https://vilomedia.com. This host is docs and onboarding only.

Start here

1. Request access at partners@vilomedia.com.
2. Get a catalog key (vm_<nameCode>_…) or a print-partner token from Vilomedia Admin.
3. Call https://vilomedia.com/api/v1/… or /api/partners/v1/… with Authorization: Bearer ….

Guides

• AuthenticationBearer nameCode keys
• CatalogGET /api/v1/catalog
• Works and meGET /api/v1/works and /me
• Print ordersPrint-partner fulfillment

Security

• Keys are hashed at rest. The full secret is shown once when issued.
• Catalog responses never include prices, Stripe, buyers, or payouts.
• Print ship-to payloads omit buyer email and payment fields.
• Auth failures return a generic 401. No token or DB details.

Quick check

curl -s https://vilomedia.com/api/v1/me \
  -H "Authorization: Bearer vm_yourcode_…" | jq