> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acturehub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询收入看板



## OpenAPI

````yaml /specs/bp-agent.openapi.json get /api/open/finance/dashboard
openapi: 3.1.0
info:
  title: BP-Agent Open API
  description: BP-Agent 对外 API：PDF 上传、异步诊断、结果下载及专项业务能力。所有接口使用租户 API Token 鉴权。
  contact:
    name: BP Agent 开发团队
    email: support@bpagent.com
  license:
    name: MIT License
    url: https://opensource.org/licenses/MIT
  version: 1.0.0
servers:
  - url: https://bptest.mapleai.cc
    description: 测试环境（仅 relay 上传）
  - url: https://project.mapleai.cc
    description: 生产环境（OSS；STS 直传需服务端启用）
security: []
paths:
  /api/open/finance/dashboard:
    get:
      tags:
        - 对外收入 / Open Finance
      summary: 查询收入看板
      operationId: get_open_finance_dashboard_api_open_finance_dashboard_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse_FinanceDashboardData_'
      security:
        - HTTPBearer: []
components:
  schemas:
    SuccessResponse_FinanceDashboardData_:
      properties:
        code:
          type: integer
          title: Code
          description: 响应码，成功时为0
          default: 0
        message:
          type: string
          title: Message
          description: 成功消息
          default: 操作成功
        data:
          $ref: '#/components/schemas/FinanceDashboardData'
          description: 响应数据
        timestamp:
          anyOf:
            - type: integer
            - type: 'null'
          title: Timestamp
          description: 响应时间戳（可选）
      type: object
      title: SuccessResponse[FinanceDashboardData]
    FinanceDashboardData:
      properties:
        total_profit:
          type: string
          title: Total Profit
        tech_profit:
          type: string
          title: Tech Profit
        ecosystem_profit:
          type: string
          title: Ecosystem Profit
        tech_summary:
          $ref: '#/components/schemas/FinanceTechSummary'
        monthly_profit:
          items:
            $ref: '#/components/schemas/FinanceMonthlyProfitItem'
          type: array
          title: Monthly Profit
        ecosystem_categories:
          items:
            $ref: '#/components/schemas/FinanceCategoryProfitItem'
          type: array
          title: Ecosystem Categories
      type: object
      required:
        - total_profit
        - tech_profit
        - ecosystem_profit
        - tech_summary
        - monthly_profit
        - ecosystem_categories
      title: FinanceDashboardData
    FinanceTechSummary:
      properties:
        preliminary_service_count:
          type: integer
          title: Preliminary Service Count
        uni_report_count:
          type: integer
          title: Uni Report Count
        total_service_count:
          type: integer
          title: Total Service Count
        funnel:
          $ref: '#/components/schemas/FinanceConversionFunnel'
      type: object
      required:
        - preliminary_service_count
        - uni_report_count
        - total_service_count
        - funnel
      title: FinanceTechSummary
    FinanceMonthlyProfitItem:
      properties:
        month:
          type: string
          title: Month
          description: 月份，格式 YYYY-MM
        amount:
          type: string
          title: Amount
          description: 当月分润金额，两位小数字符串
      type: object
      required:
        - month
        - amount
      title: FinanceMonthlyProfitItem
    FinanceCategoryProfitItem:
      properties:
        category:
          type: string
          title: Category
        amount:
          type: string
          title: Amount
          description: 分润金额，两位小数字符串
      type: object
      required:
        - category
        - amount
      title: FinanceCategoryProfitItem
    FinanceConversionFunnel:
      properties:
        preliminary_project_count:
          type: integer
          title: Preliminary Project Count
        uni_project_count:
          type: integer
          title: Uni Project Count
        conversion_rate:
          type: string
          title: Conversion Rate
          description: 百分比数值，两位小数字符串
      type: object
      required:
        - preliminary_project_count
        - uni_project_count
        - conversion_rate
      title: FinanceConversionFunnel
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````