blob: 6e5b06576b598675c819b89d4d9675a9ba922f13 [file] [log] [blame]
openapi: "3.0.0"
info:
version: 0.0.1
title: marvin_mnist_keras_engine API Doc
contact:
name: mantainer Marvin AI Community
email: marvin-ai@googlegroups.com
url: https://github.com/marvin-ai
license:
name: Apache License 2.0
servers:
- url: http://localhost:8000
- url: http://0.0.0.0:8000
tags:
- name: Docker
description: For Docker users, please use "make docker-build" and "make docker-run" commands in your engine virtualenv to start the server
- name: Acquisitor
description: Setup the initial_dataset with all cleaned data necessary to build your dataset in the next action
- name: Tpreparator
description: Setup the dataset with the transformed data that is compatible with the algorithm used to build the model in the next action
- name: Trainer
description: Setup the model with the result of the algorithm used to training
- name: Evaluator
description: Setup the metrics with the result of the algorithms used to test the model
- name: Predictor
description: Return the predicted value in a json parsable object format
- name: Feedback
description: Receive feedback message, user can manipulate this message for any use
- name: Pipeline
description: Perform all batch actions in your right order
paths:
/acquisitor/health:
get:
summary: Get acquisitor's service health
operationId: getHealth
tags:
- Acquisitor
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/acquisitor/status:
get:
summary: Get acquisitor's service status
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: Use an empty json as body
required: true
content:
application/json:
schema:
type: object
operationId: getStatus
tags:
- Acquisitor
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/acquisitor:
post:
summary: Run acquisitor
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: acquisit
tags:
- Acquisitor
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/tpreparator/health:
get:
summary: Get trainer preparator's service health
operationId: getHealth
tags:
- Tpreparator
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/tpreparator/status:
get:
summary: Get trainer preparator's service status
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: Use an empty json as body
required: true
content:
application/json:
schema:
type: object
operationId: getStatus
tags:
- Tpreparator
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/tpreparator/reload?protocol=:
put:
summary: Reload artifact for trainer preparator
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: tpreparator
tags:
- Tpreparator
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/tpreparator:
post:
summary: Run trainer preparator
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: tpreparator
tags:
- Tpreparator
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/trainer/health:
get:
summary: Get trainer's service health
operationId: getHealth
tags:
- Trainer
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/trainer/status:
get:
summary: Get trainer's service status
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: Use an empty json as body
required: true
content:
application/json:
schema:
type: object
operationId: getStatus
tags:
- Trainer
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/trainer/reload?protocol=:
put:
summary: Reload artifact for trainer
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: trainer
tags:
- Trainer
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/trainer:
post:
summary: Run trainer
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: trainer
tags:
- Trainer
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/evaluator/health:
get:
summary: Get evaluator's service health
operationId: getHealth
tags:
- Evaluator
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/evaluator/status:
get:
summary: Get evaluator's service status
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: Use an empty json as body
required: true
content:
application/json:
schema:
type: object
operationId: getStatus
tags:
- Evaluator
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/evaluator/reload?protocol=:
put:
summary: Reload artifact for evaluator
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: evaluator
tags:
- Evaluator
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/evaluator:
post:
summary: Run evaluator
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: evaluator
tags:
- Evaluator
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/predictor/health:
get:
summary: Get predictor's service health
operationId: getHealth
tags:
- Predictor
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/predictor/status:
get:
summary: Get predictor's service status
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: Use an empty json as body
required: true
content:
application/json:
schema:
type: object
operationId: getStatus
tags:
- Predictor
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/predictor/reload?protocol=:
put:
summary: Reload artifact for predictor
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: reloadArtifact
tags:
- Predictor
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/predictor:
post:
summary: Run predictor
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: predict
tags:
- Predictor
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/feedback/health:
get:
summary: Get feedback's service health
operationId: getHealth
tags:
- Feedback
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/feedback/status:
get:
summary: Get feedback's service status
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: Use an empty json as body
required: true
content:
application/json:
schema:
type: object
operationId: getStatus
tags:
- Feedback
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/feedback/reload?protocol=:
put:
summary: Reload artifact for feedback
parameters:
- in: query
name: protocol
schema:
type: string
required: true
description: The Protocol value generated from last action
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: reloadArtifact
tags:
- Feedback
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/feedback:
post:
summary: Run feedback
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: feedback
tags:
- Feedback
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable
/pipeline:
post:
summary: Do all batch actions (from Acquisitor to Evaluator)
requestBody:
description: The default value for body is an empty json object
required: true
content:
application/json:
schema:
type: object
operationId: pipeline
tags:
- Pipeline
responses:
'200':
description: Result Message / Success
'400':
description: Bad Request / Illegal Argument / Missing Parameters
'500':
description: Internal Server Error / Timeout
'503':
description: Service Unavailable