REST API (Headless)

Overview of Shoporama

Shoporama's REST API allows you to integrate your online store with external systems - ERP, inventory management, PIM, CRM and other services. The API supports full CRUD (create, read, update, delete) on most resources.

How to get started

1. Go to Settings → API in your Shoporama administration
2. Create a new API key
3. Select rights: Read, Write or Full access
4. Use the key in the Authorization header

Authentication

Add your API key in the Authorization header:

Authorization: YOUR-API-KEY

Available resources

The API provides access to the following resources:

Products and catalog

• /REST/product - Products (with variants, images, prices, categories)
• /REST/category - Categories
• /REST/brand - Brands
• /REST/manufacturer - Manufacturers
• /REST/supplier - Suppliers
• /REST/stock - Inventory
• /REST/profile / /REST/profile-attribute - Product profiles and attributes

Orders and customers

• /REST/order - Orders
• /REST/order-return - Returns
• /REST/customer - Customers
• /REST/voucher - Discount codes

Content /REST/blog-entry

• /REST/blog-post - Blog posts
• /REST/page - Pages
• /REST/landing-page - Landing pages
• /REST/menu - Navigation

Setup /REST/setup

• /REST/shipping - Shipping methods
• /REST/payment-gateway - Payment methods
• /REST/country - Countries
• /REST/redirect - URL redirects
• /REST/webhook - Webhooks

HTTP methods

Method	Action	Example: GET
GET	Get resource(s)	GET /REST/product
POST	Create resource	POST /REST/product
PUT	Update resource	PUT /REST/product/123
DELETE	Delete resource	DELETE /REST/product/123

Example: Get products

curl -H "Authorization: YOUR-API-KEY" \ https://dinshop.dk/REST/product?limit=10

Example: Update inventory

curl -X PUT -H "Authorization: YOUR-API-KEY" \ -H "Content-Type: application/json" \ -d '{"stock": 50}' \ https://dinshop.dk/REST/product/123

Filtering and paging

Most list endpoints support:

• ?limit=25 - number of results per page (max 100)
• ?offset=0 - skip a number of results
• ?search=text - free text search
• ?fields=name,price - limit returned fields
• ?last_modified=2026-01-01 - only modified since date

Webhooks

You can create webhooks via the API so that your system is automatically notified when changes occur:

POST /REST/webhook { "url": "https://dit-system.dk/webhook", "events": ["order", "product", "stock"] }

Upon creation, you will receive a secret that is used to verify webhook calls via HMAC.

Rate limiting

Each API key has a daily limit on the number of calls. The default is 10,000 calls per day. If the limit is exceeded, HTTP 429 is returned. You can see your usage and adjust the limit under Settings → API.

Response codes

• 200 - Success
• 201 - Resource created
• 204 - Update/delete successful
• 400 - Invalid request
• 401 - Not authorized (incorrect API key)
• 404 - Resource not found
• 429 - Rate limit exceeded

Need help with API integration? Contact us at support@shoporama.dk.