添付ファイル取得

# Base64エンコード/デコードライブラリ
import base64

# 型ヒント用ライブラリ
import re

# データ構造操作のためのライブラリ
from pathlib import Path

# HTTPリクエスト用ライブラリ
import requests

# 設定
BASE_URI = "【URL】"
API_KEY = "【APIキー】"
SITE_ID = 【サイトID】
API_VERSION = 1.1

# 取得対象とする添付ファイル項目
ATTACHMENT_ITEM = "AttachmentsA"
# 取得先ディレクトリ
OUT_DIR = Path(r"C:\work\download")

# ファイル名として使用できない文字を置換し、安全な名前に変換する
safe = lambda s: re.sub(r'[\\/:*?"<>|\x00-\x1F]', "_", str(s or "")).strip()

# 検索条件(Status が 100 のレコードに絞る)
VIEW = {
    "ColumnFilterHash": {
        "Status": '["100"]',
    }
}

post = lambda s, url, payload: (lambda r: (r.raise_for_status(), r.json())[1])(
    s.post(
        url, json=payload, headers={"Content-Type": "application/json; charset=utf-8"}
    )
)

# メイン処理
OUT_DIR.mkdir(parents=True, exist_ok=True)

# 結果集計用変数
record_count = 0  # 取得レコード数
records_with_attachments = 0  # 添付ありレコード数
seen_files = 0  # 添付ファイル総数
downloaded_files = 0  # 実際にDLした数

with requests.Session() as s:
    # レコード取得
    items = (
        post(
            s,
            f"{BASE_URI}/api/items/{SITE_ID}/get",
            {"ApiVersion": API_VERSION, "ApiKey": API_KEY, "View": VIEW},
        )
        .get("Response", {})
        .get("Data", [])
    )

    record_count = len(items)

    for rec in items:
        rec_id = rec.get("ResultId") or rec.get("IssueId")
        atts = (rec.get("AttachmentsHash") or {}).get(ATTACHMENT_ITEM) or []
        if not rec_id or not atts:
            continue  # 添付なし → フォルダ作らない

        records_with_attachments += 1
        rec_dir = OUT_DIR / str(rec_id)
        rec_dir.mkdir(parents=True, exist_ok=True)

        # 添付ファイル取得ループ
        for a in atts:
            guid, name = a.get("Guid"), a.get("Name")
            if not guid or not name:
                continue

            seen_files += 1
            b64 = (
                post(
                    s,
                    f"{BASE_URI}/api/binaries/{guid}/get",
                    {"ApiVersion": API_VERSION, "ApiKey": API_KEY},
                )
                .get("Response", {})
                .get("Base64")
            )

            if not b64:
                continue
            # ファイル保存
            (rec_dir / safe(name)).write_bytes(base64.b64decode(b64))
            downloaded_files += 1

# 処理結果出力
print("=== Download Result ===")
print(f"SiteId                : {SITE_ID}")
print(f"Attachment Item       : {ATTACHMENT_ITEM}")
print(f"Records (matched)     : {record_count}")
print(f"Records with files    : {records_with_attachments}")
print(f"Attachments found     : {seen_files}")
print(f"Attachments downloaded: {downloaded_files}")
print(f"Output directory      : {OUT_DIR}")

>python api_binaries_p1.py

=== Download Result ===
SiteId                : 6412
Attachment Item       : AttachmentsA
Records (matched)     : 1
Records with files    : 0
Attachments found     : 0
Attachments downloaded: 0
Output directory      : C:\work\download