From 96de4d4938b3eb0e51656c48c81f498a2aa97b2f Mon Sep 17 00:00:00 2001 From: ysyneu Date: Mon, 14 Sep 2026 02:26:27 -0700 Subject: [PATCH 1/9] docs(api): add POST /member/notify endpoint Document the endpoint that sends an email notification to account members with a caller-supplied HTML body. Adds the operation to the platform module spec and the merged spec (en/zh), including request and response schemas, per-recipient result reasons, and the shared error responses used by the other /member/* operations. Registers the new page in the API reference navigation alongside its siblings. --- api-reference/openapi.en.json | 169 +++++++++++++++++++++++++ api-reference/openapi.zh.json | 169 +++++++++++++++++++++++++ api-reference/platform.openapi.en.json | 169 +++++++++++++++++++++++++ api-reference/platform.openapi.zh.json | 169 +++++++++++++++++++++++++ docs.json | 2 + 5 files changed, 678 insertions(+) diff --git a/api-reference/openapi.en.json b/api-reference/openapi.en.json index 98a543de..e6937422 100644 --- a/api-reference/openapi.en.json +++ b/api-reference/openapi.en.json @@ -28947,6 +28947,85 @@ "source", "key" ] + }, + "MemberNotifyRequest": { + "type": "object", + "description": "Notify members by email request", + "required": [ + "subject", + "html" + ], + "properties": { + "person_ids": { + "type": "array", + "items": { + "type": "integer", + "format": "int64" + }, + "maxItems": 20, + "uniqueItems": true, + "description": "Recipient member IDs. Optional, up to 20, no duplicates. Omitted or empty sends to the caller only." + }, + "subject": { + "type": "string", + "minLength": 1, + "maxLength": 200, + "description": "Email subject. Required, 1–200 characters. Line breaks are replaced with a space; leading/trailing whitespace is trimmed." + }, + "html": { + "type": "string", + "maxLength": 512000, + "description": "Email body as an HTML fragment (no ``/``/`` wrapper needed). Required, up to 512,000 bytes of raw UTF-8 input, and must be non-empty after sanitization. Sanitized server-side: `