Salla Docs
Merchant API
Merchant API
Salla OAuth 2.0
Partner APIs
App API
Shipment API
Storefront
Twilight Engine
Twilight SDK
Web Components
Change Log
Salla CLI
Merchant API
Merchant API
Salla OAuth 2.0
Partner APIs
App API
Shipment API
Storefront
Twilight Engine
Twilight SDK
Web Components
Change Log
Salla CLI
Blog
Developer Portal
Merchant API
Copy Page
Welcome 👋
Get Started
Create Your First App
Authorization
Webhooks
Conditional Webhooks
Security Considerations
Multi-Language Support
Responses
Pagination
Rate Limiting
Versioning
Change Log
Support
APIs
Orders
Create Order
List Orders
Order Details
Create Drafted Order
Update Order
Duplicate Order
Order Actions
Order Status
Update Order Status
Create Custom Order Status
List Order Statuses
Order Status Details
Update Custom Order Status
Update Bulk Orders Statuses
Sort Orders Statuses
Order Histories
List Order Histories
Create Order History
Order Tags
Create Order Tag
List Order Tags
Delete Order Tag
Order Invoice
Create Invoice
List Invoices
Invoice Details
Send Order Invoice
Create Order Invoice
Order Reservations
List Order Reservations
Order Items
List Order Items
Create Order Item
Update Order Item
Delete Order Item
Products
Create Product
List Products
Product Details
Update Product
Delete Product
Change Product Status
Product Details By SKU
Update Product By SKU
Delete Product By SKU
Update Product Price By SKU
Update Bulk Product Prices
Import Products
Bulk Product Actions
Product Options
Create Product Option
Product Option Details
Update Product Option
Delete Product Option
Product Quantity
List Product Quantities
Update Bulk Quantities
List Quantity Change Reasons
List Quantity Audit
Update Bulk Quantities by SKU
Update Quantity
Update Quantity By SKU
Product Variants
List Product Variants
Product Variant Details
Update Product Variant
Update Product Variant Quantity
Product Tags
Create Product Tag
List Product Tags
Product Images
Attach Image by SKU
Attach Video by SKU
Attach Youtube Video
Attach Image
Update Image
Delete Image
Product Option Values
Create Product Option Value
Product Option Value Details
Update Product Option Value
Delete Product Option Value
Abandoned Carts
List Abandoned Carts
Abandoned Cart Details
Customer Groups
Create Customer Group
List Customer Groups
Add Customers To Group Customer
Update Default Customer Group
Update Customer Group
Delete Customer Group
Customers
Create Customer
List Customers
Customer Details
Update Customer
Delete Customer
Ban Customer
Un-Ban customer
Import Customers
Digitals Product
Attach Digital Code
Attach Digital File
Delete Digital File
Categories
Create Category
List Categories
Category Details
Update Category
Delete Category
Category Children
Categories Search
List Category Products
Exports
Export Orders
Exports Logs
List Export Templates
Create Export Template
Update Export Template
Delete Export Template
List Export Columns
Export Customers
Export Custom URLs
Export Products
Shipments
Create Shipment
List Shipments
Shipment Details
Shipment Tracking
Update Shipment Details
Cancel Shipment
Return Shipment
Shipping Companies
List Shipping Companies
Shipping Company Details
List Estimate Rates
Create Shipping Company
Update Shipping Company
Delete Shipping Company
Shipping Company Options
Shipping Zones
Create Shipping Zone
List Shipping Zones
Shipping Zone Details
Update Shipping Zone
Delete Shipping Zone
Shipping Rules
List Shipping Rules
Shipping Rule Details
Delete Shipping Rule
Countries
List Countries
Country Details
Product Option Templates
List Option Templates
Option Template Details
Delete Option Template
Update Option Template
Create Option Template
Taxes
Create Tax
List Taxes
Tax Details
Update Tax
Delete Tax
Coupons
Create Coupon
List Coupons
Coupon Details
Update Coupon
Delete Coupon
List Coupon Codes
Affiliates
List Affiliates
Affiliate Details
Create Affiliate
Update Affiliate
Delete Affiliate
Order Assignment
List Auto Assignment Rules
Order Assigned Employees Details
Update Auto Assignment Rule
Create Auto Assignment Rules
Special Offers
Create Special Offer
List Special Offers
Special Offer Details
Update Special Offer
Delete Special Offer
Change Special Offer Status
Transactions
List Transactions
Transaction Details
Update Transaction
Payments
Available Payment Methods
List Banks
Payment Bank Details
Settlements
List Instant Settlements
Create Instant Settlement
Update Instant Settlement
Instant Settlement Details
Settings
Settings List
Update Setting Slug
Setting Details
Merchant
User Information Details
Store Information
Brands
Create Brand
List Brands
Brand Details
Update Brand
Delete Brand
Branches
Create Branch
List Branches
Branch Details
Update Branch
Delete Branch
Currencies
Activate Currencies
List Currencies
List Available Currencies
SEO
List SEO Settings
Update SEO Settings
Cities
List Cities
DNS Records
List DNS Records
Create DNS Record
Delete DNS Record
Languages
Add Language
List Languages
Update Language
Employees
List Employees
Advertisements
Create Advertisement
List Advertisements
Advertisement Details
Update Advertisement
Delete Advertisement
Webhooks
List Active Webhooks
List Events
Register Webhook
Deactivate Webhook
Update Webhook
Custom URLs
Import Custom URLs
Loyalty Points
Customer Loyalty Points
Update Customer Loyalty Points
Reviews
List Reviews
Review Details
Update Review
Webhooks - Store Events
Order
Product
Customer
Shippings
Shipments
Brand
Invoice
Category
Store
Special Offer
Cart
Miscellaneous
Merchant API
Copy Page
Versioning
Changes in an API are inevitable as your understanding and experience with a system evolve. To effectively manage the impact of these changes, we have implemented URI versioning.
URI Versioning
#
One approach to version a REST API is by incorporating the version number within the URI path. When the version is introduced in the URI space, the representations of resources are treated as immutable. Therefore, when modifications are necessary, a new URI space must be created.
For instance, consider an API that provides the following resources: users and privileges:
http://api.salla.dev/admin/v1/customers
http://api.salla.dev/admin/v1/products
If a breaking change occurs in the users API, we would introduce a second version:
http://api.salla.dev/admin/v2/customers
http://api.salla.dev/admin/v2/products
When to Add a New Version?
#
APIs should only be versioned up when a breaking change occurs. Breaking changes may include:
Alterations in the format of the response data for one or more calls
Changes in the request or response type (e.g., changing an integer to a float)
Removal of any component of the API.
Changelog
#
The
changelog
details every available version.
Previous
Rate Limiting
Next
Change Log