跳到主要内容

查看发票列表 (V2)

本接口列出当前用户所属组织的所有发票。当前用户须为组织所有者或计费管理员。

GET/v2/invoices
连接端点

该 API 的 Base URL 格式如下：

https://api.cloud.zilliz.com

📘说明

控制面接口速率限制为单用户单接口每秒最多 20 个请求。

如果您在使用该接口过程中遇到任何问题，欢迎您联系 Zilliz Cloud 技术支持。

shell
export BASE_URL="https://api.cloud.zilliz.com"
参数
Authorizationstringheader必填项

认证令牌，应为具备适当权限的 API 密钥。

示例值：Bearer {{TOKEN}}
pageSizeintegerquery

每页返回的项目数量。

示例值：10
currentPageintegerquery

要返回的页码。

示例值：1
bash
export TOKEN="YOUR_API_KEY"

curl --request GET \
--url "${BASE_URL}/v2/invoices" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
响应200 OK - application/json

返回当前用户所属组织的所有发票记录列表。

返回发票列表。

codeinteger

响应码。

dataarray
[]dataobject
countinteger

发票总数。

currentPageinteger

当前页码。

pageSizeinteger

每页记录数。

invoicesarray
[]invoicesobject
idstring

发票 ID。

orgIdstring

发票所属组织 ID。

periodStartstring

发票帐期开始时间。

periodEndstring

发票帐期结束时间。

invoiceDatestring

发票生成日期。

dueDatestring

发票逾期时间。

currencystring

发票币种。

statusstring

发票状态。

usageAmountnumber

发票记录的总金额。

creditsAppliednumber

已应用的信用额度，应从总金额中减去。

alreadyBilledAmountnumber

已开票金额。

subtotalnumber

发票小计金额，即总金额减去已应用的信用额度。

taxnumber

发票税额。

totalnumber

发票含税金额，即小计金额加上税额。

advancePayAmountnumber

当前用户所属组织预存金额，可用于冲抵待付款。

amountDuenumber

发票应付金额，即预存金额减去含税金额。

返回错误消息。

codeinteger

响应码。

messagestring

错误描述。

Successjson
{
    "code": 0,
    "data": {
        "count": 1,
        "currentPage": 1,
        "pageSize": 10,
        "invoices": [
            {
                "id": "inv-12312io23810o291",
                "orgId": "org-xxxxxx",
                "periodStart": "2024-01-01T00:00:00Z",
                "periodEnd": "2024-02-01T00:00:00Z",
                "invoiceDate": "2024-02-01T00:00:00Z",
                "dueDate": "2024-02-01T00:00:00Z",
                "currency": "USD",
                "status": "unpaid",
                "usageAmount": 52400,
                "creditsApplied": 12400,
                "alreadyBilledAmount": 0,
                "subtotal": 40000,
                "tax": 5000,
                "total": 45000,
                "advancePayAmount": 0,
                "amountDue": 45000
            }
        ]
    }
}
Ctrl I