woodpecker/doc/swagger.yml
2015-05-17 19:25:53 -07:00

129 lines
2.6 KiB
YAML

swagger: "2.0"
info:
version: 1.0.0
title: Drone API
contact:
name: Team Drone
url: "https://github.com/drone/drone"
license:
name: Creative Commons 4.0 International
url: "http://creativecommons.org/licenses/by/4.0/"
host: "localhost:8080"
basePath: /api
schemes:
- http
paths:
/user:
get:
description: Returns the currently authenticated user.
produces:
- application/json
responses:
"200":
description: The currently authenticated user.
schema:
$ref: "#/definitions/User"
patch:
description: Updates the currently authenticated user.
produces:
- application/json
parameters:
- name: user
in: body
description: Updates to the user.
required: true
schema:
$ref: "#/definitions/User"
responses:
"200":
description: The updated user.
schema:
$ref: "#/definitions/User"
definitions:
User:
properties:
login:
type: string
name:
type: string
email:
type: string
gravatar_id:
type: string
admin:
type: boolean
active:
type: boolean
created_at:
type: integer
format: int64
updated_at:
type: integer
format: int64
Repo:
properties:
owner:
type: string
name:
type: string
created_at:
type: integer
format: int64
updated_at:
type: integer
format: int64
Commit:
properties:
sequence:
type: integer
state:
type: string
sha:
type: string
ref:
type: string
branch:
type: string
author:
type: string
gravatar_id:
type: string
message:
type: string
pull_request:
type: boolean
started_at:
type: integer
format: int64
finished_at:
type: integer
format: int64
created_at:
type: integer
format: int64
updated_at:
type: integer
format: int64
Build:
properties:
sequence:
type: integer
state:
type: string
exit_code:
type: integer
duration:
type: integer
format: int64
started_at:
type: integer
format: int64
finished_at:
type: integer
format: int64
created_at:
type: integer
format: int64
updated_at:
type: integer
format: int64