跳至主要内容

List Credit Records

取得組織信用紀錄資料,單次資料上限為 100 筆。

Endpoint

ItemValue
MethodGET
Path/platform/organization/credit/record

Authentication

資訊

此 endpoint 需要在 request header 帶入 x-api-key。private key 請聯繫客服申請。

Request

Headers

HeaderRequiredDescription
x-api-keyYes請聯繫客服申請 private key。

Query Parameters

FieldTypeRequiredDescription
$filterstringNo允許欄位:quantity, type, create_date_time。支援函數:contains()cast()any()all()
$orderbystringNo允許欄位:quantity, type, create_date_time
$skipintegerNo要跳過的資料筆數。最小值 0
$topintegerNo要取得的資料筆數。範圍 1100

Response

Success Response

成功時回傳 200 OKOrganizationCreditRecordResponsePagedResponse

{
"value": [
{
"organization_credit_record_id": "bd7c4458-f878-4528-9ef1-23d24efae947",
"organization_credit_record_number": "CR-202606020001",
"quantity": -120,
"type": "decrease",
"order": null,
"create_date_time": "2026-06-02T12:30:00+08:00"
}
],
"@odata.count": 1
}

Error Responses

HTTP StatusCodeMeaningHow to Fix
400o_data_failedOData query 語法、欄位或函數不符合限制。檢查 $filter$orderby 欄位是否在允許清單中。
401token_validation_failedprivate key 缺漏或無效。確認 x-api-key header,必要時聯繫客服重新申請。

Examples

curl "https://api.guo-guo.com/platform/organization/credit/record?\$top=20&\$skip=0&\$orderby=create_date_time" \
-H "x-api-key: <private_key>"

References