"""Save as cloudsign_request.py and run with Python 3. No third-party package required.""" from datetime import datetime, timezone import hashlib import hmac import http.client import json import os import re import secrets from urllib.parse import quote, urlencode class ApiError(RuntimeError): """Safe diagnostic fields. Write requests may already have reached the platform.""" def __init__(self, status, code, request_id="", retry_after=0): self.status = status self.code = code self.request_id = request_id self.retry_after = retry_after super().__init__(f"HTTP {status} {code} request_id={request_id}") def signed_headers(key_id, secret, host, method, path, params, body, date, nonce, idempotency_key="", security_token=""): query = urlencode(sorted(params.items()), quote_via=quote, safe="-._~") digest = hashlib.sha256(body).hexdigest() lines = ["CS1-HMAC-SHA256", method, host, path, query, date, nonce, digest, "production", idempotency_key] headers = {"X-Api-Date": date, "X-Api-Nonce": nonce, "X-Api-Content-Sha256": digest, "X-Api-Environment": "production"} if security_token: lines.append(hashlib.sha256(security_token.encode()).hexdigest()) headers["X-Api-Security-Token"] = security_token if method == "POST": headers.update({"Content-Type": "application/json", "X-Api-Idempotency-Key": idempotency_key}) signature = hmac.new(secret.encode(), "\n".join(lines).encode(), "sha256").hexdigest() headers["Authorization"] = f"CS1-HMAC-SHA256 Credential={key_id},Signature={signature}" return path + ("?" + query if query else ""), headers def request(method, resource, params=None, payload=None, idempotency_key="", *, timeout=15): """Use the same payload and saved idempotency key for retries of one business action.""" if method not in ("GET", "POST") or not re.fullmatch(r"/api/v1(?:/[A-Za-z0-9_-]+)+/?", resource): raise ValueError("Use a documented method and resource path") if method == "POST" and (not isinstance(payload, dict) or not re.fullmatch(r"[A-Za-z0-9_-]{16,64}", idempotency_key)): raise ValueError("POST requires a JSON object and a saved idempotency key") if method == "GET" and (payload is not None or idempotency_key): raise ValueError("GET has no request body or idempotency key") host = os.environ["CLOUDSIGN_HOST"].lower() # 网站主域名,仅主机名 if not re.fullmatch(r"[a-z0-9](?:[a-z0-9.-]{0,251}[a-z0-9])?", host) or "." not in host: raise ValueError("CLOUDSIGN_HOST must be a hostname without https://, port or path") if isinstance(timeout, bool) or not 0 < timeout <= 60: raise ValueError("timeout must be greater than 0 and at most 60 seconds") body = json.dumps(payload, ensure_ascii=False, separators=(",", ":")).encode() if payload is not None else b"" if len(body) > 16384: raise ValueError("JSON control body exceeds 16 KiB") path, headers = signed_headers( os.environ["CLOUDSIGN_ACCESS_KEY_ID"], os.environ["CLOUDSIGN_ACCESS_KEY_SECRET"], host, method, resource, params or {}, body, datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"), secrets.token_hex(16), idempotency_key, os.environ.get("CLOUDSIGN_SECURITY_TOKEN", ""), ) conn = http.client.HTTPSConnection(host, timeout=timeout) try: conn.request(method, path, body=body if method == "POST" else None, headers=headers) response = conn.getresponse() raw = response.read(2 * 1024 * 1024 + 1) if len(raw) > 2 * 1024 * 1024: raise ApiError(response.status, "InvalidResponse") try: envelope = json.loads(raw) except (ValueError, UnicodeDecodeError): raise ApiError(response.status, "InvalidResponse") from None if not isinstance(envelope, dict): raise ApiError(response.status, "InvalidResponse") request_id = envelope.get("request_id", "") if not isinstance(request_id, str) or not re.fullmatch(r"[a-f0-9]{32}", request_id): raise ApiError(response.status, "InvalidResponse") if response.status != 200: error = envelope.get("error") code = error.get("code") if isinstance(error, dict) else None if not isinstance(code, str) or not re.fullmatch(r"[A-Za-z][A-Za-z0-9_]{0,63}", code): raise ApiError(response.status, "InvalidResponse", request_id) retry = response.getheader("Retry-After") or "" seconds = min(86400, int(retry)) if re.fullmatch(r"[0-9]{1,6}", retry) else 0 raise ApiError(response.status, code, request_id, seconds) if not isinstance(envelope.get("data"), dict): raise ApiError(response.status, "InvalidResponse", request_id) return envelope except (OSError, http.client.HTTPException): raise ApiError(0, "TransportError") from None finally: conn.close() if __name__ == "__main__": try: answer = request("GET", "/api/v1/whoami") print(json.dumps(answer, ensure_ascii=False, indent=2)) except ApiError as error: raise SystemExit(str(error)) from None