Retrieve a general setting

cURL

curl -X GET "$EXSITED_BASE_URL/api/v4/settings/general_settings/labour/gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import {buildClient} from 'exsited';

const client = await buildClient();

const response = await client.settings.getSettingsGeneralSetting('labour', 'gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d');
console.log(response.data);

use Exsited\Client\ClientRegistry;

$client = ClientRegistry::buildClient();

$response = $client->settings->getSettingsGeneralSetting(
    'labour',
    'gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d',
);
print_r($response->data);

import com.exsited.Dto;
import com.exsited.client.ApiResponse;
import com.exsited.client.ClientRegistry;
import com.exsited.client.ExsitedClient;

ExsitedClient client = ClientRegistry.buildClient();

ApiResponse<Dto> response = client.settings().getSettingsGeneralSetting(
        "labour",
        "gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d");
System.out.println(response.getMap());

using Exsited.Client;

await using var client = ExsitedClient.BuildClient();

var response = await client.Settings.GetSettingsGeneralSettingAsync(
    "labour",
    "gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d");

Console.WriteLine(response.Json);

import 'package:exsited/exsited.dart';

final client = buildClient();

final response = await client.settings.getSettingsGeneralSetting(
  'labour',
  'gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d',
);
print(response.map);

import (
	"context"
	"fmt"
	"log"

	exsited "github.com/exsited/exsited-sdk-go/v4"
)

client, err := exsited.BuildClient(nil)
if err != nil {
	log.Fatal(err)
}
defer client.Close()

response, err := client.Settings().GetSettingsGeneralSetting(context.Background(), "labour", "gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d", nil)
if err != nil {
	log.Fatal(err)
}
fmt.Println(response.Map)

{
  "object": "<string>",
  "request_id": "<string>",
  "status": 123,
  "code": "<string>",
  "message": "<string>",
  "doc_url": "<string>",
  "errors": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>",
      "doc_url": "<string>"
    }
  ]
}

{
  "object": "<string>",
  "request_id": "<string>",
  "status": 123,
  "code": "<string>",
  "message": "<string>",
  "doc_url": "<string>",
  "errors": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>",
      "doc_url": "<string>"
    }
  ]
}

GET

settings

general_settings

{group}

{general_setting_id}

cURL

curl -X GET "$EXSITED_BASE_URL/api/v4/settings/general_settings/labour/gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import {buildClient} from 'exsited';

const client = await buildClient();

const response = await client.settings.getSettingsGeneralSetting('labour', 'gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d');
console.log(response.data);

use Exsited\Client\ClientRegistry;

$client = ClientRegistry::buildClient();

$response = $client->settings->getSettingsGeneralSetting(
    'labour',
    'gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d',
);
print_r($response->data);

import com.exsited.Dto;
import com.exsited.client.ApiResponse;
import com.exsited.client.ClientRegistry;
import com.exsited.client.ExsitedClient;

ExsitedClient client = ClientRegistry.buildClient();

ApiResponse<Dto> response = client.settings().getSettingsGeneralSetting(
        "labour",
        "gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d");
System.out.println(response.getMap());

using Exsited.Client;

await using var client = ExsitedClient.BuildClient();

var response = await client.Settings.GetSettingsGeneralSettingAsync(
    "labour",
    "gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d");

Console.WriteLine(response.Json);

import 'package:exsited/exsited.dart';

final client = buildClient();

final response = await client.settings.getSettingsGeneralSetting(
  'labour',
  'gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d',
);
print(response.map);

import (
	"context"
	"fmt"
	"log"

	exsited "github.com/exsited/exsited-sdk-go/v4"
)

client, err := exsited.BuildClient(nil)
if err != nil {
	log.Fatal(err)
}
defer client.Close()

response, err := client.Settings().GetSettingsGeneralSetting(context.Background(), "labour", "gs_271b2c3d4e5f4a6b8c7d9e0f1a2b3c4d", nil)
if err != nil {
	log.Fatal(err)
}
fmt.Println(response.Map)

{
  "object": "<string>",
  "request_id": "<string>",
  "status": 123,
  "code": "<string>",
  "message": "<string>",
  "doc_url": "<string>",
  "errors": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>",
      "doc_url": "<string>"
    }
  ]
}

{
  "object": "<string>",
  "request_id": "<string>",
  "status": 123,
  "code": "<string>",
  "message": "<string>",
  "doc_url": "<string>",
  "errors": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>",
      "doc_url": "<string>"
    }
  ]
}

Reads one general setting by its gs_ id. An id the group does not hold returns 404, and an unknown group returns 400.

The SDK samples get their client from credentials your app registers once when it starts, as shown in Authentication. To try the call here, click Try it, set host to your Exsited API host name and paste an access token from Get an access token.

Authorizations

Authorization

string

header

required

An access token from POST /api/v4/oauth2/token. The SDKs get and renew it for you.

Path Parameters

group

string

required

The general settings group: one of account, item, date_and_time, order, purchase, labour, transaction, security, dashboard, portal, display or general, in any letter case.

general_setting_id

string

required

A general setting's gs_ id.

Response

The general setting.

Guides

API reference

Authorizations

Path Parameters

Response