GET
/session
Get or create session
Returns a session token and full channel context including branding, features, and analytics. Creates an EcomSession entity on first visit and reuses it on subsequent visits.
Headers
| Fält | Typ | Beskrivning |
|---|---|---|
X-Language
|
string | Language for translated content, as an ISO 639-1 code ("sv", "en"). Omitting it answers in the channel's default language, and so does a language the channel does not publish — this never fails the request. The channel decides which languages exist; read them from the session response. |
Svar
200
EcomSessionResponse
| Fält | Typ | Beskrivning |
|---|---|---|
cartItemCount
|
integer | |
channel
|
SessionChannel | |
customer
|
SessionCustomer | |
environmentLabel
|
string · nullable | |
expiresAt
|
string(date-time) | |
impersonation
|
SessionImpersonation | Vem som öppnat den här sessionen som kunden. |
isAuthenticated
|
boolean | |
isTestEnvironment
|
boolean | |
token
|
string · nullable |
429
Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
-
Retry-After— Seconds to wait before retrying.
Standardfel:
404
Felhantering
Exempel
curl
curl "https://api.erp.fluit.cloud/ecom/session" \
-H "Authorization: Bearer $SESSION_TOKEN" \
-H "X-Tenant-Id: $FLUIT_TENANT_ID" \
-H "X-Channel: web" \
-H "X-Language: …"
Svar 200
{
"cartItemCount": 42,
"channel": {
"analytics": {
"analyticsEnabled": true,
"customHeadScript": "string",
"enhancedConversionsEnabled": true,
"facebookPixelId": "string",
"googleAdsConversionId": "string",
"googleAdsPurchaseLabel": "string",
"googleAnalyticsId": "string",
"googleTagManagerId": "string"
},
"branding": {
"accentColor": "string",
"accentHoverColor": "string",
"backgroundColor": "string",
"borderRadius": "string",
"customCss": "string",
"faviconUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"fontBody": "string",
"fontHeading": "string",
"footerBackgroundColor": "string",
"footerTextColor": "string",
"headerBackgroundColor": "string",
"headerTextColor": "string",
"logoUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"primaryColor": "string",
"primaryHoverColor": "string",
"secondaryColor": "string",
"storeName": "Fluit",
"textColor": "string"
},
"code": "string",
"currency": "string",
"features": {
"allowBackorderChoice": true,
"allowBackorders": true,
"allowCustomerVatToggle": true,
"allowRequestedDeliveryDate": true,
"enableAddToCartModal": true,
"enableChatAssistant": true,
"guestCheckout": true,
"minimumOrderValue": "299.00",
"requireLogin": true,
"showCrossReferences": true,
"showLowestPrice30Days": true,
"showOutOfStockProducts": true,
"showPricesIncludingVat": true,
"showPricesWithoutLogin": true,
"showSku": true,
"showStock": true,
"stockAggregation": "string"
},
"language": "string",
"languages": [
{
"code": "string",
"name": "White",
"nativeName": "White"
}
],
"name": "Acme AB",
"navigation": {
"catalogMenuDepth": 42,
"catalogMenuMode": "string",
"catalogRootCategoryId": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
"footerColumns": [
{
"html": "string",
"links": [
{}
],
"sortOrder": 42,
"title": "string"
}
],
"promiseBar": {
"isEnabled": true,
"items": [
{
"icon": "string",
"text": "string"
}
],
"tone": "string"
},
"showCategorySidebar": true,
"socialLinks": [
{
"platform": "string",
"sortOrder": 42,
"url": "https://cdn.fluit.cloud/assets/widget-a-front.jpg"
}
],
"topMenuLinks": [
{
"label": "string",
"openInNewTab": true,
"sortOrder": 42,
"url": "https://cdn.fluit.cloud/assets/widget-a-front.jpg"
}
]
},
"policies": {
"applicableCountry": "string",
"productFeedEnabled": true,
"returns": {
"enabled": true,
"generateReturnLabel": true,
"requireReason": true,
"returnInstructions": "string",
"returnWindowDays": 42,
"shippingCost": "string"
},
"shipping": {
"cheapestName": "Parcel, next day",
"cheapestPrice": "299.00",
"freeShippingThreshold": "299.00",
"maxHandlingDays": 42,
"maxTransitDays": 42,
"minTransitDays": 42
}
},
"seo": {
"baseUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
"metaDescription": "string",
"metaTitle": "string",
"redirectToPrimaryDomain": true,
"robotsTxtExtra": "string",
"searchEngineIndexingEnabled": true
},
"type": "string"
},
"customer": {
"email": "order@acme.se",
"id": "string",
"name": "Acme AB"
},
"environmentLabel": "string",
"expiresAt": "2026-06-11T09:24:13.418",
"impersonation": {
"by": "string",
"startedAt": "2026-06-11T09:24:13.418"
},
"isAuthenticated": true,
"isTestEnvironment": true,
"token": "string"
}Bas-URL https://api.erp.fluit.cloud/ecom. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.