# Introduction

## 1. Basic Information

- Base URL: `https://api.dageno.ai/business`
- API prefix: `/api`
- Versioning: URI versioning (current default is `v1`)
- Data format: `application/json` by default

## 2. Authentication

This Open API uses `x-api-key`.

- Header name: `x-api-key`
- Type: string
- Required: yes

Example:

```bash
curl -X GET 'https://api.dageno.ai/business/api/v1/open-api/brand' \
  -H 'x-api-key: <YOUR_PROJECT_API_KEY>'
```

See details in [`Authentication.md`](https://open-api-docs.dageno.ai/2055132m0).

## 3. Unified Response Format

### 3.1 Success Response

```json
{
  "success": true,
  "code": 0,
  "message": "OK",
  "data": {},
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "total": 100,
      "totalPages": 5
    }
  }
}
```

Notes:
- `meta.pagination` appears only on paginated endpoints.
- List endpoints usually return data in `data.items`.

### 3.2 Error Response

```json
{
  "error": true,
  "code": 401,
  "message": "x-api-key header is required"
}
```

See details in [`Errors.md`](https://open-api-docs.dageno.ai/2055133m0).

## 4. Quick Troubleshooting

- `401`: check whether `x-api-key` is present and valid.
- `403`: API key may be inactive.
- `400`: check request parameters (time format, enum values, DSL shape).
- `500`: internal server error. Contact support with request context and timestamp.