API Reference

2026-04-01

Public developer API for Vinosoft storefronts. Versions are ISO dates pinned in the URL (/api/{version}/…). The storefront tier owns the clean resource root (/api/{version}/products) and is reachable anonymously or with a public vnstss_ token; the RBAC-gated admin tier lives under /api/{version}/admin/… and requires a vnstat_ token.

https://<your-shop-domain>/api/2026-04-01/…

Last synced: 2026-08-20

Storefront

Public endpoints for a shop frontend — anonymous or with a public vnstss_ token.

Storefront Cart

8 endpoints

/cart /cart/items /cart/items/{id} /cart/currency /cart/discount_code

Storefront Checkouts

4 endpoints

/checkouts /checkouts/{token} /checkouts/{token}/complete

Storefront Collections

4 endpoints

/collections /collections/{id} /collections/{id}/products /collections/{id}/facets

Storefront Content

4 endpoints

/content/pages /content/pages/{id} /content/articles /content/articles/{id}

Storefront Currencies

1 endpoint

/currencies

Storefront Localization

1 endpoint

/localization

Storefront Orders

1 endpoint

/orders/{id}

Storefront Products

4 endpoints

/products /products/facets /products/{id} /products/{id}/variants

Storefront Wishlist

4 endpoints

/wishlist /wishlist/items /wishlist/items/{id}

Customer

The signed-in shopper: authentication, account, own orders and addresses.

Customer Auth

3 endpoints

/customer/auth/token /customer/auth/logout /customer/auth/authorize

Customer Credential

4 endpoints

/customer/account/register /customer/account/register/confirm /customer/account/resetpassword/init /customer/account/resetpassword/finish

My Account

5 endpoints

/customers/me /customers/me/orders /customers/me/orders/{id} /customers/me/addresses /customers/me/addresses/{id}

Admin

RBAC-gated management endpoints, authenticated with a vnstat_ token.

Access Tokens

3 endpoints

/admin/access_tokens /admin/access_tokens/{id}

Checkouts

3 endpoints

/admin/checkouts /admin/checkouts/{token}

Collections

6 endpoints

/admin/collections /admin/collections/{id} /admin/collections/{id}/products

Content

10 endpoints

/admin/content/pages /admin/content/pages/{id} /admin/content/articles /admin/content/articles/{id}

Customer OAuth Clients

3 endpoints

/admin/oauth_clients /admin/oauth_clients/{id}

Customers

5 endpoints

/admin/customers /admin/customers/{id}

Discount Codes

5 endpoints

/admin/discount_codes /admin/discount_codes/{id}

Inventory

3 endpoints

/admin/inventory_levels /admin/inventory_levels/set /admin/inventory_levels/adjust

Orders

5 endpoints

/admin/orders /admin/orders/{id}

Products

11 endpoints

/admin/products /admin/products/{id} /admin/products/{id}/variants /admin/products/{id}/variants/{variantId} /admin/products/{id}/metafields

Themes

9 endpoints

/admin/themes /admin/themes/{id} /admin/themes/{id}/assets /admin/themes/{id}/assets/data