Retrieve an Anchor for a given dataspace by anchor name - REST layer
[cps.git] / cps-rest / docs / api / swagger / cpsAdmin.yml
1 dataspace:
2   post:
3     tags:
4       - cps-admin
5     summary: Create a new dataspace
6     operationId: createDataspace
7     parameters:
8       - $ref: 'components.yaml#/components/parameters/dataspaceNameInQuery'
9     responses:
10       201:
11         $ref: 'components.yaml#/components/responses/Created'
12       400:
13         $ref: 'components.yaml#/components/responses/BadRequest'
14       401:
15         $ref: 'components.yaml#/components/responses/Unauthorized'
16       403:
17         $ref: 'components.yaml#/components/responses/Forbidden'
18
19 dataspaceByDataspaceName:
20   delete:
21     tags:
22       - cps-admin
23     summary: Delete the given dataspace - DRAFT
24     operationId: deleteDataspace
25     parameters:
26       - $ref: 'components.yaml#/components/parameters/dataspaceNameInPath'
27     responses:
28       200:
29         $ref: 'components.yaml#/components/responses/Ok'
30       204:
31         $ref: 'components.yaml#/components/responses/NoContent'
32       400:
33         $ref: 'components.yaml#/components/responses/BadRequest'
34       401:
35         $ref: 'components.yaml#/components/responses/Unauthorized'
36       403:
37         $ref: 'components.yaml#/components/responses/Forbidden'
38
39
40 schemaSet:
41   post:
42     tags:
43       - cps-admin
44     summary: Create a new schema set in the given dataspace
45     operationId: createSchemaSet
46     parameters:
47       - $ref: 'components.yaml#/components/parameters/dataspaceNameInPath'
48       - $ref: 'components.yaml#/components/parameters/schemaSetNameInQuery'
49     requestBody:
50       required: true
51       content:
52         multipart/form-data:
53           schema:
54             $ref: 'components.yaml#/components/schemas/MultipartFile'
55
56     responses:
57       201:
58         $ref: 'components.yaml#/components/responses/Created'
59       400:
60         $ref: 'components.yaml#/components/responses/BadRequest'
61       401:
62         $ref: 'components.yaml#/components/responses/Unauthorized'
63       403:
64         $ref: 'components.yaml#/components/responses/Forbidden'
65
66 schemaSetBySchemaSetName:
67   get:
68     tags:
69       - cps-admin
70     summary: Read a schema set given a schema set and a dataspace
71     operationId: getSchemaSet
72     parameters:
73       - $ref: 'components.yaml#/components/parameters/dataspaceNameInPath'
74       - $ref: 'components.yaml#/components/parameters/schemaSetNameInPath'
75     responses:
76       200:
77         $ref: 'components.yaml#/components/responses/Ok'
78       400:
79         $ref: 'components.yaml#/components/responses/BadRequest'
80       401:
81         $ref: 'components.yaml#/components/responses/Unauthorized'
82       403:
83         $ref: 'components.yaml#/components/responses/Forbidden'
84       404:
85         $ref: 'components.yaml#/components/responses/NotFound'
86   delete:
87     tags:
88       - cps-admin
89     summary: Delete schema set given a schema set and a dataspace
90     operationId: deleteSchemaSet
91     parameters:
92       - $ref: 'components.yaml#/components/parameters/dataspaceNameInPath'
93       - $ref: 'components.yaml#/components/parameters/schemaSetNameInPath'
94     responses:
95       204:
96         $ref: 'components.yaml#/components/responses/NoContent'
97       400:
98         $ref: 'components.yaml#/components/responses/BadRequest'
99       401:
100         $ref: 'components.yaml#/components/responses/Unauthorized'
101       403:
102         $ref: 'components.yaml#/components/responses/Forbidden'
103       409:
104         $ref: 'components.yaml#/components/responses/Conflict'
105
106 anchorsByDataspace:
107   get:
108     tags:
109       - cps-admin
110     summary: Read all anchors, given a dataspace
111     operationId: getAnchors
112     parameters:
113       - $ref: 'components.yaml#/components/parameters/dataspaceNameInPath'
114     responses:
115       200:
116         $ref: 'components.yaml#/components/responses/Ok'
117       400:
118         $ref: 'components.yaml#/components/responses/BadRequest'
119       401:
120         $ref: 'components.yaml#/components/responses/Unauthorized'
121       403:
122         $ref: 'components.yaml#/components/responses/Forbidden'
123       404:
124         $ref: 'components.yaml#/components/responses/NotFound'
125
126   post:
127     tags:
128       - cps-admin
129     summary: Create a new anchor in the given dataspace
130     operationId: createAnchor
131     parameters:
132       - $ref: 'components.yaml#/components/parameters/dataspaceNameInPath'
133       - $ref: 'components.yaml#/components/parameters/schemaSetNameInQuery'
134       - $ref: 'components.yaml#/components/parameters/anchorNameInQuery'
135     responses:
136       201:
137         $ref: 'components.yaml#/components/responses/Created'
138       400:
139         $ref: 'components.yaml#/components/responses/BadRequest'
140       401:
141         $ref: 'components.yaml#/components/responses/Unauthorized'
142       403:
143         $ref: 'components.yaml#/components/responses/Forbidden'
144
145 anchorByDataspaceAndAnchorName:
146   get:
147     tags:
148       - cps-admin
149     summary: Read an anchor given a anchor and a dataspace
150     operationId: getAnchor
151     parameters:
152       - $ref: 'components.yaml#/components/parameters/dataspaceNameInPath'
153       - $ref: 'components.yaml#/components/parameters/anchorNameInPath'
154     responses:
155       200:
156         $ref: 'components.yaml#/components/responses/Ok'
157       400:
158         $ref: 'components.yaml#/components/responses/BadRequest'
159       401:
160         $ref: 'components.yaml#/components/responses/Unauthorized'
161       403:
162         $ref: 'components.yaml#/components/responses/Forbidden'
163       404:
164         $ref: 'components.yaml#/components/responses/NotFound'
165
166   delete:
167     tags:
168       - cps-admin
169     summary: Delete an anchor given a anchor and a dataspace - DRAFT
170     operationId: deleteAnchor
171     parameters:
172       - $ref: 'components.yaml#/components/parameters/dataspaceNameInPath'
173       - $ref: 'components.yaml#/components/parameters/anchorNameInPath'
174     responses:
175       200:
176         $ref: 'components.yaml#/components/responses/Ok'
177       204:
178         $ref: 'components.yaml#/components/responses/NoContent'
179       400:
180         $ref: 'components.yaml#/components/responses/BadRequest'
181       401:
182         $ref: 'components.yaml#/components/responses/Unauthorized'
183       403:
184         $ref: 'components.yaml#/components/responses/Forbidden'