aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2021-10-12 16:42:39 -0700
committerBryan Newbold <bnewbold@robocracy.org>2021-10-13 16:21:30 -0700
commitd9ff4bc8fe0a6daa39061fea7eb1830fd7b445bf (patch)
tree902b8fe5696ba2428813f6333ab11884bb89a9ec
parent249c6131621b9cdd83e98421cbd4f885c30abadb (diff)
downloadfatcat-d9ff4bc8fe0a6daa39061fea7eb1830fd7b445bf.tar.gz
fatcat-d9ff4bc8fe0a6daa39061fea7eb1830fd7b445bf.zip
schema: implement v0.4 tweaks, and bump version number
-rw-r--r--fatcat-openapi2.yml73
1 files changed, 71 insertions, 2 deletions
diff --git a/fatcat-openapi2.yml b/fatcat-openapi2.yml
index 450e4a52..67915dda 100644
--- a/fatcat-openapi2.yml
+++ b/fatcat-openapi2.yml
@@ -2,7 +2,7 @@
swagger: "2.0"
info:
title: fatcat
- version: 0.3.3
+ version: 0.4.0
description: |
Fatcat is a scalable, versioned, API-oriented catalog of bibliographic
entities and file metadata.
@@ -382,6 +382,10 @@ definitions:
type: string
description: "Type of container, eg 'journal' or 'proceedings'. See Guide for list of valid types."
example: "journal"
+ publication_status:
+ type: string
+ description: "Whether the container is active, discontinued, etc"
+ example: "active"
publisher:
type: string
description: |
@@ -392,6 +396,14 @@ definitions:
description: "Linking ISSN number (ISSN-L). Should be valid and registered with issn.org"
<<: *FATCATISSN
<<: *FATCATISSNEXAMPLE
+ issne:
+ description: "Electronic ISSN number (ISSN-E). Should be valid and registered with issn.org"
+ <<: *FATCATISSN
+ <<: *FATCATISSNEXAMPLE
+ issnp:
+ description: "Print ISSN number (ISSN-P). Should be valid and registered with issn.org"
+ <<: *FATCATISSN
+ <<: *FATCATISSNEXAMPLE
wikidata_qid:
type: string
example: "Q42812"
@@ -554,12 +566,15 @@ definitions:
sha256:
<<: *FATCATSHA256
<<: *FATCATSHA256EXAMPLE
+ mimetype:
+ type: string
+ example: "application/pdf"
extra:
type: object
additionalProperties: {}
description: |
Free-form additional metadata about this specific file in the set.
- Eg, `mimetype`. See guide for nomative (but unenforced) schema
+ Eg, `original_url`. See guide for nomative (but unenforced) schema
fields.
webcapture_entity:
type: object
@@ -908,6 +923,9 @@ definitions:
oai:
type: string
description: "OAI-PMH identifier; only used when an OAI-PMH record is the only authoritative metadata (eg, journal OAI-PMH feeds w/o DOIs)"
+ hdl:
+ type: string
+ description: "Handle identifier. Do not put DOIs in this field"
release_abstract:
type: object
properties:
@@ -1684,6 +1702,22 @@ paths:
- name: issnl
in: query
required: false
+ description: "Linking ISSN (ISSN-L); will be one of either ISSN-E or ISSN-P"
+ <<: *FATCATISSN
+ - name: issne
+ in: query
+ required: false
+ description: "Electronic ISSN (ISSN-L)"
+ <<: *FATCATISSN
+ - name: issnp
+ in: query
+ required: false
+ description: "Print ISSN (ISSN-P)"
+ <<: *FATCATISSN
+ - name: issn
+ in: query
+ required: false
+ description: "Any of ISSN-L, ISSN-E, or ISSN-P"
<<: *FATCATISSN
- name: wikidata_qid
in: query
@@ -3118,6 +3152,10 @@ paths:
in: query
type: string
required: false
+ - name: hdl
+ in: query
+ type: string
+ required: false
- name: expand
in: query
type: string
@@ -3615,6 +3653,37 @@ paths:
schema:
$ref: "#/definitions/error_response"
<<: *AUTHRESPONSES
+ /editor/lookup:
+ get:
+ operationId: "lookup_editor"
+ tags: # TAGLINE
+ - editors # TAGLINE
+ description: |
+ Fetches editor by, eg, username.
+
+ One (and only one) lookup identifier should be specified per request.
+ parameters:
+ - name: username
+ in: query
+ required: false
+ type: string
+ responses:
+ 200:
+ description: Found
+ schema:
+ $ref: "#/definitions/editor"
+ 400:
+ description: Bad Request
+ schema:
+ $ref: "#/definitions/error_response"
+ 404:
+ description: Not Found
+ schema:
+ $ref: "#/definitions/error_response"
+ 500:
+ description: Generic Error
+ schema:
+ $ref: "#/definitions/error_response"
/editgroup:
post: