mod-erm-usage/ramls/files.raml at master · folio-org/mod-erm-usage · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
#%RAML 1.0
title: File Storage of erm-usage module
version: v1
baseUri: http://localhost/mod-erm-usage

documentation:
  - title: mod-erm-usage API
    content: This documents the API calls that can be made to query and manage files in module erm-usage

types:
  errors: !include ./raml-util/schemas/errors.schema

traits:
  orderable: !include ./raml-util/traits/orderable.raml
  pageable: !include ./raml-util/traits/pageable.raml
  searchable: !include ./raml-util/traits/searchable.raml
  validate: !include ./raml-util/traits/validation.raml

resourceTypes:
  collection: !include ./raml-util/rtypes/collection.raml
  collection-item: !include ./raml-util/rtypes/item-collection.raml

/erm-usage/files:
  displayName: Erm Usage files
  post:
    description: Upload/update a file in module erm-usage.
    body:
      application/octet-stream:
    responses:
      200:
        description: Uploading the file was successful. Returns uuid of uploaded file. This uuid may be referenced in other elements.
        body:
          text/json:
      404:
        body:
          text/plain:
      500:
        body:
          text/plain:
  /{id}:
    get:
      description: Get file by id
      responses:
        200:
          body:
            application/octet-stream:
        404:
          body:
            text/plain:
        500:
          description: Server Error
          body:
            text/plain:
    delete:
      description: Delete a file identified by id
      responses:
        204:
          description: "Delete succeeded"
        400:
          description: "Bad request"
          body:
            text/plain:
        500:
          description: "Internal server error"
          body:
            text/plain:
              example: "Internal server error, contact administrator"