Skill Doc Structure

---
name: petstore-openapi-3.0-api-reference
description: >-
  API reference documentation for Alova Functional (Petstore - OpenAPI 3.0 v1.0.0).
  Contains specifications for all REST API endpoints, including HTTP request methods,
  URL paths, path/query parameters, request body schemas, and response types.
  Key domains covered: pet, store, user.
---

> version 1.0.0

## Overview

This skill provides complete API reference documentation for Alova Functional.
When you need to call any endpoint in this service, consult the corresponding
API document in the references directory for detailed parameter schemas,
request/response formats, and usage examples.

## API Directory (Alova Functional)

- **pet**
  - [Add a new pet to the store](./references/pet/addPet.md) `[POST] /pet`
  - [Find pet by ID](./references/pet/getPetById.md) `[GET] /pet/{petId}`
  - [Finds Pets by status](./references/pet/findPetsByStatus.md) `[GET] /pet/findByStatus`
- **user**
  - [Logs user into the system](./references/user/loginUser.md) `[GET] /user/login`

# IMPORTANT: Enforce before generating code (must not be violated)!!!

Before executing the code generation task, recite the following usage
conventions and ensure compliance when generating.

## Usage Conventions

1. The API defined in this document is located at `src/api/alova/pet`
2. Follow the calling method shown in the example below.

## API

Add a new pet to the store

`[POST] /pet`

## Request Body

Pass the required request body in `data`:

```typescript
{
  id?: number
  name: string
  category?: {
    id?: number
    name?: string
  }
  photoUrls: string[]
  tags?: Array<{
    id?: number
    name?: string
  }>
  // pet status in the store
  status?: "available" | "pending" | "sold"
}
```

## Response

Use the response data as needed:

```typescript
{
  id?: number
  name: string
  category?: {
    id?: number
    name?: string
  }
  photoUrls: string[]
  tags?: Array<{
    id?: number
    name?: string
  }>
  // pet status in the store
  status?: "available" | "pending" | "sold"
}
```

## Usage Example

```typescript
addPet({
  data: {
    name: '',
    photoUrls: []
  }
})
```