summaryrefslogtreecommitdiffstats
path: root/fatcat-go/fatcat-openapi2.yml
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2018-05-09 18:31:21 -0700
committerBryan Newbold <bnewbold@robocracy.org>2018-05-09 18:31:21 -0700
commitf36836a6399022338ec02849da42f6f518c7a54f (patch)
treefc9005e6723ad124acf3e5717280bf2ee77c4813 /fatcat-go/fatcat-openapi2.yml
parentcc57215fc1c5e56e8c745ea76135e2d170f585c7 (diff)
downloadfatcat-f36836a6399022338ec02849da42f6f518c7a54f.tar.gz
fatcat-f36836a6399022338ec02849da42f6f518c7a54f.zip
first swagger generation
Diffstat (limited to 'fatcat-go/fatcat-openapi2.yml')
-rw-r--r--fatcat-go/fatcat-openapi2.yml24
1 files changed, 17 insertions, 7 deletions
diff --git a/fatcat-go/fatcat-openapi2.yml b/fatcat-go/fatcat-openapi2.yml
index 56aed839..2f635697 100644
--- a/fatcat-go/fatcat-openapi2.yml
+++ b/fatcat-go/fatcat-openapi2.yml
@@ -1,16 +1,22 @@
-consumes:
-- application/json
+---
+swagger: "2.0"
info:
+ title: fatcat
description: A scalable, versioned, API-oriented catalog of bibliographic entities
and file metadata
- title: fatcat
version: 0.1.0
-paths: {}
+schemes: [http, https]
+basePath: /v0
+host: api.fatcat.wiki
+consumes:
+- application/json
produces:
- application/json
-schemes:
-- http
-swagger: "2.0"
+
+# TODO: try to make this work:
+#x-entity-props: &ENTITYPROPS
+#<<: *ENTITYPROPS
+
definitions:
error:
@@ -31,14 +37,18 @@ definitions:
# actually enum of: (wip, active, redirect, deleted)
ident:
type: string
+ # format: uuid
revision:
type: string
+ # integer
redirect:
type: string
+ # format: uuid
name:
type: string
orcid:
type: string
+ # format: custom
paths:
/creator: