Resolver Configuration

Resolver configuration collection manages the rules and settings for how different identifier types are resolved to appropriate redirection URLs or rules within the TrackVision system.

The resolver_configuration Object

Resolver configuration collection defines how various identifier types (GTIN, SSCC, GRAI, short codes, etc.) are processed and redirected, supporting flexible URL resolution for different identifier scenarios.

Field Name	Type	Description
id	uuid	Primary key. Unique identifier for the resolver configuration entry (UUID format).
user_created	object	Unique identifier of the user who created the resolver configuration record.
date_created	datetime	Timestamp in ISO8601 when the resolver configuration record was created.
user_updated	object	Unique identifier of the user who last updated the resolver configuration record.
date_updated	datetime	Timestamp in ISO8601 when the resolver configuration record was last updated.
identifier_type	string	Type of identifier this configuration applies to (e.g., "gtin", "sscc", "grai", "short_code").
account	object	Reference to the account this resolver configuration belongs to. Can be null for global configurations in a tenant.
redirection_url	string	Specific URL to redirect to when this configuration matches. Evaluated after any redirection rule that is set.
redirection_rule	object	Reference to a redirection rule to apply when this configuration matches. Takes priority over redirection_url when specified.

---

List Resolver Configurations

List existing resolver configurations.

REST

GET /items/resolver_configuration

GraphQL

query {
  resolver_configuration {
    id
    identifier_type
    account {
      id
      account_name
    }
    redirection_url
    redirection_rule {
      id
      rule_name
    }
    date_created
    date_updated
  }
}

Query Parameters

Supports all global query parameters.

Returns

An array of up to limit resolver configuration objects. If no items are available, data will be an empty array.

---

Retrieve a Resolver Configuration

Retrieve a specific resolver configuration by ID.

REST

GET /items/resolver_configuration/:id

GraphQL

query {
  resolver_configuration_by_id(id: "resolver_configuration_id") {
    id
    identifier_type
    account {
      id
      account_name
    }
    redirection_url
    redirection_rule {
      id
      rule_name
    }
    user_created {
      id
      first_name
      last_name
    }
    date_created
    user_updated {
      id
      first_name
      last_name
    }
    date_updated
  }
}

Returns

Returns a resolver configuration object if a valid primary key was provided.

---

Create a Resolver Configuration

Create a new resolver configuration.

REST

POST /items/resolver_configuration

{
  "identifier_type": "gtin",
  "account": "f1b2c3d4-e5f6-7890-1234-567890abcdef",
  "redirection_url": "https://example.com/gtin?={{gtin}}",
  "redirection_rule": null
}

GraphQL

mutation {
  create_resolver_configuration_item(data: {
    identifier_type: "gtin"
    account: "f1b2c3d4-e5f6-7890-1234-567890abcdef"
    redirection_url: "https://example.com/gtin?={{gtin}}"
    redirection_rule: null
  }) {
    id
    identifier_type
    account {
      id
      account_name
    }
    redirection_url
    redirection_rule {
      id
      rule_name
    }
  }
}

Query Parameters

Supports all global query parameters.

Request Body

A partial resolver configuration object.

Returns

Returns the resolver configuration object for the created resolver configuration.

---

Update a Resolver Configuration

Update an existing resolver configuration.

REST

PATCH /items/resolver_configuration/:id

{
  "identifier_type": "sscc",
  "redirection_url": "https://tracking.trackvision.ai/sscc/{identifier}"
}

GraphQL

mutation {
  update_resolver_configuration_item(id: "resolver_configuration_id", data: {
    identifier_type: "sscc"
    redirection_url: "https://tracking.trackvision.ai/sscc/{identifier}"
  }) {
    id
    identifier_type
    redirection_url
  }
}

Query Parameters

Supports all global query parameters.

Request Body

A partial resolver configuration object.

Returns

Returns the resolver configuration object for the updated resolver configuration.

---

Delete a Resolver Configuration

Delete an existing resolver configuration.

REST

DELETE /items/resolver_configuration/:id

GraphQL

mutation {
  delete_resolver_configuration_item(id: "resolver_configuration_id") {
    id
  }
}

Returns

Empty body.

---