apidVerifyAPIKey-api.yaml

# Copyright 2017 Google Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

host: playground.apistudio.io
swagger: '2.0'
info:
  version: 0.0.1
  title: Edge X Verify API Key
  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
basePath: /verifiers
schemes:
  - http
consumes:
  - application/json
produces:
  - application/json
paths:
  /:
    get:
      description: List verifiers
      responses:
        '200':
          description: OK
          schema:
            type: array
            items:
              type: string
              enum:
                - "apikey"
  /apikey:
    post:
      description: Verify API key valid and return message context
      parameters:
        - name: Authorization
          in: header
          required: true
          type: string
          description: authCode from /deployments/current
        - name: _
          in: body
          required: true
          schema:
            $ref: '#/definitions/VerifyAPIKeyRequest'
      responses:
        '200':
          description: The result of the request
          schema:
            type: object
            enum:
              - $ref: '#/definitions/VerifyAPIKeyResponseSuccess'
              - $ref: '#/definitions/VerifyAPIKeyResponseFailed'
          examples:
            application/json:
              responseType: APIKeyContext
              resultCode: "SUCCESS"
              result:
                key: abc123
                expiresAt: 1234567890
                issuedAt: 1234567890
                status: abc123
                redirectionURIs: abc123
                appName: abc123
                appId: abc123
                cType: "developer"
        default:
          description: 4xx or 5xx errors
          schema:
            $ref: '#/definitions/ErrorResponse'

definitions:

  ErrorResult:
    type: object
    required:
      - errorCode
      - reason
    properties:
      errorCode:
        type: number
      reason:
        type: string

  VerifyAPIKeyRequest:
    type: object
    required:
      - action
      - key
      - uriPath
      - scopeuuid
    properties:
      action:
        enum:
          - "verify"
      key:
        type: string
      uriPath:
        type: string
      scopeuuid:
        type: string

  VerifyAPIKeyResponse:
    type: object
    required:
      - type
    properties:
      type:
        type: string
      result:
        description: present if type is NOT ErrorResult, override me
        type: object
      error:
        description: present if type is ErrorResult, override me
        type: object

  VerifyAPIKeyResponseSuccess:
    allOf:
      - $ref: '#/definitions/VerifyAPIKeyResponse'
      - type: object
        properties:
          result:
            type: object
            properties:
              key:
                type: string
              expiresAt:
                type: integer
              issuedAt:
                type: integer
              status:
                type: string
              redirectionURIs:
                type: string
              appName:
                type: string
              appId:
                type: string
              cType:
                type: string
    example:
      type: "APIKeyContext"
      result:
        key: "abc123"
        expiresAt: 1234567890
        issuedAt: 1234567890
        status: "abc123"
        redirectionURIs: "abc123"
        appName: "abc123"
        appId: "abc123"
        cType: "company OR developer"

  VerifyAPIKeyResponseFailed:
    allOf:
      - $ref: '#/definitions/VerifyAPIKeyResponse'
      - type: object
        properties:
          error:
            $ref: '#/definitions/ErrorResult'
    example:
      type: "ErrorResult"
      error:
        errorCode: 606
        reason: "APIKey expired"

  ErrorResponse:
    required:
      - errorCode
      - reason
    properties:
      errorCode:
        type: number
      reason:
        type: string
    example:
      errorCode: 607
      reason: "Something wrong!"