Mailgun Email API · 区域化邮件服务接口

Mailgun 提供邮件发送、接收及相关管理 API，按域名所在 US/EU 区域使用不同基址，并需要 API key。当前仅整理官方概览，没有发送邮件、配置域名或调用接口。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-2c3a221cc0f5215af7260dfc
Card version: 2
Updated: 2026-10-24T17:25:39.5292629+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

US 域名 API 基址为 https://api.mailgun.net/，EU 域名为 https://api.eu.mailgun.net/。接口采用 URI 版本，不同 endpoint 可能有不同版本，不能把某一路径版本当全产品版本。概览说明标准 HTTP 状态码、常见 JSON 错误 message、一般 RFC-3339 日期及 X-RateLimit-* 头。完整邮件操作、请求方法、参数和输出应依据相应 endpoint 参考，当前概览没有给出可直接复现的完整发信调用。

Inputs

与已配置域名匹配的 US 或 EU 基址
相应 endpoint 的路径版本、方法和参数
有效 API key，按官方认证契约置于 Authorization

Outputs

对应邮件或管理 endpoint 的响应；具体字段依操作而定
标准 HTTP 状态及概览说明的 JSON 错误 message
X-RateLimit-Limit、Remaining、Reset 等限流状态头

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u6982\u89C8\u660E\u786E\u65E0\u6548\u6216\u7F3A\u5C11 API key \u4F1A\u8FD4\u56DE 401\uFF0C\u5E76\u63D0 Authorization \u5934\uFF1B\u5177\u4F53\u8BA4\u8BC1\u7F16\u7801\u987B\u53C2\u7167\u72EC\u7ACB\u8BA4\u8BC1\u8BF4\u660E\uFF0C\u4E0D\u80FD\u4ECE\u6982\u89C8\u731C\u5B9A\u3002"
  },
  "command": null,
  "entry_url": "https://api.mailgun.net/",
  "kind": "http_api",
  "method": null,
  "requirements": [
    "Mailgun \u8D26\u6237\u548C\u9002\u7528\u57DF\u540D\u914D\u7F6E",
    "\u6709\u6548\u4E14\u6743\u9650\u9002\u5F53\u7684 API key",
    "\u6309\u57DF\u540D\u533A\u57DF\u9009\u62E9\u57FA\u5740\u5E76\u6838\u5BF9\u5177\u4F53 endpoint \u53C2\u8003",
    "\u53D1\u9001\u3001\u4FEE\u6539\u6216\u5904\u7406\u771F\u5B9E\u90AE\u4EF6\u8D44\u6599\u987B\u7B26\u5408\u5177\u4F53\u4EFB\u52A1\u6388\u6743"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u6982\u89C8\u63D0\u8D26\u6237\u548C billing plan\uFF0C\u4F46\u6CA1\u6709\u786E\u8BA4\u5F53\u524D\u4EF7\u683C\u3001\u514D\u8D39\u53D1\u9001\u91CF\u3001\u8BD5\u7528\u8981\u6C42\u6216\u5404\u7AEF\u70B9\u914D\u989D\u3002",
  "source_url": null
}

