Travis

Travis CI API

API V3 #

Travis CI API V3 于 2017 年 4 月 6 日发布。它是一个可发现的、自文档的 RESTful API，包括现代 API 所期望的所有超媒体功能。

我们的 API 可用于自动化许多 Travis CI 构建流程

  • 获取构建信息
  • 获取组织信息
  • 获取嵌套资源
  • 重新启动构建或作业
  • 取消构建或作业
  • 触发调试构建
  • 处理分页
  • 编辑环境变量
  • 验证 .travis.yml 文件

我们创建了一个 API 资源管理器，它与 V3 紧密集成，在添加新端点时自动更新，并包含一个用于探索端点的有用工具。

API V2.1 #

我们发布了对 Travis CI API V2 的更新，即 API V2.1。此更新主要使 travis-ci.org 和 travis-ci.com 之间的 HTTP 状态代码更加一致。

如果您在 travis-ci.com 上构建开源项目和私有项目，请使用 API V2.1。

对于使用 travis-ci.org 上的弃用平台构建开源项目的 Travis CI 用户，该平台构建在 api.travis-ci.org 上，API 没有变化。

API V2.1 与 API V2 相同，**除了以下重大更改**

  • 对于公共存储库，未经身份验证的请求在某些情况下会收到 HTTP 200 或 HTTP 404 错误，例如存储库缓存或设置。
  • 对于私有存储库，未经身份验证的请求会收到 HTTP 401 或 404 错误。
  • 对于私有存储库，没有权限查看存储库的用户进行的身份验证请求会收到 HTTP 400 错误或 HTTP 200（对于空响应）。

V2 的先前行为是这些请求会收到 401 错误。

类似的 HTTP 响应代码模式适用于其他端点，例如 /builds、/branches、/jobs 和 /requests。

要使用 API V2.1，请将 API 请求的 Accept 标头设置为 application/vnd.travis-ci.2.1+json。

API V2 #

我们还没有准备好弃用 API V2。我们使用 V2 与我们的 Web 前端应用程序，并且在过去 6 个月中逐渐从 V2 切换到 V3。我们将在未来几个月内完成此过渡，但计划在 2017 年底之前继续支持 V2。当然，我们将在关闭 V2 之前充分通知开发者，并提供有关迁移到 V3 的详细说明。

Ruby 库 #

Ruby 库 使用 API V2。