Filtering, Paging, and Sorting

Filtering

The Golang SDK implements Modzy's API filters, which allow you to specify any filters you'd like to apply to the results that are returned. This might include filtering a list of models returned by author name or by the model's description. The .WithFilter(), .WithFilterAnd(), and .WithFilterOr() functions can be added to supported functions using a dot notation-style that will dictate to Modzy's API how you'd like your results filtered.

Examples

//Return only open source models
listModelsInput = (&modzy.ListModelsInput{}).WithFilter(modzy.ListModelsFilterFieldAuthor, "Open Source")

//Return only active models after pagination has been applied
listModelsInput = (&modzy.ListModelsInput{}).WithPaging(1000, 0).WithFilterAnd(modzy.ListModelsFilterFieldIsActive, "true")

//Return only models that process "Image" data types after pagination has been applied
listModelsInput = (&modzy.ListModelsInput{}).WithPaging(5, 0).WithFilterAnd(modzy.ListModelsFilterFieldName, "Image")

// Combined search:
listModelsInput = (&modzy.ListModelsInput{}).WithPaging(1000, 0).
	WithFilterAnd(modzy.ListModelsFilterFieldName, "Image").
	WithFilterAnd(modzy.ListModelsFilterFieldAuthor, "Open Source").
	WithFilterAnd(modzy.ListModelsFilterFieldIsActive, "true")

Functions that support filtering

Filters can be applied to the following functions:

• ListAccountingUsersInput

Learn more about available filter values at List users

• ListJobsHistoryInput

Learn more about available filter values at List the job history

• ListModelsInput

Learn more about available filter values at List models

• ListModelVersionsInput

Learn more about available filter values at List versions

• ListProjectsInput

Learn more about available filter values at List projects

• PagingInput

Filtering with boolean logic

.WithFilter()
Applies a filter to your API query, by adding this function to the end of a supported function

.WithFilterAnd()
Applies a filter to your API query after other filter or pagination functions have already been applied using AND boolean logic

.WithFilterOr()
Applies a filter to your API query after other filter or pagination functions have already been applied using OR boolean logic

Pagination

The Golang SDK also implements Modzy's API pagination, allowing you to specify the number of results you'd like to receive per page and the number of pages that you'd like returned. .WithPaging(perPage int, page int) can be added to supported functions using a dot notation style that will dictate to Modzy's API how you'd like your results paginated.

Examples

//Return 1000 models per page, but only return the first page
listModelsInput = (&modzy.ListModelsInput{}).WithPaging(1000, 0)

//Return 5 models per page, but only return 5 pages (4 with a zero index)
listModelsInput = (&modzy.ListModelsInput{}).WithPaging(5, 4)

Functions that support pagination

Pagination can be applied to the following functions:

• ListAccountingUsersInput
• ListJobsHistoryInput
• ListModelsInput
• ListModelVersionsInput
• ListProjectsInput

Sorting