サイト作成

# 引数取得のためのライブラリ
import argparse

# JSON操作、システム操作、パス操作のためのライブラリ
import json

# システム操作のためのライブラリ
import sys

# パス操作のためのライブラリ
from pathlib import Path

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

# サーバ名、APIキー
BASE_URL = "{{URL}}"
API_KEY = "{{APIキー}}"

# サイト作成先となる親サイト
PARENT_SITE_ID = {{サイトID}}

# サイトパッケージの配置フォルダ
PACKAGE_DIR = Path(r"{{ファイルパス}}")

# 利用するサイトパッケージファイル名
PACKAGE_FILE_NAME = "{{サイトパッケージファイル名}}.json"

# サイトパッケージJSONを読み込む。
def load_site_package() -> dict:
    package_path = PACKAGE_DIR / PACKAGE_FILE_NAME
    if not package_path.exists():
        raise FileNotFoundError(f"サイトパッケージが見つかりません: {package_path}")

    with package_path.open("r", encoding="utf-8-sig") as f:
        return json.load(f)

# サイトパッケージの Sites[0] をベースに、サイト作成API用のBodyを組み立てる。
def build_create_site_body(site_package: dict, title: str) -> dict:
    sites = site_package.get("Sites", [])
    if not sites:
        raise ValueError("サイトパッケージに 'Sites' が存在しない、または空です。")

    body = dict(sites[0])  # Sites[0] をコピー

    # 作成API用の必須/上書き項目
    body["ApiVersion"] = "1.1"
    body["ApiKey"] = API_KEY
    body["TenantId"] = 1

    body["Title"] = title
    body["SiteName"] = title

    # 親サイト配下に作成し、権限は親から継承
    body["ParentId"] = PARENT_SITE_ID
    body["InheritPermission"] = PARENT_SITE_ID

    # SiteId は新規作成時に不要なため削除
    body.pop("SiteId", None)

    return body

# サイト作成APIを呼び出す。
def create_site(body: dict) -> dict:
    url = f"{BASE_URL.rstrip('/')}/api/items/{PARENT_SITE_ID}/createsite"
    headers = {"Content-Type": "application/json"}

    response = requests.post(
        url,
        headers=headers,
        data=json.dumps(body, ensure_ascii=False),
    )

    if not response.ok:
        raise RuntimeError(f"API Error: {response.status_code}\n{response.text}")

    return response.json()

def main():
    parser = argparse.ArgumentParser(description="Pleasanter サイト作成API サンプル")
    parser.add_argument("title", help="作成するサイト名")
    args = parser.parse_args()

    site_package = load_site_package()
    body = build_create_site_body(site_package, args.title)
    result = create_site(body)

    print(json.dumps(result, ensure_ascii=False, indent=2))

if __name__ == "__main__":
    try:
        main()
    except Exception as e:
        print(f"エラー: {e}", file=sys.stderr)
        sys.exit(1)

>python api_site_create_p1.py {{サイト名}}

{
  "Id": 9999,
  "StatusCode": 200,
  "Message": "\" 課題管理_{{サイト名}} \" を作成しました。"
}