🚀 API DevOps Digital3D – 为人工智能而设计的API

我很高兴向您介绍 我的新API DevOps服务，可以通过交互式Swagger文档访问：

👉 https://devops.digital3d.com/swagger/index.html

但我们要明确一点：
👉 这个网站和这个API首先是为了供开发者、架构师或其他人使用的人工智能而设计的

人类当然是受欢迎的 😄，但主要目标是提供一个清晰、确定且可被AI代理利用的接口，能够理解、分析并对真实的DevOps环境采取行动。

🤖 为人工智能（IA-first）设计的DevOps API

现代人工智能不再仅仅是回答问题。
它们变成了自主代理，能够：

• 查询API，
• 解释结构化响应，
• 做出技术决策，
• 触发自动化操作。

这个DevOps API从一开始就为这种用途而设计。

设计原则

• 明确且无歧义的端点
• 可预测的JSON响应
• 零隐含逻辑

👉 AI绝不应该猜测一个DevOps API是如何工作的。
👉 它应该能够干净地查询并可靠地采取行动。

🧠 为什么要将DevOps与人工智能连接起来？

在不久的将来（而且已经很明显），一个AI将能够：

• 检测您代码中的异常
• 分析重复的失败
• 提出或触发纠正措施
• 作为人类与基础设施之间的对话接口

这个API是这种场景的基础构件。

🧪 可供人类和AI使用的Swagger文档

Swagger文档不仅仅是为了开发者的便利。

👉 它还用于：

• 提供API与AI之间的明确合同
• 允许能力的自我发现
• 促进与AI代理或MCP连接器的集成
• 立即测试端点

📍 直接访问：https://devops.digital3d.com/swagger/index.html

🔗 面向AI的用例

🤖 智能DevOps助手

“我的文件 'MonFichier.cs' 中的代码是否包含错误？”
➡️ AI查询API并以自然语言回答。

🤖 自主监控代理

➡️ 检测重复失败 → 分析 → 决策 → 行动。

🎯 这个API适合谁？

这个API是为：

• AI开发者
• DevOps工程师
• 自主代理创建者
• MCP / LLM工具集成者
• 云架构师
• 智能自动化爱好者

如果您正在使用LLM、AI代理或自主工作流，这个API就是为您准备的。

🔐 安装 & 认证

要使用Digital3D的API DevOps，每个请求都必须包含三个HTTP头。

📌 必需的头

X-Ado-Org: <Azure DevOps组织名称>
X-Ado-Pat: <Azure DevOps个人访问令牌>
X-Api-Key: <Digital3D访问密钥>

这些头允许：

• 在Azure DevOps进行身份验证
• 识别目标组织
• 确保和控制Digital3D的访问

🏢 X-Ado-Org – Azure DevOps组织名称

头X-Ado-Org对应于您Azure DevOps组织的确切名称。

如何找到它？

1. 登录https://dev.azure.com
2. 观察显示的URL

示例：

https://dev.azure.com/my-company/

👉 要使用的值是：

X-Ado-Org: my-company 

⚠️ 这不是项目的名称，而是组织的名称。

🔑 X-Ado-Pat – 创建个人访问令牌（PAT）

PAT 允许 API 以 您的名义 访问 Azure DevOps。

创建步骤

1. 登录 Azure DevOps
2. 点击您的头像（右上角）
3. 选择 个人访问令牌
4. 点击 新令牌

推荐配置

• 名称 : Digital3D-DevOps-API
• 组织 : 您的组织
• 过期时间 : 推荐 30 或 90 天
• 范围（根据使用情况）：
  • 构建（读取）
  • 构建（读取和执行）
  • 发布（读取）
  • 项目和团队（读取）

⚠️ 请在创建后立即复制令牌，它将不再可见。

示例：

X-Ado-Pat: azdovpatxxxxxxxxxxxxxxxx 

🔐 X-Api-Key – Digital3D 访问密钥

头部 X-Api-Key 是您在 Digital3D.com 账户的密钥

👉 https://digital3d.com

步骤

1. 创建或登录您的 Digital3D 账户
2. 访问您的用户空间
3. 您将看到您的 个人 API 密钥
4. 妥善保管

示例：

X-Api-Key: d3d_live_xxxxxxxxxxxxx 

🧪 完整的 API 调用示例

GET /api/devops/projects
Host: devops.digital3d.com
X-Ado-Org: my-company
X-Ado-Pat: azdovpatxxxxxxxxxxxxxxxx
X-Api-Key: d3d_live_xxxxxxxxxxxxx 

此调用可以使用：

• 通过 Swagger UI
• 在脚本中
• 由自主 IA 代理
• 通过 LLM 或 MCP 连接器

⏱️ API 使用限制

Digital3D DevOps API 是 免费访问 的，以便进行测试、探索和与人工智能的集成。
但是，施加了 使用限制 以确保服务的稳定性。

🔓 无订阅

• 每天 5 次免费请求

适合：

• 测试
• 原型
• 与 IA 代理的试用

🚀 有订阅

• 每天 1,000 次请求

适合：

• 定期使用
• 自主 IA 代理
• CI/CD 集成
• 生产环境

👉 订阅允许扩展使用，同时确保服务的质量和持续性。

如果您希望每天有更多请求，请与我联系

🤖 结论

Digital3D DevOps API 是：

• 以 IA 为先
• 为自主代理设计
• 安全且可追踪
• 易于集成
• 文档齐全且可立即测试

👉 立即开始： https://devops.digital3d.com/swagger/index.html