Hoppa till innehållet

API and integrations Reference Brands

Svenska

Brands

Brands items carry. Addressed by code.

3 calls GET POST Base URL https://api.fluit.cloud/preview

Authentication, error codes, rate limits, idempotency and pagination apply to every call and are documented once under Getting started.

GET /brands

List brands

Returns brands ordered by code. `search` matches code and name, case-insensitively and on any part of the value. The response is a paged envelope: `{ items, totalCount, page, pageSize, totalPages, hasPreviousPage, hasNextPage }`. `pageSize` defaults to 50 and is capped at 200.

brands:read

Query parameters

Field Type Description
search string Case-insensitive partial match on code and name.
page integer
pageSize integer

Responses

200 PagedResult_PublicBrandResponse

Paginated response: the fields below sit in items[], wrapped in totalCount, page, pageSize, totalPages, hasPreviousPage and hasNextPage. Paginated

Field Type Description
code Required string · nullable Business key. Stable, and what item rows reference.
createdDate string(date-time)
description string · nullable
isActive boolean
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
logoUrl string · nullable
name Required string · nullable
sortOrder integer
websiteUrl string · nullable

Standard errors: 401 403 Errors

Examples

curl 
curl "https://api.fluit.cloud/preview/brands"
Response 200 
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "code": "string",
      "createdDate": "2026-06-11T09:24:13.418",
      "description": "string",
      "isActive": true,
      "links": {
        "self": "string"
      },
      "logoUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
      "name": "Fluit",
      "sortOrder": 42,
      "websiteUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 137,
  "totalPages": 3
}

Base URL https://api.fluit.cloud/preview. The response example is generated from the schema: the shape is right, the values are made up.

POST /brands

Create a brand

Creates a brand that items can carry. `code` is the business key: it is what `brandCode` on an item row references, so it should be stable. Known error codes: `Brand.CodeNotUnique`.

brands:write Requires Idempotency-Key

Body required

Field Type Description
code Required string Business key. Item rows reference this, so pick something stable.
description string · nullable Longer description, e.g. for a brand page in the web shop.
logoUrl string(uri) · nullable Absolute URL to the brand logo.
name Required string Display name.
sortOrder integer Sort order in brand listings.
websiteUrl string(uri) · nullable Absolute URL to the brand's own site.

Responses

201 PublicBrandResponse
  • Location — URL of the newly created resource.
Field Type Description
code Required string · nullable Business key. Stable, and what item rows reference.
createdDate string(date-time)
description string · nullable
isActive boolean
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
logoUrl string · nullable
name Required string · nullable
sortOrder integer
websiteUrl string · nullable
400 ProblemDetails The code is already taken.
Field Type
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standard errors: 401 403 Errors

Examples

curl 
curl -X POST "https://api.fluit.cloud/preview/brands" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @body.json
With logo and site 
{
  "code": "KORDZ",
  "description": "Australian maker of HDMI and installation cabling.",
  "logoUrl": "https://cdn.example.com/brands/kordz.png",
  "name": "Kordz",
  "sortOrder": 10,
  "websiteUrl": "https://kordz.com"
}
Code and name 
{
  "code": "KORDZ",
  "name": "Kordz"
}
Response 201 
{
  "code": "string",
  "createdDate": "2026-06-11T09:24:13.418",
  "description": "string",
  "isActive": true,
  "links": {
    "self": "string"
  },
  "logoUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
  "name": "Fluit",
  "sortOrder": 42,
  "websiteUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg"
}

Base URL https://api.fluit.cloud/preview. The response example is generated from the schema: the shape is right, the values are made up.

GET /brands/{code}

Get a brand

Returns one brand by its code, in the same shape as POST /preview/brands.

brands:read Supports ETag

Path parameters

Field Type Description
code Required string Code of the brand.

Responses

200 PublicBrandResponse
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
Field Type Description
code Required string · nullable Business key. Stable, and what item rows reference.
createdDate string(date-time)
description string · nullable
isActive boolean
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
logoUrl string · nullable
name Required string · nullable
sortOrder integer
websiteUrl string · nullable
304 Empty body.
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
404 ProblemDetails No brand with that code.
Field Type
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standard errors: 401 403 Errors

Examples

curl 
curl "https://api.fluit.cloud/preview/brands/{code}"
Response 200 
{
  "code": "string",
  "createdDate": "2026-06-11T09:24:13.418",
  "description": "string",
  "isActive": true,
  "links": {
    "self": "string"
  },
  "logoUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg",
  "name": "Fluit",
  "sortOrder": 42,
  "websiteUrl": "https://cdn.fluit.cloud/assets/widget-a-front.jpg"
}

Base URL https://api.fluit.cloud/preview. The response example is generated from the schema: the shape is right, the values are made up.

Schemas

The objects this group's calls refer to. The field tables above go one level deep and link here rather than repeating the same schema on every endpoint.