BearND has uploaded a new change for review. (
https://gerrit.wikimedia.org/r/376139 )
Change subject: Add swagger spec for summary endpoint
......................................................................
Add swagger spec for summary endpoint
Bug: T174808
Change-Id: I976a2997507240dd162196e6f1ba86e171d9e98b
---
M spec.yaml
1 file changed, 124 insertions(+), 0 deletions(-)
git pull ssh://gerrit.wikimedia.org:29418/mediawiki/services/mobileapps
refs/changes/39/376139/1
diff --git a/spec.yaml b/spec.yaml
index 164553d..c68b319 100644
--- a/spec.yaml
+++ b/spec.yaml
@@ -605,6 +605,65 @@
body: /.+/
# from routes/mobile-sections.js
+ /{domain}/v1/page/summary/{title}/{revision}:
+ get:
+ tags:
+ - Page content
+ summary: Get a text extract of a page.
+ description: |
+ The summary response includes an extract of the first paragraph the
page in plain text
+ and HTML as well as a type of page. This is useful for page previews.
+
+ Stability:
[unstable](https://www.mediawiki.org/wiki/API_versioning#Unstable)
+ produces:
+ - application/json; charset=utf-8;
profile="https://www.mediawiki.org/wiki/Specs/Summary/1.2.0";
+ parameters:
+ - name: title
+ in: path
+ description: "Page title. Use underscores instead of spaces.
Example: `Main_Page`."
+ type: string
+ required: true
+ - name: revision
+ in: path
+ description: "Revision of page content"
+ type: integer
+ required: false
+ responses:
+ '200':
+ description: The summary for the given page
+ schema:
+ $ref: '#/definitions/summary'
+ headers:
+ ETag:
+ description: >
+ Syntax: "{revision}/{tid}".
+ Example: "701384379/154d7bca-c264-11e5-8c2f-1b51b33b59fc"
+ '404':
+ description: Unknown page title
+ schema:
+ $ref: '#/definitions/problem'
+ default:
+ description: Error
+ schema:
+ $ref: '#/definitions/problem'
+ x-amples:
+ - title: Get summary for Barack Obama
+ request:
+ params:
+ domain: en.wikipedia.org
+ title: Barack_Obama
+ response:
+ status: 200
+ headers:
+ etag: /.+/
+ content-type: /^application\/json/
+ body:
+ type: standard
+ revision: /.+/
+ extract: /.+/
+ extract_html: /.+/
+
+ # from routes/mobile-sections.js
/{domain}/v1/page/mobile-sections/{title}:
get:
tags:
@@ -742,6 +801,71 @@
- width
- height
+ # see also RB v1/common_schemas.yaml
+ summary:
+ type: object
+ properties:
+# title:
+# type: string
+# description: The page title
+# displaytitle:
+# type: string
+# description: The page title how it should be shown to the user
+# pageid:
+# type: integer
+# description: The page ID
+ type:
+ type: string
+ description: Type of page summary
+ enum:
+ - standard
+ revision:
+ type: string
+ description: The revision of the page when the summary was produced
+ #timestamp:
+ # type: string
+ # format: date-time
+ # description: The ISO timestamp of a page revision
+ extract:
+ type: string
+ description: First several sentences of an article in plain text
+ extract_html:
+ type: string
+ description: First several sentences of an article in simple HTML
format
+# thumbnail:
+# $ref: '#/definitions/thumbnail'
+# originalimage:
+# $ref: '#/definitions/originalimage'
+# lang:
+# type: string
+# description: The page language code
+# example: en
+# dir:
+# type: string
+# description: The page language direction code
+# example: ltr
+# timestamp:
+# type: string
+# description: The time when the page was last editted in the [ISO
8601](https://en.wikipedia.org/wiki/ISO_8601) format
+# example: '1970-01-01T00:00:00.000Z'
+# description:
+# type: string
+# description: Wikidata description for the page
+# example: American poet
+# coordinates:
+# type: object
+# description: The coordinates of the item
+# properties:
+# lat:
+# type: number
+# description: The latitude
+# lon:
+# type: number
+# description: The longitude
+# requiredProperties: [ 'lat', 'lon' ]
+# required: ['title', 'extract', 'lang', 'dir']
+ required: ['type', 'revision', 'extract', 'extract_html']
+
dated_pageview:
type: object
date:
--
To view, visit https://gerrit.wikimedia.org/r/376139
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings
Gerrit-MessageType: newchange
Gerrit-Change-Id: I976a2997507240dd162196e6f1ba86e171d9e98b
Gerrit-PatchSet: 1
Gerrit-Project: mediawiki/services/mobileapps
Gerrit-Branch: master
Gerrit-Owner: BearND <bsitzm...@wikimedia.org>
_______________________________________________
MediaWiki-commits mailing list
MediaWiki-commits@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
