{ "openapi": "3.1.0", "info": { "title": "MONA Mail API", "description": "MONA Mail l\u00e0 d\u1ecbch v\u1ee5 g\u1eedi email giao d\u1ecbch cho ph\u1ea7n m\u1ec1m v\u00e0 AI agent c\u1ee7a ng\u01b0\u1eddi Vi\u1ec7t: m\u1ed9t API, tr\u1ea3 VND, kh\u00f4ng c\u1ea7n th\u1ebb, thu\u1ed9c nh\u00f3m MONA Cloud c\u1ee7a The MONA Group.", "version": "1.0.0" }, "paths": { "/v1/plans": { "get": { "summary": "Plans", "description": "\u0110\u1ecdc b\u1ea3ng g\u00f3i v\u00e0 gi\u00e1 b\u1eb1ng VND. Kh\u00f4ng c\u1ea7n token.", "operationId": "plans_v1_plans_get", "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Plan" } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "parameters": [] } }, "/v1/account": { "get": { "summary": "Account", "description": "\u0110\u1ecdc t\u00e0i kho\u1ea3n t\u1ea1o JIT t\u1eeb MONA Pass, quota v\u00e0 g\u1ee3i \u00fd b\u01b0\u1edbc ti\u1ebfp cho AI.", "operationId": "account_v1_account_get", "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Account" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [] } }, "/v1/account/plan": { "put": { "summary": "Set Plan", "description": "\u0110\u1ed5i g\u00f3i b\u1eb1ng JWT ch\u1ee7 t\u00e0i kho\u1ea3n v\u00e0 Idempotency-Key. G\u00f3i tr\u1ea3 ph\u00ed tr\u1eeb v\u00ed MONA Cloud.", "operationId": "set_plan_v1_account_plan_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanSet" } } }, "required": true }, "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "K\u1ebft qu\u1ea3 \u0111\u1ed5i g\u00f3i.", "properties": { "plan": { "$ref": "#/components/schemas/Plan" }, "quota": { "$ref": "#/components/schemas/Quota" } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ] } }, "/v1/api-keys": { "get": { "summary": "Keys", "description": "Li\u1ec7t k\u00ea prefix v\u00e0 ng\u00e0y d\u00f9ng key; kh\u00f4ng tr\u1ea3 plaintext ho\u1eb7c hash.", "operationId": "keys_v1_api_keys_get", "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/APIKey" } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [] }, "post": { "summary": "Create Key", "description": "T\u1ea1o API key b\u1eb1ng JWT; plaintext tr\u1ea3 trong l\u1ea7n t\u1ea1o v\u00e0 replay c\u00f9ng key trong 24 gi\u1edd.", "operationId": "create_key_v1_api_keys_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyCreate" } } }, "required": true }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/APIKey" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ] } }, "/v1/api-keys/{id}/rotate": { "post": { "summary": "Rotate Key", "description": "Xoay API key b\u1eb1ng JWT. Key c\u0169 c\u00f2n hi\u1ec7u l\u1ef1c 24 gi\u1edd.", "operationId": "rotate_key_v1_api_keys__id__rotate_post", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/APIKey" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/api-keys/{id}": { "delete": { "summary": "Revoke Key", "description": "Thu h\u1ed3i API key ngay b\u1eb1ng JWT ch\u1ee7 t\u00e0i kho\u1ea3n.", "operationId": "revoke_key_v1_api_keys__id__delete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "204": { "description": "Successful Response", "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/domains": { "get": { "summary": "Domains", "description": "Li\u1ec7t k\u00ea domain g\u1eedi \u0111ang thu\u1ed9c t\u00e0i kho\u1ea3n.", "operationId": "domains_v1_domains_get", "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Domain" } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [] }, "post": { "summary": "Create Domain", "description": "Th\u00eam domain, sinh RSA 2048 selector mona1 v\u00e0 tr\u1ea3 ba record DKIM, SPF, DMARC.", "operationId": "create_domain_v1_domains_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DomainCreate" } } }, "required": true }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Domain" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ] } }, "/v1/domains/{id}": { "get": { "summary": "Get Domain", "description": "\u0110\u1ecdc tr\u1ea1ng th\u00e1i x\u00e1c minh v\u00e0 c\u00e1c record DNS c\u1ea7n th\u00eam.", "operationId": "get_domain_v1_domains__id__get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Domain" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] }, "delete": { "summary": "Delete Domain", "description": "X\u00f3a domain kh\u1ecfi t\u00e0i kho\u1ea3n. Th\u01b0 \u0111\u00e3 queued ti\u1ebfp t\u1ee5c \u0111i; kh\u00f3a DKIM \u0111\u01b0\u1ee3c gi\u1eef t\u1edbi khi h\u1ebft queue.", "operationId": "delete_domain_v1_domains__id__delete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "204": { "description": "Successful Response", "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/domains/{id}/verify": { "post": { "summary": "Verify Domain Route", "description": "Tra DNS ngay, timeout 5 gi\u00e2y m\u1ed7i record. DKIM kh\u1edbp l\u00e0 \u0111\u1ee7 x\u00e1c minh; SPF v\u00e0 DMARC l\u00e0 c\u1ea3nh b\u00e1o.", "operationId": "verify_domain_route_v1_domains__id__verify_post", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Domain" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/domains/{id}/cloudflare": { "post": { "summary": "Add Cloudflare", "description": "D\u00f9ng token Cloudflare m\u1ed9t l\u1ea7n \u0111\u1ec3 th\u00eam 3 TXT record r\u1ed3i x\u00e1c minh; kh\u00f4ng l\u01b0u token.", "operationId": "add_cloudflare_v1_domains__id__cloudflare_post", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CloudflareInput" } } } }, "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "K\u1ebft qu\u1ea3 th\u00eam DNS b\u1eb1ng Cloudflare.", "properties": { "added": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "object", "description": "Record \u0111\u00e3 th\u00eam.", "properties": { "id": { "type": "string", "description": "ID Cloudflare." }, "type": { "type": "string", "description": "TXT." }, "name": { "type": "string", "description": "T\u00ean DNS." }, "content": { "type": "string", "description": "Gi\u00e1 tr\u1ecb TXT." }, "ttl": { "type": "integer", "description": "TTL gi\u00e2y." } } } }, "status": { "type": "string", "description": "Tr\u1ea1ng th\u00e1i domain sau verify." }, "checks": { "type": "object", "description": "K\u1ebft qu\u1ea3 tra DNS; unknown n\u1ebfu resolver kh\u00f4ng d\u00f9ng \u0111\u01b0\u1ee3c.", "properties": { "dkim": { "type": "string", "description": "K\u1ebft qu\u1ea3 ki\u1ec3m tra dkim." }, "spf": { "type": "string", "description": "K\u1ebft qu\u1ea3 ki\u1ec3m tra spf." }, "dmarc": { "type": "string", "description": "K\u1ebft qu\u1ea3 ki\u1ec3m tra dmarc." } } } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/emails": { "post": { "summary": "Send Email", "description": "G\u1eedi m\u1ed9t mail t\u1edbi t\u1ed1i \u0111a 50 ng\u01b0\u1eddi nh\u1eadn. Ki\u1ec3m domain, suppression, quota, rate, k\u00edch th\u01b0\u1edbc v\u00e0 t\u00ean g\u1eedi. Sandbox kh\u00f4ng SMTP v\u00e0 kh\u00f4ng tr\u1eeb v\u00ed.", "operationId": "send_email_v1_emails_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailInput" } } } }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailResult" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } }, { "name": "X-Mona-Sandbox", "in": "header", "required": false, "description": "JWT d\u00f9ng gi\u00e1 tr\u1ecb 1 \u0111\u1ec3 g\u1eedi sandbox. Test key lu\u00f4n l\u00e0 sandbox.", "schema": { "type": "string", "enum": [ "1" ] } } ] }, "get": { "summary": "Emails", "description": "Tra l\u1ecbch s\u1eed mail b\u1eb1ng cursor v\u00e0 b\u1ed9 l\u1ecdc tr\u1ea1ng th\u00e1i, ng\u01b0\u1eddi nh\u1eadn, domain, th\u1eddi gian, tag.", "operationId": "emails_v1_emails_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "S\u1ed1 k\u1ebft qu\u1ea3 m\u1ed7i trang, t\u1ed1i \u0111a 100.", "default": 50, "title": "Limit" }, "description": "S\u1ed1 k\u1ebft qu\u1ea3 m\u1ed7i trang, t\u1ed1i \u0111a 100." }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor" }, "description": "Gi\u00e1 tr\u1ecb cursor \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "description": "Gi\u00e1 tr\u1ecb status \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" }, "description": "Gi\u00e1 tr\u1ecb to \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "domain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain" }, "description": "Gi\u00e1 tr\u1ecb domain \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Since" }, "description": "Gi\u00e1 tr\u1ecb since \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "until", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Until" }, "description": "Gi\u00e1 tr\u1ecb until \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "tag", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tag" }, "description": "Gi\u00e1 tr\u1ecb tag \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "Trang l\u1ecbch s\u1eed mail.", "properties": { "items": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Email" } }, "next_cursor": { "type": [ "string", "null" ], "description": "Cursor trang ti\u1ebfp theo." } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/emails/batch": { "post": { "summary": "Batch", "description": "G\u1eedi t\u1ed1i \u0111a 100 ph\u1ea7n t\u1eed \u0111\u1ed9c l\u1eadp; m\u1ed9t ph\u1ea7n t\u1eed l\u1ed7i kh\u00f4ng h\u1ee7y c\u00e1c ph\u1ea7n t\u1eed h\u1ee3p l\u1ec7.", "operationId": "batch_v1_emails_batch_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchInput" } } }, "required": true }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "K\u1ebft qu\u1ea3 t\u1eebng ph\u1ea7n t\u1eed \u0111\u1ed9c l\u1eadp.", "properties": { "results": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "oneOf": [ { "$ref": "#/components/schemas/EmailResult" }, { "type": "object", "description": "L\u1ed7i ph\u1ea7n t\u1eed.", "properties": { "error": { "$ref": "#/components/schemas/MailError" } } } ] } } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ] } }, "/v1/emails/{id}": { "get": { "summary": "Get Email", "description": "\u0110\u1ecdc n\u1ed9i dung mail l\u01b0u t\u1ed1i \u0111a 30 ng\u00e0y, tr\u1ea1ng th\u00e1i t\u1eebng ng\u01b0\u1eddi nh\u1eadn v\u00e0 s\u1ef1 ki\u1ec7n; sandbox c\u00f3 b\u1ea3n xem tr\u01b0\u1edbc.", "operationId": "get_email_v1_emails__id__get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Email" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/emails/{id}/events": { "get": { "summary": "Get Events", "description": "\u0110\u1ecdc s\u1ef1 ki\u1ec7n g\u1eedi, nh\u1eadn, bounce ho\u1eb7c suppression theo th\u1eddi gian.", "operationId": "get_events_v1_emails__id__events_get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Event" } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/emails/{id}/cancel": { "post": { "summary": "Cancel Email", "description": "H\u1ee7y mail c\u00f2n queued v\u00e0 ch\u01b0a b\u1ecb worker kh\u00f3a; mail \u0111\u00e3 g\u1eedi tr\u1ea3 409.", "operationId": "cancel_email_v1_emails__id__cancel_post", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "responses": { "204": { "description": "Successful Response", "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/inboxes": { "get": { "summary": "List Inboxes", "description": "Li\u1ec7t k\u00ea c\u00e1c h\u1ed9p agent c\u00f2n ho\u1ea1t \u0111\u1ed9ng c\u1ee7a t\u00e0i kho\u1ea3n.", "operationId": "list_inboxes_v1_inboxes_get", "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Inbox" } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [] }, "post": { "summary": "Create Inbox", "description": "T\u1ea1o h\u1ed9p th\u01b0 ri\u00eang cho agent trong quota g\u00f3i; domain ri\u00eang ph\u1ea3i \u0111\u01b0\u1ee3c x\u00e1c minh.", "operationId": "create_inbox_v1_inboxes_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InboxCreate" } } }, "required": true }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Inbox" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ] } }, "/v1/inboxes/{id}": { "get": { "summary": "Get Inbox", "description": "\u0110\u1ecdc m\u1ed9t h\u1ed9p agent thu\u1ed9c t\u00e0i kho\u1ea3n, k\u1ec3 c\u1ea3 h\u1ed9p \u0111\u00e3 x\u00f3a m\u1ec1m c\u00f2n trong retention.", "operationId": "get_inbox_v1_inboxes__id__get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Inbox" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] }, "delete": { "summary": "Delete Inbox", "description": "X\u00f3a m\u1ec1m h\u1ed9p agent; th\u01b0 c\u0169 c\u00f2n \u0111\u1ecdc \u0111\u01b0\u1ee3c t\u1edbi khi h\u1ebft retention v\u00e0 mail tr\u1ea3 l\u1eddi \u0111\u00e3 queue v\u1eabn \u0111\u01b0\u1ee3c g\u1eedi.", "operationId": "delete_inbox_v1_inboxes__id__delete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "204": { "description": "Successful Response", "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/inboxes/{id}/messages": { "get": { "summary": "Inbox Messages", "description": "Li\u1ec7t k\u00ea th\u01b0 nh\u1eadn b\u1eb1ng cursor, c\u00f3 th\u1ec3 l\u1ecdc tr\u1ea1ng th\u00e1i \u0111\u00e3 \u0111\u1ecdc v\u00e0 th\u1eddi gian nh\u1eadn.", "operationId": "inbox_messages_v1_inboxes__id__messages_get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "S\u1ed1 k\u1ebft qu\u1ea3 m\u1ed7i trang, t\u1ed1i \u0111a 100.", "default": 50, "title": "Limit" }, "description": "S\u1ed1 k\u1ebft qu\u1ea3 m\u1ed7i trang, t\u1ed1i \u0111a 100." }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor" }, "description": "Gi\u00e1 tr\u1ecb cursor \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "seen", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Seen" }, "description": "Gi\u00e1 tr\u1ecb seen \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Since" }, "description": "Gi\u00e1 tr\u1ecb since \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "Trang th\u01b0 inbound.", "properties": { "items": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/InboxMessage" } }, "next_cursor": { "type": [ "string", "null" ], "description": "Cursor trang k\u1ebf ti\u1ebfp." } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/inboxes/{id}/messages/{mid}": { "get": { "summary": "Get Inbox Message", "description": "\u0110\u1ecdc n\u1ed9i dung \u0111\u1ea7y \u0111\u1ee7, header v\u00e0 file \u0111\u00ednh k\u00e8m; l\u1ea7n \u0111\u1ecdc \u0111\u1ea7u \u0111\u00e1nh d\u1ea5u th\u01b0 \u0111\u00e3 xem.", "operationId": "get_inbox_message_v1_inboxes__id__messages__mid__get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "mid", "in": "path", "required": true, "schema": { "type": "string", "title": "Mid" }, "description": "Gi\u00e1 tr\u1ecb mid \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InboxMessage" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/inboxes/{id}/messages/{mid}/attachments/{aid}": { "get": { "summary": "Download Inbox Attachment", "description": "T\u1ea3i file \u0111\u00ednh k\u00e8m c\u1ee7a th\u01b0 trong h\u1ed9p \u0111ang x\u00e1c th\u1ef1c.", "operationId": "download_inbox_attachment_v1_inboxes__id__messages__mid__attachments__aid__get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "mid", "in": "path", "required": true, "schema": { "type": "string", "title": "Mid" }, "description": "Gi\u00e1 tr\u1ecb mid \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "aid", "in": "path", "required": true, "schema": { "type": "string", "title": "Aid" }, "description": "Gi\u00e1 tr\u1ecb aid \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "description": "N\u1ed9i dung nguy\u00ean b\u1ea3n c\u1ee7a file \u0111\u00ednh k\u00e8m." } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/inboxes/{id}/messages/{mid}/reply": { "post": { "summary": "Reply Inbox Message", "description": "Tr\u1ea3 l\u1eddi \u0111\u00fang ng\u01b0\u1eddi g\u1eedi c\u1ee7a thread qua queue g\u1eedi th\u01b0\u1eddng, c\u00f3 In-Reply-To v\u00e0 References v\u00e0 t\u00ednh quota g\u1eedi.", "operationId": "reply_inbox_message_v1_inboxes__id__messages__mid__reply_post", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "mid", "in": "path", "required": true, "schema": { "type": "string", "title": "Mid" }, "description": "Gi\u00e1 tr\u1ecb mid \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InboxReply" } } } }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailResult" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/inboxes/{id}/wait": { "get": { "summary": "Wait Inbox", "description": "Ch\u1edd th\u01b0 ch\u01b0a \u0111\u1ecdc kh\u1edbp regex ho\u1eb7c otp, poll c\u00f3 backoff t\u1ed1i \u0111a 300 gi\u00e2y; h\u1ebft h\u1ea1n tr\u1ea3 204.", "operationId": "wait_inbox_v1_inboxes__id__wait_get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "match", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200, "title": "Match" }, "description": "Gi\u00e1 tr\u1ecb match \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "timeout", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 300, "minimum": 0, "default": 120, "title": "Timeout" }, "description": "Gi\u00e1 tr\u1ecb timeout \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InboxMessage" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "204": { "description": "H\u1ebft th\u1eddi gian ch\u1edd, ch\u01b0a c\u00f3 th\u01b0 kh\u1edbp.", "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/webhooks": { "get": { "summary": "List Webhooks", "description": "Li\u1ec7t k\u00ea URL webhook v\u00e0 s\u1ef1 ki\u1ec7n \u0111ang theo d\u00f5i, kh\u00f4ng tr\u1ea3 secret.", "operationId": "list_webhooks_v1_webhooks_get", "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Webhook" } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [] }, "post": { "summary": "Create Webhook", "description": "\u0110\u0103ng k\u00fd webhook HTTPS v\u00e0 nh\u1eadn secret \u0111\u1ec3 ki\u1ec3m ch\u1eef k\u00fd HMAC SHA-256.", "operationId": "create_webhook_v1_webhooks_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookInput" } } }, "required": true }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhook" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ] } }, "/v1/webhooks/{id}/rotate": { "post": { "summary": "Rotate Webhook", "description": "Xoay secret webhook. Ch\u1eef k\u00fd l\u1ea7n g\u1eedi ti\u1ebfp theo d\u00f9ng secret m\u1edbi.", "operationId": "rotate_webhook_v1_webhooks__id__rotate_post", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhook" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/webhooks/{id}/test": { "post": { "summary": "Test Webhook", "description": "G\u1eedi payload email.delivered m\u1eabu c\u00f3 ch\u1eef k\u00fd HMAC; tr\u1ea3 HTTP status v\u00e0 th\u1eddi gian g\u1ecdi, t\u1ef1 retry khi th\u1ea5t b\u1ea1i.", "operationId": "test_webhook_v1_webhooks__id__test_post", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "K\u1ebft qu\u1ea3 g\u1ecdi webhook m\u1eabu.", "properties": { "status_code": { "type": [ "integer", "null" ], "description": "HTTP status t\u1eeb n\u01a1i nh\u1eadn." }, "duration_ms": { "type": "integer", "description": "Th\u1eddi gian g\u1ecdi, ms." } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/webhooks/{id}": { "delete": { "summary": "Delete Webhook", "description": "Ng\u1eebng webhook v\u00e0 c\u00e1c l\u1ea7n retry ch\u01b0a ch\u1ea1y.", "operationId": "delete_webhook_v1_webhooks__id__delete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "204": { "description": "Successful Response", "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/webhooks/{id}/deliveries": { "get": { "summary": "Webhook Deliveries", "description": "\u0110\u1ecdc l\u1ecbch s\u1eed g\u1ecdi webhook, s\u1ed1 l\u1ea7n th\u1eed v\u00e0 l\u1ed7i HTTP.", "operationId": "webhook_deliveries_v1_webhooks__id__deliveries_get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "S\u1ed1 k\u1ebft qu\u1ea3 m\u1ed7i trang, t\u1ed1i \u0111a 100.", "default": 50, "title": "Limit" }, "description": "S\u1ed1 k\u1ebft qu\u1ea3 m\u1ed7i trang, t\u1ed1i \u0111a 100." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/WebhookDelivery" } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/suppressions": { "get": { "summary": "List Suppressions", "description": "Li\u1ec7t k\u00ea \u0111\u1ecba ch\u1ec9 b\u1ecb ch\u1eb7n trong t\u00e0i kho\u1ea3n v\u00e0 to\u00e0n h\u1ec7 c\u00f2n hi\u1ec7u l\u1ef1c.", "operationId": "list_suppressions_v1_suppressions_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "S\u1ed1 k\u1ebft qu\u1ea3 m\u1ed7i trang, t\u1ed1i \u0111a 100.", "default": 50, "title": "Limit" }, "description": "S\u1ed1 k\u1ebft qu\u1ea3 m\u1ed7i trang, t\u1ed1i \u0111a 100." }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor" }, "description": "Gi\u00e1 tr\u1ecb cursor \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "reason", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" }, "description": "Gi\u00e1 tr\u1ecb reason \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "Trang suppression.", "properties": { "items": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Suppression" } }, "next_cursor": { "type": [ "string", "null" ], "description": "Cursor trang k\u1ebf ti\u1ebfp." } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] }, "post": { "summary": "Create Suppression", "description": "Ch\u1eb7n g\u1eedi th\u1ee7 c\u00f4ng t\u1edbi m\u1ed9t \u0111\u1ecba ch\u1ec9 trong t\u00e0i kho\u1ea3n.", "operationId": "create_suppression_v1_suppressions_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuppressionInput" } } } }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Suppression" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ] } }, "/v1/suppressions/{email}": { "delete": { "summary": "Delete Suppression", "description": "G\u1ee1 suppression c\u1ee7a t\u00e0i kho\u1ea3n. Kh\u00f4ng g\u1ee1 l\u1edbp to\u00e0n h\u1ec7; tr\u1ea3 403 v\u00e0 expires_at n\u1ebfu \u0111ang b\u1ecb ch\u1eb7n to\u00e0n h\u1ec7.", "operationId": "delete_suppression_v1_suppressions__email__delete", "parameters": [ { "name": "email", "in": "path", "required": true, "schema": { "type": "string", "title": "Email" }, "description": "Gi\u00e1 tr\u1ecb email \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "204": { "description": "Successful Response", "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/templates": { "get": { "summary": "List Templates", "description": "Li\u1ec7t k\u00ea c\u00e1c m\u1eabu th\u01b0 v\u00e0 bi\u1ebfn c\u1ea7n truy\u1ec1n khi g\u1eedi.", "operationId": "list_templates_v1_templates_get", "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Template" } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [] }, "post": { "summary": "Create Template", "description": "T\u1ea1o m\u1eabu subject, html, text. Bi\u1ebfn {{ten_bien}} \u0111\u01b0\u1ee3c escape HTML m\u1eb7c \u0111\u1ecbnh.", "operationId": "create_template_v1_templates_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateInput" } } }, "required": true }, "responses": { "201": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Template" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ] } }, "/v1/templates/{id}": { "get": { "summary": "Get Template", "description": "\u0110\u1ecdc n\u1ed9i dung v\u00e0 danh s\u00e1ch bi\u1ebfn c\u1ee7a m\u1eabu th\u01b0.", "operationId": "get_template_v1_templates__id__get", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Template" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] }, "put": { "summary": "Update Template", "description": "C\u1eadp nh\u1eadt m\u1eabu th\u01b0 b\u1eb1ng Idempotency-Key; t\u00ean m\u1eabu ph\u1ea3i ri\u00eang trong t\u00e0i kho\u1ea3n.", "operationId": "update_template_v1_templates__id__put", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateInput" } } } }, "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Template" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] }, "delete": { "summary": "Delete Template", "description": "X\u00f3a m\u1eabu th\u01b0 kh\u1ecfi t\u00e0i kho\u1ea3n.", "operationId": "delete_template_v1_templates__id__delete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "204": { "description": "Successful Response", "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/templates/{id}/render": { "post": { "summary": "Render Template", "description": "Xem n\u1ed9i dung sau khi thay bi\u1ebfn, kh\u00f4ng g\u1eedi SMTP v\u00e0 kh\u00f4ng t\u00ednh quota.", "operationId": "render_template_v1_templates__id__render_post", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "title": "Id" }, "description": "Gi\u00e1 tr\u1ecb id \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Tu\u1ef3 ch\u1ecdn nh\u01b0ng n\u00ean g\u1eedi: key ch\u1ed1ng l\u1eb7p theo t\u00e0i kho\u1ea3n trong 24 gi\u1edd; thi\u1ebfu key th\u00ec kh\u00f4ng c\u00f3 replay. C\u00f9ng key kh\u00e1c body tr\u1ea3 409. /emails c\u0169ng nh\u1eadn idempotency_key trong body.", "schema": { "type": "string", "maxLength": 255 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RenderInput" } } } }, "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Preview" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/stats": { "get": { "summary": "Stats", "description": "Th\u1ed1ng k\u00ea delivery live theo th\u1eddi gian t\u1ea1o mail; t\u1ef7 l\u1ec7 delivered v\u00e0 bounce t\u00ednh tr\u00ean s\u1ed1 \u0111\u00e3 g\u1eedi.", "operationId": "stats_v1_stats_get", "parameters": [ { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "From" }, "description": "Gi\u00e1 tr\u1ecb from \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "To" }, "description": "Gi\u00e1 tr\u1ecb to \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." }, { "name": "domain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain" }, "description": "Gi\u00e1 tr\u1ecb domain \u0111\u1ec3 ch\u1ecdn ho\u1eb7c l\u1ecdc t\u00e0i nguy\u00ean." } ], "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "Th\u1ed1ng k\u00ea delivery live.", "properties": { "sent": { "type": "integer", "description": "S\u1ed1 delivery sent." }, "delivered": { "type": "integer", "description": "S\u1ed1 delivery delivered." }, "bounced": { "type": "integer", "description": "S\u1ed1 delivery bounced." }, "complained": { "type": "integer", "description": "S\u1ed1 delivery complained." }, "suppressed": { "type": "integer", "description": "S\u1ed1 delivery suppressed." }, "failed": { "type": "integer", "description": "S\u1ed1 delivery failed." }, "delivery_rate": { "type": "number", "description": "delivered / sent, t\u1eeb 0 t\u1edbi 1." }, "bounce_rate": { "type": "number", "description": "bounced / sent, t\u1eeb 0 t\u1edbi 1." } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/v1/healthz": { "get": { "summary": "Health", "description": "Ki\u1ec3m tra DB, k\u1ebft n\u1ed1i SMTP v\u00e0 \u0111\u1ed9 d\u00e0i queue. Kh\u00f4ng c\u1ea7n token.", "operationId": "health_v1_healthz_get", "responses": { "200": { "description": "Y\u00eau c\u1ea7u \u0111\u00e3 x\u1eed l\u00fd th\u00e0nh c\u00f4ng.", "content": { "application/json": { "schema": { "type": "object", "description": "T\u00ecnh tr\u1ea1ng service.", "properties": { "status": { "type": "string", "description": "ok khi API v\u00e0 DB tr\u1ea3 l\u1eddi." }, "database": { "type": "string", "description": "ok khi DB tr\u1ea3 l\u1eddi." }, "smtp": { "type": "string", "description": "ok ho\u1eb7c down." }, "queue": { "type": "object", "description": "Delivery \u0111ang ch\u1edd g\u1eedi.", "properties": { "queued": { "type": "integer", "description": "Ch\u01b0a \u0111\u01b0\u1ee3c worker kh\u00f3a." }, "sending": { "type": "integer", "description": "\u0110ang \u0111\u01b0\u1ee3c worker kh\u00f3a." } } } } } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "400": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "401": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "402": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "403": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "404": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "409": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "422": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "429": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "500": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } }, "503": { "description": "L\u1ed7i ti\u1ebfng Vi\u1ec7t c\u00f3 code, request_id v\u00e0 next_step.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailError" } } }, "headers": { "X-Request-Id": { "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u.", "schema": { "type": "string" } } } } }, "parameters": [] } } }, "components": { "schemas": { "AttachmentInput": { "properties": { "filename": { "type": "string", "maxLength": 255, "minLength": 1, "title": "Filename", "description": "T\u00ean file \u0111\u00ednh k\u00e8m." }, "content": { "type": "string", "title": "Content", "description": "N\u1ed9i dung m\u00e3 h\u00f3a base64; t\u1ed5ng dung l\u01b0\u1ee3ng gi\u1ea3i m\u00e3 t\u1ed1i \u0111a 10 MB." }, "content_type": { "type": "string", "title": "Content Type", "description": "Ki\u1ec3u MIME c\u1ee7a file, v\u00ed d\u1ee5 application/pdf.", "default": "application/octet-stream" } }, "additionalProperties": false, "type": "object", "required": [ "filename", "content" ], "title": "AttachmentInput" }, "BatchInput": { "properties": { "emails": { "items": { "$ref": "#/components/schemas/EmailInput" }, "type": "array", "maxItems": 100, "minItems": 1, "title": "Emails", "description": "T\u1ed1i \u0111a 100 body g\u1eedi th\u01b0. M\u1ed7i ph\u1ea7n t\u1eed \u0111\u01b0\u1ee3c ki\u1ec3m tra v\u00e0 x\u1eed l\u00fd \u0111\u1ed9c l\u1eadp theo EmailInput." } }, "additionalProperties": false, "type": "object", "required": [ "emails" ], "title": "BatchInput" }, "CloudflareInput": { "properties": { "api_token": { "type": "string", "maxLength": 4096, "minLength": 1, "title": "Api Token", "description": "Token Cloudflare c\u00f3 quy\u1ec1n \u0111\u1ecdc zone v\u00e0 s\u1eeda DNS, ch\u1ec9 d\u00f9ng cho l\u1ea7n g\u1ecdi n\u00e0y." } }, "additionalProperties": false, "type": "object", "required": [ "api_token" ], "title": "CloudflareInput" }, "DeliveryInput": { "properties": { "queue_id": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ], "title": "Queue Id", "description": "M\u00e3 queue Postfix \u0111\u1ec3 \u0111\u1ed1i chi\u1ebfu log." }, "message_id": { "type": "string", "maxLength": 400, "title": "Message Id", "description": "Message-ID do MONA Mail sinh, c\u00f3 ho\u1eb7c kh\u00f4ng c\u00f3 d\u1ea5u ngo\u1eb7c nh\u1ecdn." }, "to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To", "description": "\u0110\u1ecba ch\u1ec9 ng\u01b0\u1eddi nh\u1eadn t\u1eeb d\u00f2ng log; b\u1eaft bu\u1ed9c khi th\u01b0 c\u00f3 nhi\u1ec1u delivery." }, "status": { "type": "string", "enum": [ "sent", "bounced", "deferred" ], "title": "Status", "description": "Tr\u1ea1ng th\u00e1i Postfix; sent \u0111\u01b0\u1ee3c \u00e1nh x\u1ea1 th\u00e0nh delivered." }, "relay": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ], "title": "Relay", "description": "MX \u0111\u00edch t\u1eeb log Postfix." }, "dsn": { "type": "string", "maxLength": 30, "title": "Dsn", "description": "M\u00e3 DSN, v\u00ed d\u1ee5 2.0.0 ho\u1eb7c 5.1.1.", "default": "" }, "response": { "type": "string", "maxLength": 4000, "title": "Response", "description": "Ph\u1ea3n h\u1ed3i SMTP t\u1eeb m\u00e1y ch\u1ee7 \u0111\u00edch.", "default": "" }, "at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "At", "description": "Th\u1eddi gian s\u1ef1 ki\u1ec7n ISO8601, UTC n\u1ebfu kh\u00f4ng c\u00f3 m\u00fai gi\u1edd." } }, "additionalProperties": false, "type": "object", "required": [ "message_id", "status" ], "title": "DeliveryInput" }, "DomainCreate": { "properties": { "domain": { "type": "string", "maxLength": 253, "minLength": 3, "title": "Domain", "description": "Domain g\u1eedi c\u1ee7a anh ch\u1ecb; h\u1ed7 tr\u1ee3 IDN v\u00e0 chuy\u1ec3n sang punycode." } }, "additionalProperties": false, "type": "object", "required": [ "domain" ], "title": "DomainCreate" }, "EmailInput": { "properties": { "from": { "type": "string", "maxLength": 998, "minLength": 3, "title": "From", "description": "\u0110\u1ecba ch\u1ec9 g\u1eedi thu\u1ed9c domain \u0111\u00e3 x\u00e1c minh ho\u1eb7c onboarding@monamail.vn; nh\u1eadn d\u1ea1ng T\u00ean ." }, "to": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ], "title": "To", "description": "M\u1ed9t \u0111\u1ecba ch\u1ec9 ho\u1eb7c danh s\u00e1ch ng\u01b0\u1eddi nh\u1eadn. T\u1ed5ng to, cc, bcc t\u1eeb 1 t\u1edbi 50." }, "cc": { "items": { "type": "string" }, "type": "array", "title": "Cc", "description": "Danh s\u00e1ch ng\u01b0\u1eddi nh\u1eadn b\u1ea3n sao c\u00f4ng khai." }, "bcc": { "items": { "type": "string" }, "type": "array", "title": "Bcc", "description": "Danh s\u00e1ch ng\u01b0\u1eddi nh\u1eadn b\u1ea3n sao \u1ea9n." }, "reply_to": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ], "title": "Reply To", "description": "\u0110\u1ecba ch\u1ec9 nh\u1eadn tr\u1ea3 l\u1eddi." }, "subject": { "anyOf": [ { "type": "string", "maxLength": 998 }, { "type": "null" } ], "title": "Subject", "description": "Ti\u00eau \u0111\u1ec1 t\u1ed1i \u0111a 998 k\u00fd t\u1ef1; b\u1ecf qua n\u1ebfu d\u00f9ng template_id." }, "html": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Html", "description": "N\u1ed9i dung HTML. N\u1ebfu thi\u1ebfu text, MONA Mail t\u1ef1 t\u1ea1o v\u0103n b\u1ea3n thu\u1ea7n." }, "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Text", "description": "N\u1ed9i dung v\u0103n b\u1ea3n thu\u1ea7n; c\u1ea7n html ho\u1eb7c text khi kh\u00f4ng d\u00f9ng template." }, "template_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Template Id", "description": "ID m\u1eabu th\u01b0 thu\u1ed9c t\u00e0i kho\u1ea3n, thay th\u1ebf subject, html, text." }, "variables": { "additionalProperties": true, "type": "object", "title": "Variables", "description": "Gi\u00e1 tr\u1ecb bi\u1ebfn trong m\u1eabu th\u01b0, m\u1eb7c \u0111\u1ecbnh escape HTML." }, "headers": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Headers", "description": "Header t\u00f9y ch\u1ec9nh; kh\u00f4ng \u0111\u01b0\u1ee3c ghi \u0111\u00e8 header h\u1ec7 th\u1ed1ng." }, "attachments": { "items": { "$ref": "#/components/schemas/AttachmentInput" }, "type": "array", "title": "Attachments", "description": "File \u0111\u00ednh k\u00e8m, t\u1ed5ng dung l\u01b0\u1ee3ng gi\u1ea3i m\u00e3 t\u1ed1i \u0111a 10 MB; l\u01b0u t\u1ed1i \u0111a 7 ng\u00e0y." }, "tags": { "items": { "type": "string" }, "type": "array", "maxItems": 10, "title": "Tags", "description": "T\u1ed1i \u0111a 10 nh\u00e3n, ch\u1ec9 d\u00f9ng a-z, 0-9, d\u1ea5u g\u1ea1ch d\u01b0\u1edbi v\u00e0 g\u1ea1ch n\u1ed1i." }, "unsubscribe_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unsubscribe Url", "description": "URL HTTPS h\u1ee7y \u0111\u0103ng k\u00fd; t\u1ef1 th\u00eam List-Unsubscribe v\u00e0 One-Click." }, "scheduled_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Scheduled At", "description": "Th\u1eddi gian g\u1eedi ISO8601, t\u1ed1i \u0111a 7 ng\u00e0y k\u1ec3 t\u1eeb hi\u1ec7n t\u1ea1i." }, "idempotency_key": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "title": "Idempotency Key", "description": "Key ch\u1ed1ng g\u1eedi tr\u00f9ng trong 24 gi\u1edd, t\u01b0\u01a1ng \u0111\u01b0\u01a1ng header Idempotency-Key." } }, "additionalProperties": false, "type": "object", "required": [ "from", "to" ], "title": "EmailInput" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "InboxCreate": { "properties": { "agent_id": { "type": "string", "maxLength": 64, "minLength": 1, "title": "Agent Id", "description": "T\u00ean \u1ed5n \u0111\u1ecbnh c\u1ee7a agent; ch\u1ec9 nh\u1eadn ch\u1eef th\u01b0\u1eddng, s\u1ed1, d\u1ea5u ch\u1ea5m, g\u1ea1ch d\u01b0\u1edbi ho\u1eb7c g\u1ea1ch n\u1ed1i." }, "domain": { "anyOf": [ { "type": "string", "maxLength": 253 }, { "type": "null" } ], "title": "Domain", "description": "Domain ri\u00eang \u0111\u00e3 x\u00e1c minh; b\u1ecf tr\u1ed1ng \u0111\u1ec3 d\u00f9ng mi\u1ec1n agent.monamail.vn." } }, "additionalProperties": false, "type": "object", "required": [ "agent_id" ], "title": "InboxCreate" }, "InboxReply": { "properties": { "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Text", "description": "N\u1ed9i dung tr\u1ea3 l\u1eddi d\u1ea1ng v\u0103n b\u1ea3n thu\u1ea7n." }, "html": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Html", "description": "N\u1ed9i dung tr\u1ea3 l\u1eddi HTML; c\u1ea7n \u00edt nh\u1ea5t text ho\u1eb7c html." } }, "additionalProperties": false, "type": "object", "title": "InboxReply" }, "KeyCreate": { "properties": { "name": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Name", "description": "T\u00ean app d\u00f9ng API key." }, "mode": { "type": "string", "enum": [ "live", "test" ], "title": "Mode", "description": "live g\u1eedi th\u1eadt; test ch\u1ea1y sandbox mi\u1ec5n ph\u00ed.", "default": "live" } }, "additionalProperties": false, "type": "object", "required": [ "name" ], "title": "KeyCreate" }, "PlanSet": { "properties": { "plan": { "type": "string", "title": "Plan", "description": "Slug g\u00f3i l\u1ea5y t\u1eeb GET /v1/plans." } }, "additionalProperties": false, "type": "object", "required": [ "plan" ], "title": "PlanSet" }, "RenderInput": { "properties": { "variables": { "additionalProperties": true, "type": "object", "title": "Variables", "description": "Gi\u00e1 tr\u1ecb bi\u1ebfn c\u1ea7n thay v\u00e0o m\u1eabu; bi\u1ebfn thi\u1ebfu th\u00e0nh chu\u1ed7i r\u1ed7ng." } }, "additionalProperties": false, "type": "object", "title": "RenderInput" }, "SuppressionInput": { "properties": { "email": { "type": "string", "title": "Email", "description": "\u0110\u1ecba ch\u1ec9 c\u1ea7n ch\u1eb7n g\u1eedi trong t\u00e0i kho\u1ea3n." }, "reason": { "type": "string", "const": "manual", "title": "Reason", "description": "L\u00fd do ch\u1eb7n th\u1ee7 c\u00f4ng.", "default": "manual" } }, "additionalProperties": false, "type": "object", "required": [ "email" ], "title": "SuppressionInput" }, "TemplateInput": { "properties": { "name": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Name", "description": "T\u00ean m\u1eabu th\u01b0 trong t\u00e0i kho\u1ea3n." }, "subject": { "type": "string", "maxLength": 998, "minLength": 1, "title": "Subject", "description": "Ti\u00eau \u0111\u1ec1 m\u1eabu; bi\u1ebfn c\u00f3 d\u1ea1ng {{ten_bien}}." }, "html": { "type": "string", "minLength": 1, "title": "Html", "description": "HTML m\u1eabu; {{bien}} escape HTML, {{{raw}}} gi\u1eef nguy\u00ean." }, "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Text", "description": "V\u0103n b\u1ea3n thu\u1ea7n t\u00f9y ch\u1ecdn." } }, "additionalProperties": false, "type": "object", "required": [ "name", "subject", "html" ], "title": "TemplateInput" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" }, "WebhookInput": { "properties": { "url": { "type": "string", "maxLength": 2048, "title": "Url", "description": "URL HTTPS c\u00f4ng khai nh\u1eadn s\u1ef1 ki\u1ec7n; timeout 10 gi\u00e2y, kh\u00f4ng theo redirect." }, "events": { "items": { "type": "string" }, "type": "array", "minItems": 1, "title": "Events", "description": "S\u1ef1 ki\u1ec7n email.*, domain.verified ho\u1eb7c account.plan_downgraded." }, "description": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ], "title": "Description", "description": "Ghi ch\u00fa v\u1ec1 n\u01a1i nh\u1eadn webhook." } }, "additionalProperties": false, "type": "object", "required": [ "url", "events" ], "title": "WebhookInput" }, "MailError": { "type": "object", "description": "L\u1ed7i c\u00f3 h\u01b0\u1edbng d\u1eabn b\u01b0\u1edbc ti\u1ebfp cho AI.", "properties": { "code": { "type": "string", "description": "M\u00e3 l\u1ed7i snake_case." }, "message": { "type": "string", "description": "N\u1ed9i dung l\u1ed7i b\u1eb1ng ti\u1ebfng Vi\u1ec7t." }, "next_step": { "type": "string", "description": "B\u01b0\u1edbc ti\u1ebfp theo \u0111\u1ec3 s\u1eeda l\u1ed7i." }, "request_id": { "type": "string", "description": "M\u00e3 \u0111\u1ed1i chi\u1ebfu y\u00eau c\u1ea7u." }, "needed_vnd": { "type": "integer", "description": "S\u1ed1 \u0111\u1ed3ng c\u1ea7n th\u00eam, c\u00f3 trong l\u1ed7i v\u00ed thi\u1ebfu." }, "topup_hint": { "type": "string", "description": "Tool cloud_topup d\u00f9ng \u0111\u1ec3 n\u1ea1p v\u00ed." }, "expires_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m h\u1ebft ch\u1eb7n to\u00e0n h\u1ec7.", "format": "date-time" }, "errors": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "object", "description": "M\u1ed9t tr\u01b0\u1eddng nh\u1eadp b\u1ecb l\u1ed7i.", "properties": { "loc": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": [ "string", "integer" ], "description": "T\u00ean tr\u01b0\u1eddng ho\u1eb7c ch\u1ec9 s\u1ed1 ph\u1ea7n t\u1eed." } }, "type": { "type": "string", "description": "M\u00e3 ki\u1ec3m tra \u0111\u1ecbnh d\u1ea1ng." }, "message": { "type": "string", "description": "H\u01b0\u1edbng d\u1eabn ti\u1ebfng Vi\u1ec7t." } } } }, "limit": { "type": "integer", "description": "Gi\u1edbi h\u1ea1n t\u00e0i nguy\u00ean c\u1ee7a g\u00f3i." }, "used": { "type": "integer", "description": "S\u1ed1 t\u00e0i nguy\u00ean \u0111ang d\u00f9ng." } } }, "Plan": { "type": "object", "description": "G\u00f3i d\u1ecbch v\u1ee5, gi\u00e1 \u0111\u1ecdc t\u1eeb b\u1ea3ng plans.", "properties": { "slug": { "type": "string", "description": "M\u00e3 g\u00f3i." }, "name": { "type": "string", "description": "T\u00ean g\u00f3i ti\u1ebfng Vi\u1ec7t." }, "monthly_fee_vnd": { "type": "integer", "description": "Ph\u00ed th\u00e1ng b\u1eb1ng \u0111\u1ed3ng." }, "monthly_limit": { "type": "integer", "description": "S\u1ed1 mail trong quota th\u00e1ng." }, "overage_x2_vnd": { "type": [ "integer", "null" ], "description": "Gi\u00e1 cho hai mail v\u01b0\u1ee3t quota, s\u1ed1 nguy\u00ean \u0111\u1ed3ng." }, "overage_vnd_per_mail": { "type": [ "number", "null" ], "description": "Gi\u00e1 hi\u1ec3n th\u1ecb m\u1ed7i mail, c\u00f3 th\u1ec3 1.5; billing d\u00f9ng \u0111\u01a1n v\u1ecb nguy\u00ean." }, "agent_inboxes": { "type": "integer", "description": "S\u1ed1 h\u1ed9p agent d\u00e0nh cho nh\u1ecbp 3." } } }, "Quota": { "type": "object", "description": "Quota th\u00e1ng; sandbox kh\u00f4ng t\u00ednh.", "properties": { "limit": { "type": [ "integer", "null" ], "description": "Gi\u1edbi h\u1ea1n th\u00e1ng; null l\u00e0 kh\u00f4ng gi\u1edbi h\u1ea1n." }, "used": { "type": "integer", "description": "S\u1ed1 delivery live \u0111\u00e3 nh\u1eadn v\u00e0o queue trong th\u00e1ng." }, "remaining": { "type": [ "integer", "null" ], "description": "S\u1ed1 c\u00f2n l\u1ea1i trong quota." }, "resets_at": { "type": "string", "description": "Th\u1eddi \u0111i\u1ec3m \u0111\u1ea7u th\u00e1ng UTC k\u1ebf ti\u1ebfp.", "format": "date-time" } } }, "Delivery": { "type": "object", "description": "Tr\u1ea1ng th\u00e1i c\u1ee7a m\u1ed9t ng\u01b0\u1eddi nh\u1eadn.", "properties": { "id": { "type": "string", "description": "M\u00e3 delivery." }, "to": { "type": "string", "description": "Email ng\u01b0\u1eddi nh\u1eadn." }, "kind": { "type": "string", "description": "to, cc ho\u1eb7c bcc." }, "status": { "type": "string", "description": "queued, sent, delivered, deferred, bounced, complained, suppressed, failed, sandbox ho\u1eb7c cancelled." }, "smtp_code": { "type": [ "integer", "null" ], "description": "M\u00e3 ph\u1ea3n h\u1ed3i SMTP." }, "smtp_response": { "type": [ "string", "null" ], "description": "Ph\u1ea3n h\u1ed3i SMTP." }, "attempts": { "type": "integer", "description": "S\u1ed1 l\u1ea7n g\u1eedi SMTP." }, "duration_ms": { "type": [ "integer", "null" ], "description": "Th\u1eddi gian g\u1eedi t\u00ednh b\u1eb1ng ms." }, "delivered_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m MX \u0111\u00edch nh\u1eadn.", "format": "date-time" } } }, "Event": { "type": "object", "description": "S\u1ef1 ki\u1ec7n delivery.", "properties": { "id": { "type": "string", "description": "M\u00e3 s\u1ef1 ki\u1ec7n." }, "type": { "type": "string", "description": "T\u00ean s\u1ef1 ki\u1ec7n email.*." }, "at": { "type": "string", "description": "Th\u1eddi \u0111i\u1ec3m UTC.", "format": "date-time" }, "to": { "type": [ "string", "null" ], "description": "Ng\u01b0\u1eddi nh\u1eadn li\u00ean quan." }, "detail": { "type": "object", "description": "Chi ti\u1ebft SMTP ho\u1eb7c suppression.", "properties": {} } } }, "Preview": { "type": "object", "description": "B\u1ea3n xem tr\u01b0\u1edbc sandbox.", "properties": { "subject": { "type": [ "string", "null" ], "description": "Ti\u00eau \u0111\u1ec1." }, "html": { "type": [ "string", "null" ], "description": "N\u1ed9i dung HTML." }, "text": { "type": [ "string", "null" ], "description": "N\u1ed9i dung v\u0103n b\u1ea3n thu\u1ea7n." } } }, "EmailResult": { "type": "object", "description": "Mail \u0111\u00e3 nh\u1eadn v\u00e0o queue.", "properties": { "id": { "type": "string", "description": "M\u00e3 email UUID." }, "status": { "type": "string", "description": "Tr\u1ea1ng th\u00e1i t\u1ed5ng c\u1ee7a delivery." }, "sandbox": { "type": "boolean", "description": "C\u00f3 khi g\u1eedi b\u1eb1ng test key ho\u1eb7c header sandbox." }, "deliveries": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Delivery" } }, "quota": { "$ref": "#/components/schemas/Quota" } } }, "Email": { "type": "object", "description": "Metadata v\u00e0 n\u1ed9i dung mail theo th\u1eddi h\u1ea1n l\u01b0u.", "properties": { "id": { "type": "string", "description": "M\u00e3 email UUID." }, "from": { "type": "string", "description": "T\u00ean v\u00e0 \u0111\u1ecba ch\u1ec9 g\u1eedi." }, "subject": { "type": [ "string", "null" ], "description": "Ti\u00eau \u0111\u1ec1, b\u1ecb x\u00f3a sau 30 ng\u00e0y." }, "html": { "type": [ "string", "null" ], "description": "HTML, b\u1ecb x\u00f3a sau 30 ng\u00e0y." }, "text": { "type": [ "string", "null" ], "description": "V\u0103n b\u1ea3n thu\u1ea7n, b\u1ecb x\u00f3a sau 30 ng\u00e0y." }, "mode": { "type": "string", "description": "live ho\u1eb7c test." }, "status": { "type": "string", "description": "Tr\u1ea1ng th\u00e1i t\u1ed5ng." }, "message_id": { "type": "string", "description": "Message-ID do API sinh." }, "tags": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "string", "description": "Nh\u00e3n ph\u00e2n lo\u1ea1i." } }, "deliveries": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Delivery" } }, "events": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/Event" } }, "sandbox_preview": { "$ref": "#/components/schemas/Preview" }, "created_at": { "type": "string", "description": "Th\u1eddi \u0111i\u1ec3m t\u1ea1o UTC.", "format": "date-time" }, "scheduled_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m h\u1eb9n g\u1eedi.", "format": "date-time" }, "content_purged_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m x\u00f3a n\u1ed9i dung.", "format": "date-time" }, "headers": { "type": "object", "description": "Header t\u00f9y ch\u1ec9nh.", "additionalProperties": { "type": "string", "description": "Gi\u00e1 tr\u1ecb header." } }, "reply_to": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "string", "description": "\u0110\u1ecba ch\u1ec9 nh\u1eadn tr\u1ea3 l\u1eddi." } }, "unsubscribe_url": { "type": [ "string", "null" ], "description": "URL h\u1ee7y \u0111\u0103ng k\u00fd." }, "attachments_meta": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "object", "description": "Metadata file; d\u1eef li\u1ec7u file l\u01b0u t\u1ed1i \u0111a 7 ng\u00e0y.", "properties": { "filename": { "type": "string", "description": "T\u00ean file." }, "content_type": { "type": "string", "description": "Ki\u1ec3u MIME." }, "size": { "type": "integer", "description": "Dung l\u01b0\u1ee3ng byte." } } } } } }, "Domain": { "type": "object", "description": "Domain g\u1eedi v\u00e0 c\u00e1c b\u1ea3n ghi DNS.", "properties": { "id": { "type": "string", "description": "M\u00e3 domain." }, "domain": { "type": "string", "description": "Domain punycode vi\u1ebft th\u01b0\u1eddng." }, "status": { "type": "string", "description": "pending, verified ho\u1eb7c failed." }, "records": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "object", "description": "B\u1ea3n ghi c\u1ea7n th\u00eam.", "properties": { "type": { "type": "string", "description": "Lo\u1ea1i DNS TXT." }, "name": { "type": "string", "description": "T\u00ean \u0111\u1ea7y \u0111\u1ee7." }, "value": { "type": "string", "description": "Gi\u00e1 tr\u1ecb g\u1ed9p." }, "chunks": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "string", "description": "\u0110o\u1ea1n TXT t\u1ed1i \u0111a 255 k\u00fd t\u1ef1." } }, "purpose": { "type": "string", "description": "dkim, spf ho\u1eb7c dmarc." }, "required": { "type": "boolean", "description": "B\u1eaft bu\u1ed9c \u0111\u1ec3 x\u00e1c minh hay c\u1ea3nh b\u00e1o." } } } }, "checks": { "type": "object", "description": "K\u1ebft qu\u1ea3 tra DNS; unknown n\u1ebfu resolver kh\u00f4ng d\u00f9ng \u0111\u01b0\u1ee3c.", "properties": { "dkim": { "type": "string", "description": "K\u1ebft qu\u1ea3 ki\u1ec3m tra dkim." }, "spf": { "type": "string", "description": "K\u1ebft qu\u1ea3 ki\u1ec3m tra spf." }, "dmarc": { "type": "string", "description": "K\u1ebft qu\u1ea3 ki\u1ec3m tra dmarc." } } }, "daily_limit": { "type": [ "integer", "null" ], "description": "500 mail/ng\u00e0y trong tu\u1ea7n \u0111\u1ea7u; sau \u0111\u00f3 \u00e1p quota g\u00f3i." }, "verified_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m x\u00e1c minh.", "format": "date-time" }, "created_at": { "type": "string", "description": "Th\u1eddi \u0111i\u1ec3m t\u1ea1o.", "format": "date-time" } } }, "APIKey": { "type": "object", "description": "API key v\u00e0 metadata; plaintext ch\u1ec9 c\u00f3 khi t\u1ea1o ho\u1eb7c xoay.", "properties": { "id": { "type": "string", "description": "M\u00e3 key." }, "name": { "type": "string", "description": "T\u00ean key." }, "prefix": { "type": "string", "description": "12 k\u00fd t\u1ef1 \u0111\u1ea7u." }, "mode": { "type": "string", "description": "live ho\u1eb7c test." }, "key": { "type": "string", "description": "Plaintext c\u1ea7n l\u01b0u v\u00e0o bi\u1ebfn m\u00f4i tr\u01b0\u1eddng app." }, "created_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m t\u1ea1o UTC.", "format": "date-time" }, "last_used_at": { "type": [ "string", "null" ], "description": "L\u1ea7n d\u00f9ng key g\u1ea7n \u0111\u00e2y.", "format": "date-time" }, "revoked_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m thu h\u1ed3i.", "format": "date-time" }, "expires_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m key c\u0169 h\u1ebft hi\u1ec7u l\u1ef1c sau khi xoay.", "format": "date-time" } } }, "Webhook": { "type": "object", "description": "N\u01a1i nh\u1eadn s\u1ef1 ki\u1ec7n v\u00e0 secret.", "properties": { "id": { "type": "string", "description": "M\u00e3 webhook." }, "url": { "type": "string", "description": "URL HTTPS." }, "events": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "string", "description": "T\u00ean s\u1ef1 ki\u1ec7n." } }, "secret": { "type": "string", "description": "Secret ch\u1ec9 tr\u1ea3 l\u00fac t\u1ea1o ho\u1eb7c xoay." }, "secret_hint": { "type": "string", "description": "Prefix \u0111\u1ec3 nh\u1eadn bi\u1ebft secret." }, "description": { "type": [ "string", "null" ], "description": "Ghi ch\u00fa webhook." }, "created_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m t\u1ea1o UTC.", "format": "date-time" }, "disabled_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m ng\u1eebng webhook.", "format": "date-time" } } }, "Template": { "type": "object", "description": "M\u1eabu th\u01b0.", "properties": { "id": { "type": "string", "description": "M\u00e3 tpl_..." }, "name": { "type": "string", "description": "T\u00ean m\u1eabu." }, "subject": { "type": "string", "description": "Ti\u00eau \u0111\u1ec1 m\u1eabu." }, "html": { "type": "string", "description": "HTML m\u1eabu." }, "text": { "type": [ "string", "null" ], "description": "V\u0103n b\u1ea3n thu\u1ea7n m\u1eabu." }, "variables": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "type": "string", "description": "T\u00ean bi\u1ebfn c\u1ea7n truy\u1ec1n." } } } }, "Account": { "type": "object", "description": "T\u00e0i kho\u1ea3n MONA Mail t\u1ea1o t\u1eeb MONA Pass.", "properties": { "sub": { "type": "string", "description": "Subject MONA Pass." }, "email": { "type": [ "string", "null" ], "description": "Email ch\u1ee7." }, "name": { "type": [ "string", "null" ], "description": "T\u00ean ch\u1ee7." }, "plan": { "$ref": "#/components/schemas/Plan" }, "quota": { "$ref": "#/components/schemas/Quota" }, "domains": { "type": "object", "description": "S\u1ed1 domain.", "properties": { "total": { "type": "integer", "description": "T\u1ed5ng domain." }, "verified": { "type": "integer", "description": "S\u1ed1 \u0111\u00e3 x\u00e1c minh." } } }, "onboarding_sender": { "type": "string", "description": "Sender d\u00f9ng th\u1eed t\u1edbi email ch\u1ee7." }, "sandbox_hint": { "type": "string", "description": "C\u00e1ch ch\u1ea1y sandbox." }, "next_step": { "type": "string", "description": "B\u01b0\u1edbc ti\u1ebfp cho AI." } } }, "Inbox": { "type": "object", "description": "H\u1ed9p th\u01b0 ri\u00eang c\u1ee7a agent.", "properties": { "id": { "type": "string", "description": "M\u00e3 h\u1ed9p ibox_..." }, "agent_id": { "type": "string", "description": "T\u00ean agent trong t\u00e0i kho\u1ea3n." }, "address": { "type": "string", "description": "\u0110\u1ecba ch\u1ec9 email \u0111\u1ea7y \u0111\u1ee7." }, "active": { "type": "boolean", "description": "H\u1ed9p c\u00f2n nh\u1eadn th\u01b0 m\u1edbi." }, "created_at": { "type": "string", "description": "Th\u1eddi \u0111i\u1ec3m t\u1ea1o UTC.", "format": "date-time" } } }, "InboxAttachment": { "type": "object", "description": "Metadata file \u0111\u00ednh k\u00e8m inbound.", "properties": { "id": { "type": "string", "description": "M\u00e3 file iatt_..." }, "filename": { "type": "string", "description": "T\u00ean file." }, "content_type": { "type": "string", "description": "Ki\u1ec3u MIME." }, "size_bytes": { "type": "integer", "description": "Dung l\u01b0\u1ee3ng byte." }, "download_url": { "type": "string", "description": "\u0110\u01b0\u1eddng d\u1eabn t\u1ea3i c\u1ea7n c\u00f9ng Bearer token." } } }, "InboxMessage": { "type": "object", "description": "Th\u01b0 \u0111\u00e3 nh\u1eadn trong h\u1ed9p agent.", "properties": { "id": { "type": "string", "description": "M\u00e3 th\u01b0 imsg_..." }, "rfc822_message_id": { "type": [ "string", "null" ], "description": "Message-ID c\u1ee7a b\u00ean g\u1eedi." }, "from_addr": { "type": "string", "description": "Header From." }, "to_addr": { "type": "string", "description": "\u0110\u1ecba ch\u1ec9 h\u1ed9p nh\u1eadn." }, "subject": { "type": [ "string", "null" ], "description": "Ti\u00eau \u0111\u1ec1." }, "received_at": { "type": "string", "description": "Th\u1eddi \u0111i\u1ec3m nh\u1eadn UTC.", "format": "date-time" }, "seen": { "type": "boolean", "description": "\u0110\u00e3 \u0111\u1ecdc n\u1ed9i dung \u0111\u1ea7y \u0111\u1ee7." }, "headers": { "type": "object", "description": "To\u00e0n b\u1ed9 header \u0111\u00e3 parse.", "additionalProperties": { "type": "string", "description": "Gi\u00e1 tr\u1ecb header." } }, "text": { "type": [ "string", "null" ], "description": "N\u1ed9i dung text/plain." }, "html": { "type": [ "string", "null" ], "description": "N\u1ed9i dung text/html." }, "text_excerpt": { "type": [ "string", "null" ], "description": "Tr\u00edch \u0111o\u1ea1n t\u1ed1i \u0111a 1000 k\u00fd t\u1ef1." }, "has_attachments": { "type": "boolean", "description": "C\u00f3 file \u0111\u00ednh k\u00e8m." }, "attachments": { "type": "array", "description": "Danh s\u00e1ch k\u1ebft qu\u1ea3.", "items": { "$ref": "#/components/schemas/InboxAttachment" } }, "size_bytes": { "type": "integer", "description": "Dung l\u01b0\u1ee3ng raw .eml." }, "expires_at": { "type": "string", "description": "Th\u1eddi \u0111i\u1ec3m purge.", "format": "date-time" }, "extracted_code": { "type": [ "string", "null" ], "description": "M\u00e3 OTP 4 t\u1edbi 8 ch\u1eef s\u1ed1 khi wait match=otp." } } }, "Suppression": { "type": "object", "description": "\u0110\u1ecba ch\u1ec9 \u0111ang b\u1ecb ch\u1eb7n.", "properties": { "id": { "type": "string", "description": "M\u00e3 suppression." }, "email": { "type": "string", "description": "\u0110\u1ecba ch\u1ec9 email." }, "reason": { "type": "string", "description": "hard_bounce, complaint, manual ho\u1eb7c unsubscribe." }, "source": { "type": "string", "description": "Ngu\u1ed3n t\u1ea1o suppression." }, "scope": { "type": "string", "description": "account ho\u1eb7c global." }, "created_at": { "type": [ "string", "null" ], "description": "Th\u1eddi \u0111i\u1ec3m t\u1ea1o UTC.", "format": "date-time" }, "expires_at": { "type": [ "string", "null" ], "description": "H\u1ebft h\u1ea1n; null l\u00e0 v\u0129nh vi\u1ec5n.", "format": "date-time" } } }, "WebhookDelivery": { "type": "object", "description": "L\u1ecbch s\u1eed g\u1ecdi webhook.", "properties": { "id": { "type": "string", "description": "M\u00e3 l\u1ea7n g\u1ecdi." }, "event_id": { "type": "string", "description": "M\u00e3 s\u1ef1 ki\u1ec7n d\u00f9ng ch\u1ed1ng l\u1eb7p." }, "status": { "type": "string", "description": "pending, delivered, failed ho\u1eb7c disabled." }, "attempts": { "type": "integer", "description": "S\u1ed1 l\u1ea7n \u0111\u00e3 g\u1ecdi." }, "next_attempt_at": { "type": "string", "description": "Th\u1eddi \u0111i\u1ec3m retry ti\u1ebfp theo.", "format": "date-time" }, "last_status_code": { "type": [ "integer", "null" ], "description": "HTTP status l\u1ea7n g\u1ecdi g\u1ea7n \u0111\u00e2y." }, "last_error": { "type": [ "string", "null" ], "description": "L\u1ed7i k\u1ebft n\u1ed1i ho\u1eb7c HTTP." }, "duration_ms": { "type": [ "integer", "null" ], "description": "Th\u1eddi gian g\u1ecdi, ms." } } } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "JWT MONA Pass RS256 ho\u1eb7c mm_live_/mm_test_." }, "InternalToken": { "type": "apiKey", "in": "header", "name": "X-Internal-Token", "description": "Token ch\u1ec9 d\u00f9ng tr\u00ean localhost." } } }, "servers": [ { "url": "https://api.monamail.vn", "description": "MONA Mail production" } ] }