summaryrefslogtreecommitdiffstats
path: root/fatcat-go/fatcat-openapi2.yml
diff options
context:
space:
mode:
Diffstat (limited to 'fatcat-go/fatcat-openapi2.yml')
-rw-r--r--fatcat-go/fatcat-openapi2.yml83
1 files changed, 83 insertions, 0 deletions
diff --git a/fatcat-go/fatcat-openapi2.yml b/fatcat-go/fatcat-openapi2.yml
new file mode 100644
index 00000000..56aed839
--- /dev/null
+++ b/fatcat-go/fatcat-openapi2.yml
@@ -0,0 +1,83 @@
+consumes:
+- application/json
+info:
+ description: A scalable, versioned, API-oriented catalog of bibliographic entities
+ and file metadata
+ title: fatcat
+ version: 0.1.0
+paths: {}
+produces:
+- application/json
+schemes:
+- http
+swagger: "2.0"
+
+definitions:
+ error:
+ type: object
+ required:
+ - message
+ properties:
+ message:
+ type: string
+ creator_entity:
+ type: object
+ required:
+ - ident
+ - state
+ properties:
+ state:
+ type: string
+ # actually enum of: (wip, active, redirect, deleted)
+ ident:
+ type: string
+ revision:
+ type: string
+ redirect:
+ type: string
+ name:
+ type: string
+ orcid:
+ type: string
+
+paths:
+ /creator:
+ post:
+ parameters:
+ - name: body
+ in: body
+ schema:
+ $ref: "#/definitions/creator_entity"
+ responses:
+ 201:
+ description: created
+ schema:
+ $ref: "#/definitions/creator_entity"
+ default:
+ description: generic error response
+ schema:
+ $ref: "#/definitions/error"
+ /creator/{id}:
+ parameters:
+ - name: id
+ in: path
+ type: string
+ required: true
+ get:
+ responses:
+ 200:
+ description: fetch a single creator by id
+ schema:
+ $ref: "#/definitions/creator_entity"
+ default:
+ description: generic error response
+ schema:
+ $ref: "#/definitions/error"
+# /creator/lookup:
+
+# /editgroup:
+# /editgroup/{id}:
+# /editgroup/{id}/accept:
+
+# /editor/{username}:
+# /editor/{username}/changelog: