blob: ce587d00de749f07029403e3522bd6af3e4cedd3 [file] [log] [blame] [edit]
swagger: '2.0'
info:
version: "0.0.1"
title: apid apis for gateway
description: |
API for querying gateway configuration changes and complete state
contact:
name: Apigee, Inc.
url: http://www.apigee.com/
email: sales@apigee.com
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
host: "localhost:9000"
basePath: "/"
schemes:
- "https"
tags:
- name: "configurations"
description: "Get Configurations"
- name: "blob"
description: "Blob Download"
paths:
/configurations:
get:
tags:
- "configurations"
description: |
Get list of configurations associated with apid's datascope
parameters:
- name: "block"
in: "query"
type: string
description: "Long poll block duration in seconds"
- name: "If-None-Match"
in: "header"
type: string
description: "ETag value from request in previous request"
responses:
200:
description: Successful response
headers:
ETag:
type: "string"
description: "client can use this for response caching"
schema:
$ref: '#/definitions/ConfigurationsResponse'
304:
description: Not Modified, No change in response based on If-None-Match header value. Cache representation.
headers:
ETag:
type: "string"
description: "client can use this for response caching"
default:
description: Error response
schema:
$ref: '#/definitions/ErrorResponse'
/blobs/{blobId}:
get:
tags:
- "blob"
description: "Blob Download"
parameters:
- name: blobId
in: path
required: true
type: string
description: blobId
- name: "If-None-Match"
in: "header"
type: string
required: false
description: "ETag value from request in previous request"
responses:
200:
description: Successful response
headers:
Content-type:
type: "string"
description : "application/octet-stream"
ETag:
type: "string"
description: "client can use this for response caching"
304:
description: Not Modified, No change in response based on If-None-Match header value. Cache representation.
headers:
ETag:
type: "string"
description: "client can use this for response caching"
404:
description: Not Found
schema:
$ref: '#/definitions/ErrorResponse'
default:
description: Error response
schema:
$ref: '#/definitions/ErrorResponse'
definitions:
ConfigurationsResponse:
properties:
kind:
type: string
self:
type: string
contents:
type: array
items:
$ref: '#/definitions/Configurations'
Configurations:
properties:
self:
type: string
description: url to access this config
name:
type: string
description: configuration name
type:
type: string
description: type of configuration
organization:
type: string
description: organization id
environment:
type: string
description: environment id
revision:
type: string
description: revision of blob
blobId:
type: string
description: blob id
blobUrl:
type: string
description: url to download blob
resourceBlobId:
type: string
created:
type: string
description: Entity creation date. ISO8601 representation
updated:
type: string
description: Entity updated date. ISO8601 representation
ErrorResponse:
properties:
status:
type: string
message:
type: string
errors:
type: array
items:
type: string