Sorted

Sorted

A 200 response with a paginated list of sorted items.

Table

Parameter	Type	Description
status	integer	The HTTP status code
message	string	The message to return
items	Array	Items from the current page
paginationInfo	PaginatedResultsInfo	Details about the pagination
sortInfo	SortedResultsInfo	The sort order of the items

Formats

Example

A JSON example of this model.

{
  "status": 200,
  "message": "Success",
  "items": [
    {
      "id": "123",
      "name": "Test 1"
    },
    {
      "id": "124",
      "name": "Test 2"
    }
  ],
  "paginationInfo": {
    "page": 1,
    "pageSize": 10,
    "totalItems": 25,
    "totalPages": 3
  },
  "sortInfo": {
    "field": "name",
    "direction": "asc"
  }
}

JSON Schema

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: Sorted.yaml
type: object
properties:
  items:
    type: array
    description: Items from the current page
  paginationInfo:
    $ref: PaginatedResultsInfo.yaml
  sortInfo:
    $ref: SortedResultsInfo.yaml
allOf:
  - $ref: Success.yaml
required:
  - items
  - paginationInfo
  - sortInfo

TypeSpec

The TypeSpec code for this model.

@doc("A paginated list of items with a sort order")
@Versioning.added(CommonGrants.Versions.v0_1)
model Sorted<T> {
  // Inherit the properties of the Paginated response
  ...Paginated<T>;

  /** The sort order of the items */
  sortInfo: Sorting.SortedResultsInfo;
}

Python

The Python code for this model.

class Sorted(Paginated[ItemsT], Generic[ItemsT]):
    """A paginated list of items with a sort order."""

    sort_info: SortedResultsInfo = Field(
        ...,
        description="The sort order of the items",
        alias="sortInfo",
    )

    model_config = {"populate_by_name": True}

TypeScript

The TypeScript code for this model.

export const SortedSchema = <T extends z.ZodTypeAny>(itemsSchema: T) =>
  PaginatedSchema(itemsSchema).extend({
    /** The sort order of the items */
    sortInfo: SortedResultsInfoSchema,
  });

Usage

Here’s an example of how to use the Sorted response within a an API operation:

import "@common-grants/core";
import "@typespec/http";

using TypeSpec.Http;
using CommonGrants.Pagination;
using CommonGrants.Responses;

model TestModel {
  id: string;
  name: string;
}

@summary("List test models")
@doc("Get a paginated list of test models")
@get
op listTest(...PaginatedQueryParams): Sorted<TestModel>;