Loading

DFS Target Market Services API (latest)

Download OpenAPI specification:Download

Contains functionality around target market.

For endpoints that support localization the language can be passed either as a query string parameter (using the name 'language') or in the 'accept-language' header.
If no language is passed to such endpoints then the default configured language will be used.

DefinitionManagement

Retrieve allowed attributes and values for a given definition.

Retrieves allowed attributes and values for a given definition.

Authorizations:
path Parameters
definitionKey
required
string

Definition Key

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

get/v1.0/target-market/definitions/{definitionKey}
https://example-host/v1.0/target-market/definitions/{definitionKey}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "string",
  • "nameResourceKey": "string",
  • "definition":
    [
    ]
}

InstanceManagement

Retrieve attribute and value pairs saved for a specific entity.

Retrieves attribute and value pairs saved for a specific entity.

Authorizations:
path Parameters
entityUid
required
string <uuid>

The entity UID

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

get/v1.0/target-market/instances/{entityUid}
https://example-host/v1.0/target-market/instances/{entityUid}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "definitionKey": "string",
  • "instance":
    [
    ]
}

Set a list of attribute and value pairs for a specific entity.

Sets a list of attribute and value pairs for a specific entity. More than one value may be saved for a specific attribute. Only attributes which are in the specified target market may be passed. Only values associated with the attribute may be passed for a specific attribute.

Authorizations:
path Parameters
entityUid
required
string <uuid>

Entity id

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The parameter DTO

definitionKey
string Nullable
instance
Array of objects (TargetMarketInstanceRequest) Nullable

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

put/v1.0/target-market/instances/{entityUid}
https://example-host/v1.0/target-market/instances/{entityUid}

Request samples

Content type
Copy
Expand all Collapse all
{
  • "definitionKey": "DefinitionKey",
  • "instance":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "code": "General",
  • "subCode": "string",
  • "message": "string",
  • "correlationId": "string",
  • "properties":
    {
    }
}

Search instances based on a common definition

Searches instances based on a common definition. Only attributes which are in the specified target market may be passed. Only values associated with the attribute may be passed for a specific attribute.

Authorizations:
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The parameter DTO

definitionKey
string Nullable
searchParameters
Array of objects (TargetMarketInstanceSearchParametersRequest) Nullable

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Internal Server Error

post/v1.0/target-market/instances/search
https://example-host/v1.0/target-market/instances/search

Request samples

Content type
Copy
Expand all Collapse all
{
  • "definitionKey": "DefinitionKey",
  • "searchParameters":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "results":
    [
    ]
}