残高履歴を一覧表示する

GET

https://www.digicert.com/services/v2/finance/balance-history

このエンドポイントを使用して、お使いのアカウントの残高調節履歴を一覧表示します。

cURL

curl -X GET \
  https://www.digicert.com/services/v2/finance/balance-history \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Python

import requests

url = "https://www.digicert.com/services/v2/finance/balance-history"

payload = ""
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, data=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/finance/balance-history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

NodeJS

var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/finance/balance-history',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

200 OK

{
  "adjustments": [
    {
      "id": "5",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "credit": "195.00",
      "transaction_type": "Credit",
      "receipt_id": "0",
      "transaction_date": "2018-10-18 08:47:53",
      "balance_after": "441.00",
      "note": "Payment for invoice #100001"
    },
    {
      "id": "4",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "credit": "98.00",
      "transaction_type": "Credit",
      "receipt_id": "0",
      "transaction_date": "2018-10-18 08:47:53",
      "balance_after": "246.00",
      "note": "Payment for invoice #100006"
    },
    {
      "id": "3",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "debit": "295.00",
      "transaction_type": "Sale from Account Balance",
      "receipt_id": "121214",
      "transaction_date": "2018-09-04 12:02:39",
      "balance_after": "148.00",
      "order_id": "12346",
      "note": "Auto-debit: enterprise order from account balance"
    },
    {
      "id": "2",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "debit": "157.00",
      "transaction_type": "Sale from Account Balance",
      "receipt_id": "121213",
      "transaction_date": "2018-09-04 12:02:06",
      "balance_after": "443.00",
      "order_id": "12345",
      "note": "Auto-debit: enterprise order from account balance"
    },
    {
      "id": "1",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "credit": "600.00",
      "transaction_type": "Credit",
      "receipt_id": "0",
      "transaction_date": "2018-08-15 09:21:53",
      "balance_after": "600.00",
      "note": "Initial deposit for account."
    },
  ],
  "page": {
    "total": 4,
    "limit": 1000,
    "offset": 0
  }
}

URL クエリー文字列

名前	申請/オプション	種別	説明
offset	任意	int	ページネーション用にリストを指定番号からはじめます。
limit	任意	int	ページネーション用にリストを指定番号に切り捨てます。

container_id URL クエリ文字列は、お使いのアカウントに1つ以上の管理グループが含まれている場合に必要です。

応答パラメータ

名前	種別	説明
adjustments	array	調節リスト
.. id	string	調節 ID.
.. container	object	調節を開始したコンテナについての詳細
.. .. id	int	コンテナ ID
.. .. name	string	コンテナ名
.. .. is_active	bool	コンテナのアクティブステータス
.. credit .. debit	string	貸方の場合は、アカウントに預託された金額借方の場合は、アカウントから引き出された金額
.. transaction_type	string	実行した調節のタイプ可能な値:`Credit`,`Sale from Account Balance`
.. receipt_id	string	受取 ID すべての貸方取引については、`0` の値が返されます。
.. transaction_date	string	調節のタイプスタンプ形式:`yyyy-MM-dd HH:mm:ss`
.. balance_after	string	調節実行後のアカウント残高
.. note	string	調節について注記
ページ	object	結果についての詳細 URL クエリ文字列を使用して修正済

URL クエリー文字列

応答パラメータ

案内