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:

See details in Authentication.md.

3. Unified Response Format

3.1 Success Response

{
  "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

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

See details in Errors.md.

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.

1. Basic Information#

2. Authentication#

3. Unified Response Format#

3.1 Success Response#