Success

Success

A 200 response with data.

Table

Parameter	Type	Description
status	integer	The HTTP status code
message	string	The message to return
data	any	The data to return

Formats

Example

A JSON example of this model.

{
  "status": 200,
  "message": "Success"
}

JSON Schema

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: Success.yaml
type: object
properties:
  status:
    type: integer
    minimum: -2147483648
    maximum: 2147483647
    examples:
      - 200
  message:
    type: string
    examples:
      - Success
required:
  - status
  - message
unevaluatedProperties:
  not: {}

TypeSpec

The TypeSpec code for this model.

model Success {
  @example(200)
  status: int32;

  @example("Success")
  message: string;
}

Python

The Python code for this model.

class Success(DefaultResponse):
    """Default success response."""

    status: int = Field(
        default=200,
        description="The HTTP status code",
        examples=[200],
    )
    message: str = Field(
        default="Success",
        description="The message",
        examples=["Success"],
    )

TypeScript

The TypeScript code for this model.

export const SuccessSchema = z.object({
  /** HTTP status code */
  status: z.number().int(),

  /** Success message */
  message: z.string(),
});

Changelog

Version	Changes	Schema
0.1.0	Added Success model	Success.yaml

Usage

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

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

using TypeSpec.Http;
using CommonGrants.Responses;

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

@summary("Get test")
@doc("Get a test model")
@get
op getTest(): Ok<TestModel>;