83 lines
2.0 KiB
YAML
83 lines
2.0 KiB
YAML
openapi: 3.0.2
|
|
|
|
|
|
info:
|
|
title: Digital fingerprint of plastics - API
|
|
version: 1.0.0
|
|
description: |
|
|
This API gives access to the project database.<br>
|
|
Access is restricted. Authentication can be obtained with HTTP Basic Auth using username and password. Data access methods can also be accessed using an API key at the URL ending like ?key=xxx<br>
|
|
There are a number of different user levels: <br>
|
|
<ul>
|
|
<li>read: read access to the samples database</li>
|
|
<li>write: write access to the samples database, users can change only the values they created</li>
|
|
<li>maintain: functions like changing templates, validating data, changing values of others</li>
|
|
<li>dev: handling machine learning models</li>
|
|
<li>admin: user administration</li>
|
|
</ul>
|
|
Password policy:
|
|
<ul>
|
|
<li>at least one digit</li>
|
|
<li>at least one lower case letter</li>
|
|
<li>at least one upper case letter</li>
|
|
<li>at least one of the following special characters: !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~</li>
|
|
<li>no whitespace</li>
|
|
<li>at least 8 characters</li>
|
|
</ul>
|
|
|
|
|
|
|
|
servers:
|
|
- url: http://localhost:3000
|
|
description: local server
|
|
- url: https://digital-fingerprint-of-plastics-api.apps.de1.bosch-iot-cloud.com/
|
|
description: server on the BIC
|
|
|
|
|
|
security:
|
|
- ApiKey: []
|
|
- BasicAuth: []
|
|
|
|
|
|
tags:
|
|
- name: /
|
|
- name: /sample
|
|
- name: /material
|
|
- name: /condition
|
|
- name: /measurement
|
|
- name: /templates
|
|
- name: /model
|
|
- name: /user
|
|
|
|
|
|
paths:
|
|
allOf:
|
|
- $ref: 'others.yaml'
|
|
- $ref: 'sample.yaml'
|
|
- $ref: 'material.yaml'
|
|
- $ref: 'condition.yaml'
|
|
- $ref: 'measurement.yaml'
|
|
- $ref: 'template.yaml'
|
|
- $ref: 'model.yaml'
|
|
- $ref: 'user.yaml'
|
|
|
|
|
|
components:
|
|
parameters:
|
|
$ref: 'parameters.yaml'
|
|
|
|
schemas:
|
|
$ref: 'schemas.yaml'
|
|
|
|
responses:
|
|
$ref: 'responses.yaml'
|
|
|
|
|
|
securitySchemes:
|
|
BasicAuth:
|
|
type: http
|
|
scheme: basic
|
|
ApiKey:
|
|
type: apiKey
|
|
in: query
|
|
name: key |