{
  "location": "provider_server",
  "notes": "\u5B98\u65B9\u6982\u89C8\u5C06 message\u3001event logs \u7B49\u5217\u4E3A region-bound\uFF0C\u8D26\u6237\u3001\u8D26\u5355\u3001API key \u4E0E\u57DF\u540D\u7B49\u90E8\u5206\u8D44\u6599\u5217\u4E3A\u5168\u7403\u590D\u5236\uFF1B\u8FD9\u662F\u4E0A\u6E38\u6587\u6863\u58F0\u660E\uFF0C\u672A\u72EC\u7ACB\u9A8C\u8BC1\uFF0C\u4E5F\u4E0D\u662F\u5168\u90E8\u8D44\u6599\u4E0D\u8DE8\u533A\u6216\u4E0D\u7559\u5B58\u7684\u4FDD\u8BC1\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

未注册账户、读取或配置真实域名、取得凭据、发送邮件或调用任何邮件 API。
发信、收件、账户管理与查询动作不同，不能把资料收录当向他人发送消息的授权。
不同 endpoint 可能有不同版本、限额和时间窗口，概览不够定义完整发信参数。
US/EU 基址要与域名区域匹配，不能混用。
遇到 429 应按该接口实际限流头处理，本文未给出统一数字限额。

Unknowns

具体发信 endpoint、请求 schema、鉴权编码和输出格式需进一步核对，不提供猜测命令。
收费、试用/免费额度、当前数字限额和投递质量未确认。
数据留存、合规适用性和实际区域隔离未实测。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:24:14.9817888\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5B98\u65B9\u6982\u89C8\u5C06 message\u3001event logs \u7B49\u5217\u4E3A region-bound\uFF0C\u8D26\u6237\u3001\u8D26\u5355\u3001API key \u4E0E\u57DF\u540D\u7B49\u90E8\u5206\u8D44\u6599\u5217\u4E3A\u5168\u7403\u590D\u5236\uFF1B\u8FD9\u662F\u4E0A\u6E38\u6587\u6863\u58F0\u660E\uFF0C\u672A\u72EC\u7ACB\u9A8C\u8BC1\uFF0C\u4E5F\u4E0D\u662F\u5168\u90E8\u8D44\u6599\u4E0D\u8DE8\u533A\u6216\u4E0D\u7559\u5B58\u7684\u4FDD\u8BC1\u3002"
  },
  "description": "US \u57DF\u540D API \u57FA\u5740\u4E3A https://api.mailgun.net/\uFF0CEU \u57DF\u540D\u4E3A https://api.eu.mailgun.net/\u3002\u63A5\u53E3\u91C7\u7528 URI \u7248\u672C\uFF0C\u4E0D\u540C endpoint \u53EF\u80FD\u6709\u4E0D\u540C\u7248\u672C\uFF0C\u4E0D\u80FD\u628A\u67D0\u4E00\u8DEF\u5F84\u7248\u672C\u5F53\u5168\u4EA7\u54C1\u7248\u672C\u3002\u6982\u89C8\u8BF4\u660E\u6807\u51C6 HTTP \u72B6\u6001\u7801\u3001\u5E38\u89C1 JSON \u9519\u8BEF message\u3001\u4E00\u822C RFC-3339 \u65E5\u671F\u53CA X-RateLimit-* \u5934\u3002\u5B8C\u6574\u90AE\u4EF6\u64CD\u4F5C\u3001\u8BF7\u6C42\u65B9\u6CD5\u3001\u53C2\u6570\u548C\u8F93\u51FA\u5E94\u4F9D\u636E\u76F8\u5E94 endpoint \u53C2\u8003\uFF0C\u5F53\u524D\u6982\u89C8\u6CA1\u6709\u7ED9\u51FA\u53EF\u76F4\u63A5\u590D\u73B0\u7684\u5B8C\u6574\u53D1\u4FE1\u8C03\u7528\u3002",
  "inputs": [
    "\u4E0E\u5DF2\u914D\u7F6E\u57DF\u540D\u5339\u914D\u7684 US \u6216 EU \u57FA\u5740",
    "\u76F8\u5E94 endpoint \u7684\u8DEF\u5F84\u7248\u672C\u3001\u65B9\u6CD5\u548C\u53C2\u6570",
    "\u6709\u6548 API key\uFF0C\u6309\u5B98\u65B9\u8BA4\u8BC1\u5951\u7EA6\u7F6E\u4E8E Authorization"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u6982\u89C8\u660E\u786E\u65E0\u6548\u6216\u7F3A\u5C11 API key \u4F1A\u8FD4\u56DE 401\uFF0C\u5E76\u63D0 Authorization \u5934\uFF1B\u5177\u4F53\u8BA4\u8BC1\u7F16\u7801\u987B\u53C2\u7167\u72EC\u7ACB\u8BA4\u8BC1\u8BF4\u660E\uFF0C\u4E0D\u80FD\u4ECE\u6982\u89C8\u731C\u5B9A\u3002"
    },
    "command": null,
    "entry_url": "https://api.mailgun.net/",
    "kind": "http_api",
    "method": null,
    "requirements": [
      "Mailgun \u8D26\u6237\u548C\u9002\u7528\u57DF\u540D\u914D\u7F6E",
      "\u6709\u6548\u4E14\u6743\u9650\u9002\u5F53\u7684 API key",
      "\u6309\u57DF\u540D\u533A\u57DF\u9009\u62E9\u57FA\u5740\u5E76\u6838\u5BF9\u5177\u4F53 endpoint \u53C2\u8003",
      "\u53D1\u9001\u3001\u4FEE\u6539\u6216\u5904\u7406\u771F\u5B9E\u90AE\u4EF6\u8D44\u6599\u987B\u7B26\u5408\u5177\u4F53\u4EFB\u52A1\u6388\u6743"
    ]
  },
  "limitations": [
    "\u672A\u6CE8\u518C\u8D26\u6237\u3001\u8BFB\u53D6\u6216\u914D\u7F6E\u771F\u5B9E\u57DF\u540D\u3001\u53D6\u5F97\u51ED\u636E\u3001\u53D1\u9001\u90AE\u4EF6\u6216\u8C03\u7528\u4EFB\u4F55\u90AE\u4EF6 API\u3002",
    "\u53D1\u4FE1\u3001\u6536\u4EF6\u3001\u8D26\u6237\u7BA1\u7406\u4E0E\u67E5\u8BE2\u52A8\u4F5C\u4E0D\u540C\uFF0C\u4E0D\u80FD\u628A\u8D44\u6599\u6536\u5F55\u5F53\u5411\u4ED6\u4EBA\u53D1\u9001\u6D88\u606F\u7684\u6388\u6743\u3002",
    "\u4E0D\u540C endpoint \u53EF\u80FD\u6709\u4E0D\u540C\u7248\u672C\u3001\u9650\u989D\u548C\u65F6\u95F4\u7A97\u53E3\uFF0C\u6982\u89C8\u4E0D\u591F\u5B9A\u4E49\u5B8C\u6574\u53D1\u4FE1\u53C2\u6570\u3002",
    "US/EU \u57FA\u5740\u8981\u4E0E\u57DF\u540D\u533A\u57DF\u5339\u914D\uFF0C\u4E0D\u80FD\u6DF7\u7528\u3002",
    "\u9047\u5230 429 \u5E94\u6309\u8BE5\u63A5\u53E3\u5B9E\u9645\u9650\u6D41\u5934\u5904\u7406\uFF0C\u672C\u6587\u672A\u7ED9\u51FA\u7EDF\u4E00\u6570\u5B57\u9650\u989D\u3002"
  ],
  "outputs": [
    "\u5BF9\u5E94\u90AE\u4EF6\u6216\u7BA1\u7406 endpoint \u7684\u54CD\u5E94\uFF1B\u5177\u4F53\u5B57\u6BB5\u4F9D\u64CD\u4F5C\u800C\u5B9A",
    "\u6807\u51C6 HTTP \u72B6\u6001\u53CA\u6982\u89C8\u8BF4\u660E\u7684 JSON \u9519\u8BEF message",
    "X-RateLimit-Limit\u3001Remaining\u3001Reset \u7B49\u9650\u6D41\u72B6\u6001\u5934"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u6982\u89C8\u63D0\u8D26\u6237\u548C billing plan\uFF0C\u4F46\u6CA1\u6709\u786E\u8BA4\u5F53\u524D\u4EF7\u683C\u3001\u514D\u8D39\u53D1\u9001\u91CF\u3001\u8BD5\u7528\u8981\u6C42\u6216\u5404\u7AEF\u70B9\u914D\u989D\u3002",
    "source_url": null
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:24:14.9817888\u002B00:00",
      "title": "Overview | Mailgun API | Sinch",
      "url": "https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview"
    }
  ],
  "summary": "Mailgun \u63D0\u4F9B\u90AE\u4EF6\u53D1\u9001\u3001\u63A5\u6536\u53CA\u76F8\u5173\u7BA1\u7406 API\uFF0C\u6309\u57DF\u540D\u6240\u5728 US/EU \u533A\u57DF\u4F7F\u7528\u4E0D\u540C\u57FA\u5740\uFF0C\u5E76\u9700\u8981 API key\u3002\u5F53\u524D\u4EC5\u6574\u7406\u5B98\u65B9\u6982\u89C8\uFF0C\u6CA1\u6709\u53D1\u9001\u90AE\u4EF6\u3001\u914D\u7F6E\u57DF\u540D\u6216\u8C03\u7528\u63A5\u53E3\u3002",
  "tags": [
    "Mailgun",
    "\u90AE\u4EF6 API",
    "API key",
    "US/EU",
    "HTTP API"
  ],
  "terms_url": null,
  "title": "Mailgun Email API \u00B7 \u533A\u57DF\u5316\u90AE\u4EF6\u670D\u52A1\u63A5\u53E3",
  "unknowns": [
    "\u5177\u4F53\u53D1\u4FE1 endpoint\u3001\u8BF7\u6C42 schema\u3001\u9274\u6743\u7F16\u7801\u548C\u8F93\u51FA\u683C\u5F0F\u9700\u8FDB\u4E00\u6B65\u6838\u5BF9\uFF0C\u4E0D\u63D0\u4F9B\u731C\u6D4B\u547D\u4EE4\u3002",
    "\u6536\u8D39\u3001\u8BD5\u7528/\u514D\u8D39\u989D\u5EA6\u3001\u5F53\u524D\u6570\u5B57\u9650\u989D\u548C\u6295\u9012\u8D28\u91CF\u672A\u786E\u8BA4\u3002",
    "\u6570\u636E\u7559\u5B58\u3001\u5408\u89C4\u9002\u7528\u6027\u548C\u5B9E\u9645\u533A\u57DF\u9694\u79BB\u672A\u5B9E\u6D4B\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:24:14.9817888\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-2c3a221cc0f5215af7260dfc",
  "version": 2,
  "source_url": "https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview",
    "final_url": "https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview",
    "status_code": 200,
    "title": "Overview | Mailgun API | Sinch",
    "description": "The Mailgun API enables you to send, track, and receive email effortlessly.",
    "checked_at": "2026-10-24T17:24:14.9817888\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:24:18.4306231\u002B00:00",
  "updated_at": "2026-10-24T17:25:39.5292629\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-2c3a221cc0f5215af7260dfc?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-2c3a221cc0f5215af7260dfc?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u901A\u4FE1\u4E0E\u90AE\u4EF6\uFF0FMailgun \u533A\u57DF\u5316\u90AE\u4EF6 API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-5a8c1167e8f2f751cd124f1fff3c5b7a",
        "source_url": "https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview",
        "content_sha256": "9ba788e31fb01b0c92591ed1c8f0d6b3f6d736d5492598bccbe136143d6cb97f",
        "decoded_bytes": 448167,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:24:14.9817888\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "9ba788e31fb01b0c92591ed1c8f0d6b3f6d736d5492598bccbe136143d6cb97f",
        "text_utf8_bytes": 448167,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-2c3a221cc0f5215af7260dfc/materials/material-5a8c1167e8f2f751cd124f1fff3c5b7a?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-5339bb7fab734b4686afb0cb18b585a9",
    "reason": "\u4EC5\u4F9D\u636E\u672C\u6B21\u5DF2\u4FDD\u5B58\u5B98\u65B9\u516C\u5F00\u6B63\u6587\u6574\u7406\u7528\u9014\u3001\u5165\u53E3\u3001\u6761\u4EF6\u548C\u672A\u77E5\u9879\uFF1B\u4FDD\u7559\u539F\u6587\u8BC1\u636E\uFF0C\u4E0D\u5C06\u8BF4\u660E\u6587\u6863\u5192\u5145\u5B9E\u9645\u63A5\u901A\u3001\u529F\u80FD\u5B9E\u6D4B\u6216\u53EF\u7528\u6027\u4FDD\u8BC1\u3002",
    "source_urls": [
      "https://documentation.mailgun.com/docs/mailgun/api-reference/api-overview"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-2c3a221cc0f5215af7260dfc",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-2c3a221cc0f5215af7260dfc?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-2c3a221cc0f5215af7260dfc?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure