diff --git a/docs/swagger/paths/health.json b/docs/swagger/paths/health.json index 60d96ccc..c9cb300f 100644 --- a/docs/swagger/paths/health.json +++ b/docs/swagger/paths/health.json @@ -13,16 +13,14 @@ "application/json": { "schema": { "$ref": "../definitions/Health.json" - } - } - }, - "examples": { - "application/json": { - "status": "pass", - "version": "1.16.0", - "links": { - "about": "https://shlink.io", - "project": "https://github.com/shlinkio/shlink" + }, + "example": { + "status": "pass", + "version": "2.10.0", + "links": { + "about": "https://shlink.io", + "project": "https://github.com/shlinkio/shlink" + } } } } @@ -33,16 +31,14 @@ "application/json": { "schema": { "$ref": "../definitions/Health.json" - } - } - }, - "examples": { - "application/json": { - "status": "fail", - "version": "1.16.0", - "links": { - "about": "https://shlink.io", - "project": "https://github.com/shlinkio/shlink" + }, + "example": { + "status": "fail", + "version": "2.10.0", + "links": { + "about": "https://shlink.io", + "project": "https://github.com/shlinkio/shlink" + } } } } diff --git a/docs/swagger/paths/v1_short-urls.json b/docs/swagger/paths/v1_short-urls.json index a4643058..ecef0285 100644 --- a/docs/swagger/paths/v1_short-urls.json +++ b/docs/swagger/paths/v1_short-urls.json @@ -117,73 +117,71 @@ } } } - } - } - }, - "examples": { - "application/json": { - "shortUrls": { - "data": [ - { - "shortCode": "12C18", - "shortUrl": "https://doma.in/12C18", - "longUrl": "https://store.steampowered.com", - "dateCreated": "2016-08-21T20:34:16+02:00", - "visitsCount": 328, - "tags": [ - "games", - "tech" - ], - "meta": { - "validSince": "2017-01-21T00:00:00+02:00", - "validUntil": null, - "maxVisits": 100 + }, + "example": { + "shortUrls": { + "data": [ + { + "shortCode": "12C18", + "shortUrl": "https://doma.in/12C18", + "longUrl": "https://store.steampowered.com", + "dateCreated": "2016-08-21T20:34:16+02:00", + "visitsCount": 328, + "tags": [ + "games", + "tech" + ], + "meta": { + "validSince": "2017-01-21T00:00:00+02:00", + "validUntil": null, + "maxVisits": 100 + }, + "domain": null, + "title": "Welcome to Steam", + "crawlable": false }, - "domain": null, - "title": "Welcome to Steam", - "crawlable": false - }, - { - "shortCode": "12Kb3", - "shortUrl": "https://doma.in/12Kb3", - "longUrl": "https://shlink.io", - "dateCreated": "2016-05-01T20:34:16+02:00", - "visitsCount": 1029, - "tags": [ - "shlink" - ], - "meta": { - "validSince": null, - "validUntil": null, - "maxVisits": null + { + "shortCode": "12Kb3", + "shortUrl": "https://doma.in/12Kb3", + "longUrl": "https://shlink.io", + "dateCreated": "2016-05-01T20:34:16+02:00", + "visitsCount": 1029, + "tags": [ + "shlink" + ], + "meta": { + "validSince": null, + "validUntil": null, + "maxVisits": null + }, + "domain": null, + "title": null, + "crawlable": false }, - "domain": null, - "title": null, - "crawlable": false - }, - { - "shortCode": "123bA", - "shortUrl": "https://example.com/123bA", - "longUrl": "https://www.google.com", - "dateCreated": "2015-10-01T20:34:16+02:00", - "visitsCount": 25, - "tags": [], - "meta": { - "validSince": "2017-01-21T00:00:00+02:00", - "validUntil": null, - "maxVisits": null - }, - "domain": "example.com", - "title": null, - "crawlable": false + { + "shortCode": "123bA", + "shortUrl": "https://example.com/123bA", + "longUrl": "https://www.google.com", + "dateCreated": "2015-10-01T20:34:16+02:00", + "visitsCount": 25, + "tags": [], + "meta": { + "validSince": "2017-01-21T00:00:00+02:00", + "validUntil": null, + "maxVisits": null + }, + "domain": "example.com", + "title": null, + "crawlable": false + } + ], + "pagination": { + "currentPage": 5, + "pagesCount": 12, + "itemsPerPage": 10, + "itemsInCurrentPage": 10, + "totalItems": 115 } - ], - "pagination": { - "currentPage": 5, - "pagesCount": 12, - "itemsPerPage": 10, - "itemsInCurrentPage": 10, - "totalItems": 115 } } } @@ -267,28 +265,26 @@ "application/json": { "schema": { "$ref": "../definitions/ShortUrl.json" - } - } - }, - "examples": { - "application/json": { - "shortCode": "12C18", - "shortUrl": "https://doma.in/12C18", - "longUrl": "https://store.steampowered.com", - "dateCreated": "2016-08-21T20:34:16+02:00", - "visitsCount": 0, - "tags": [ - "games", - "tech" - ], - "meta": { - "validSince": "2017-01-21T00:00:00+02:00", - "validUntil": null, - "maxVisits": 500 }, - "domain": null, - "title": null, - "crawlable": false + "example": { + "shortCode": "12C18", + "shortUrl": "https://doma.in/12C18", + "longUrl": "https://store.steampowered.com", + "dateCreated": "2016-08-21T20:34:16+02:00", + "visitsCount": 0, + "tags": [ + "games", + "tech" + ], + "meta": { + "validSince": "2017-01-21T00:00:00+02:00", + "validUntil": null, + "maxVisits": 500 + }, + "domain": null, + "title": null, + "crawlable": false + } } } }, @@ -330,6 +326,13 @@ } } ] + }, + "example": { + "title": "Invalid URL", + "type": "INVALID_URL", + "detail": "Provided URL foo is invalid. Try with a different one.", + "status": 400, + "url": "https://invalid-url.com" } } } diff --git a/docs/swagger/paths/v1_short-urls_shorten.json b/docs/swagger/paths/v1_short-urls_shorten.json index 90c3eda5..e1d98129 100644 --- a/docs/swagger/paths/v1_short-urls_shorten.json +++ b/docs/swagger/paths/v1_short-urls_shorten.json @@ -49,35 +49,33 @@ "application/json": { "schema": { "$ref": "../definitions/ShortUrl.json" + }, + "example": { + "longUrl": "https://github.com/shlinkio/shlink", + "shortUrl": "https://doma.in/abc123", + "shortCode": "abc123", + "dateCreated": "2016-08-21T20:34:16+02:00", + "visitsCount": 0, + "tags": [ + "games", + "tech" + ], + "meta": { + "validSince": "2017-01-21T00:00:00+02:00", + "validUntil": null, + "maxVisits": 100 + }, + "domain": null, + "title": null, + "crawlable": false } }, "text/plain": { "schema": { "type": "string" - } - } - }, - "examples": { - "application/json": { - "longUrl": "https://github.com/shlinkio/shlink", - "shortUrl": "https://doma.in/abc123", - "shortCode": "abc123", - "dateCreated": "2016-08-21T20:34:16+02:00", - "visitsCount": 0, - "tags": [ - "games", - "tech" - ], - "meta": { - "validSince": "2017-01-21T00:00:00+02:00", - "validUntil": null, - "maxVisits": 100 }, - "domain": null, - "title": null, - "crawlable": false - }, - "text/plain": "https://doma.in/abc123" + "example": "https://doma.in/abc123" + } } }, "400": { @@ -86,23 +84,21 @@ "application/problem+json": { "schema": { "$ref": "../definitions/Error.json" + }, + "example": { + "title": "Invalid URL", + "type": "INVALID_URL", + "detail": "Provided URL foo is invalid. Try with a different one.", + "status": 400, + "url": "https://invalid-url.com" } }, "text/plain": { "schema": { "type": "string" - } + }, + "example": "INVALID_URL" } - }, - "examples": { - "application/problem+json": { - "title": "Invalid URL", - "type": "INVALID_URL", - "detail": "Provided URL foo is invalid. Try with a different one.", - "status": 400, - "url": "https://invalid-url.com" - }, - "text/plain": "INVALID_URL" } }, "500": { @@ -118,13 +114,6 @@ "type": "string" } } - }, - "examples": { - "application/problem+json": { - "error": "INTERNAL_SERVER_ERROR", - "message": "Unexpected error occurred" - }, - "text/plain": "INTERNAL_SERVER_ERROR" } } } diff --git a/docs/swagger/paths/v1_short-urls_{shortCode}.json b/docs/swagger/paths/v1_short-urls_{shortCode}.json index e37df965..6fac0745 100644 --- a/docs/swagger/paths/v1_short-urls_{shortCode}.json +++ b/docs/swagger/paths/v1_short-urls_{shortCode}.json @@ -35,27 +35,25 @@ "application/json": { "schema": { "$ref": "../definitions/ShortUrl.json" - } - } - }, - "examples": { - "application/json": { - "shortCode": "12Kb3", - "shortUrl": "https://doma.in/12Kb3", - "longUrl": "https://shlink.io", - "dateCreated": "2016-05-01T20:34:16+02:00", - "visitsCount": 1029, - "tags": [ - "shlink" - ], - "meta": { - "validSince": "2017-01-21T00:00:00+02:00", - "validUntil": null, - "maxVisits": 100 }, - "domain": null, - "title": null, - "crawlable": false + "example": { + "shortCode": "12Kb3", + "shortUrl": "https://doma.in/12Kb3", + "longUrl": "https://shlink.io", + "dateCreated": "2016-05-01T20:34:16+02:00", + "visitsCount": 1029, + "tags": [ + "shlink" + ], + "meta": { + "validSince": "2017-01-21T00:00:00+02:00", + "validUntil": null, + "maxVisits": 100 + }, + "domain": null, + "title": null, + "crawlable": false + } } } }, @@ -129,27 +127,25 @@ "application/json": { "schema": { "$ref": "../definitions/ShortUrl.json" - } - } - }, - "examples": { - "application/json": { - "shortCode": "12Kb3", - "shortUrl": "https://doma.in/12Kb3", - "longUrl": "https://shlink.io", - "dateCreated": "2016-05-01T20:34:16+02:00", - "visitsCount": 1029, - "tags": [ - "shlink" - ], - "meta": { - "validSince": "2017-01-21T00:00:00+02:00", - "validUntil": null, - "maxVisits": 100 }, - "domain": null, - "title": "Shlink - The URL shortener", - "crawlable": false + "example": { + "shortCode": "12Kb3", + "shortUrl": "https://doma.in/12Kb3", + "longUrl": "https://shlink.io", + "dateCreated": "2016-05-01T20:34:16+02:00", + "visitsCount": 1029, + "tags": [ + "shlink" + ], + "meta": { + "validSince": "2017-01-21T00:00:00+02:00", + "validUntil": null, + "maxVisits": 100 + }, + "domain": null, + "title": "Shlink - The URL shortener", + "crawlable": false + } } } }, @@ -247,17 +243,39 @@ "content": { "application/problem+json": { "schema": { - "$ref": "../definitions/Error.json" + "allOf": [ + { + "$ref": "../definitions/Error.json" + }, + { + "type": "object", + "required": ["shortCode", "threshold"], + "properties": { + "shortCode": { + "type": "string", + "description": "The short code with which we tried to find the short URL to delete" + }, + "domain": { + "type": "string", + "description": "The domain with which we tried to find the short URL to delete" + }, + "threshold": { + "type": "number", + "description": "The amount of visits currently configured as threshold to allow deleting short UYRLs or not" + } + } + } + ] + }, + "example": { + "title": "Cannot delete short URL", + "type": "INVALID_SHORTCODE_DELETION", + "detail": "Impossible to delete short URL with short code \"abc123\", since it has more than \"15\" visits.", + "status": 422, + "shortCode": "abc123", + "threshold": 15 } } - }, - "examples": { - "application/problem+json": { - "title": "Cannot delete short URL", - "type": "INVALID_SHORTCODE_DELETION", - "detail": "It is not possible to delete URL with short code \"abc123\" because it has reached more than \"15\" visits.", - "status": 422 - } } }, "404": { diff --git a/docs/swagger/paths/v1_short-urls_{shortCode}_tags.json b/docs/swagger/paths/v1_short-urls_{shortCode}_tags.json index 6ea642b0..3cad48ad 100644 --- a/docs/swagger/paths/v1_short-urls_{shortCode}_tags.json +++ b/docs/swagger/paths/v1_short-urls_{shortCode}_tags.json @@ -69,14 +69,6 @@ } } } - }, - "examples": { - "application/json": { - "tags": [ - "games", - "tech" - ] - } } }, "400": { diff --git a/docs/swagger/paths/v1_short-urls_{shortCode}_visits.json b/docs/swagger/paths/v1_short-urls_{shortCode}_visits.json index e5bbbe86..9fbe5433 100644 --- a/docs/swagger/paths/v1_short-urls_{shortCode}_visits.json +++ b/docs/swagger/paths/v1_short-urls_{shortCode}_visits.json @@ -97,49 +97,47 @@ } } } - } - } - }, - "examples": { - "application/json": { - "visits": { - "data": [ - { - "referer": "https://twitter.com", - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0 Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0", - "visitLocation": null, - "potentialBot": false - }, - { - "referer": "https://t.co", - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36", - "visitLocation": { - "cityName": "Cupertino", - "countryCode": "US", - "countryName": "United States", - "latitude": 37.3042, - "longitude": -122.0946, - "regionName": "California", - "timezone": "America/Los_Angeles" + }, + "example": { + "visits": { + "data": [ + { + "referer": "https://twitter.com", + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0 Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0", + "visitLocation": null, + "potentialBot": false }, - "potentialBot": false - }, - { - "referer": null, - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "some_web_crawler/1.4", - "visitLocation": null, - "potentialBot": true + { + "referer": "https://t.co", + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36", + "visitLocation": { + "cityName": "Cupertino", + "countryCode": "US", + "countryName": "United States", + "latitude": 37.3042, + "longitude": -122.0946, + "regionName": "California", + "timezone": "America/Los_Angeles" + }, + "potentialBot": false + }, + { + "referer": null, + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "some_web_crawler/1.4", + "visitLocation": null, + "potentialBot": true + } + ], + "pagination": { + "currentPage": 5, + "pagesCount": 12, + "itemsPerPage": 10, + "itemsInCurrentPage": 10, + "totalItems": 115 } - ], - "pagination": { - "currentPage": 5, - "pagesCount": 12, - "itemsPerPage": 10, - "itemsInCurrentPage": 10, - "totalItems": 115 } } } diff --git a/docs/swagger/paths/v1_tags.json b/docs/swagger/paths/v1_tags.json index 8c3ada73..d33d2b51 100644 --- a/docs/swagger/paths/v1_tags.json +++ b/docs/swagger/paths/v1_tags.json @@ -57,18 +57,42 @@ } } } - } - } - }, - "examples": { - "application/json": { - "tags": { - "data": [ - "games", - "php", - "shlink", - "tech" - ] + }, + "examples": { + "Without stats": { + "value": { + "tags": { + "data": [ + "games", + "php", + "shlink", + "tech" + ] + } + } + }, + "With stats": { + "value": { + "tags": { + "data": [ + "games", + "shlink" + ], + "stats": [ + { + "tag": "games", + "shortUrlsCount": 10, + "visitsCount": 521 + }, + { + "tag": "shlink", + "shortUrlsCount": 7, + "visitsCount": 1087 + } + ] + } + } + } } } } @@ -149,18 +173,6 @@ } } } - }, - "examples": { - "application/json": { - "tags": { - "data": [ - "games", - "php", - "shlink", - "tech" - ] - } - } } }, "500": { diff --git a/docs/swagger/paths/v2_domains.json b/docs/swagger/paths/v2_domains.json index d92677c1..da41ac3f 100644 --- a/docs/swagger/paths/v2_domains.json +++ b/docs/swagger/paths/v2_domains.json @@ -53,45 +53,43 @@ } } } - } - } - }, - "examples": { - "application/json": { - "domains": { - "data": [ - { - "domain": "example.com", - "isDefault": true, - "redirects": { - "baseUrlRedirect": "https://example.com/my-landing-page", - "regular404Redirect": null, - "invalidShortUrlRedirect": "https://example.com/invalid-url" - } - }, - { - "domain": "aaa.com", - "isDefault": false, - "redirects": { - "baseUrlRedirect": null, - "regular404Redirect": null, - "invalidShortUrlRedirect": null - } - }, - { - "domain": "bbb.com", - "isDefault": false, - "redirects": { - "baseUrlRedirect": null, - "regular404Redirect": null, - "invalidShortUrlRedirect": "https://example.com/invalid-url" + }, + "example": { + "domains": { + "data": [ + { + "domain": "example.com", + "isDefault": true, + "redirects": { + "baseUrlRedirect": "https://example.com/my-landing-page", + "regular404Redirect": null, + "invalidShortUrlRedirect": "https://example.com/invalid-url" + } + }, + { + "domain": "aaa.com", + "isDefault": false, + "redirects": { + "baseUrlRedirect": null, + "regular404Redirect": null, + "invalidShortUrlRedirect": null + } + }, + { + "domain": "bbb.com", + "isDefault": false, + "redirects": { + "baseUrlRedirect": null, + "regular404Redirect": null, + "invalidShortUrlRedirect": "https://example.com/invalid-url" + } } + ], + "defaultRedirects": { + "baseUrlRedirect": "https://somewhere.com", + "regular404Redirect": null, + "invalidShortUrlRedirect": null } - ], - "defaultRedirects": { - "baseUrlRedirect": "https://somewhere.com", - "regular404Redirect": null, - "invalidShortUrlRedirect": null } } } diff --git a/docs/swagger/paths/v2_domains_redirects.json b/docs/swagger/paths/v2_domains_redirects.json index 031e1d43..5eee7cd6 100644 --- a/docs/swagger/paths/v2_domains_redirects.json +++ b/docs/swagger/paths/v2_domains_redirects.json @@ -55,15 +55,13 @@ "$ref": "../definitions/NotFoundRedirects.json" } ] + }, + "example": { + "baseUrlRedirect": "https://example.com/my-landing-page", + "regular404Redirect": null, + "invalidShortUrlRedirect": "https://example.com/invalid-url" } } - }, - "examples": { - "application/json": { - "baseUrlRedirect": "https://example.com/my-landing-page", - "regular404Redirect": null, - "invalidShortUrlRedirect": "https://example.com/invalid-url" - } } }, "400": { diff --git a/docs/swagger/paths/v2_mercure-info.json b/docs/swagger/paths/v2_mercure-info.json index 24f7fb5f..b21322c3 100644 --- a/docs/swagger/paths/v2_mercure-info.json +++ b/docs/swagger/paths/v2_mercure-info.json @@ -23,15 +23,13 @@ "application/json": { "schema": { "$ref": "../definitions/MercureInfo.json" + }, + "example": { + "mercureHubUrl": "https://example.com/.well-known/mercure", + "jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJTaGxpbmsiLCJpYXQiOjE1ODY2ODY3MzIsImV4cCI6MTU4Njk0NTkzMiwibWVyY3VyZSI6eyJzdWJzY3JpYmUiOltdfX0.P-519lgU7dFz0bbNlRG1CXyqugGbaHon4kw6fu4QBdQ", + "jwtExpiration": "2020-04-15T12:18:52+02:00" } } - }, - "examples": { - "application/json": { - "mercureHubUrl": "https://example.com/.well-known/mercure", - "jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJTaGxpbmsiLCJpYXQiOjE1ODY2ODY3MzIsImV4cCI6MTU4Njk0NTkzMiwibWVyY3VyZSI6eyJzdWJzY3JpYmUiOltdfX0.P-519lgU7dFz0bbNlRG1CXyqugGbaHon4kw6fu4QBdQ", - "jwtExpiration": "2020-04-15T12:18:52+02:00" - } } }, "501": { @@ -40,16 +38,14 @@ "application/problem+json": { "schema": { "$ref": "../definitions/Error.json" + }, + "example": { + "title": "Mercure integration not configured", + "type": "MERCURE_NOT_CONFIGURED", + "detail": "This Shlink instance is not integrated with a mercure hub.", + "status": 501 } } - }, - "examples": { - "application/json": { - "title": "Mercure integration not configured", - "type": "MERCURE_NOT_CONFIGURED", - "detail": "This Shlink instance is not integrated with a mercure hub.", - "status": 501 - } } }, "500": { diff --git a/docs/swagger/paths/v2_tags_{tag}_visits.json b/docs/swagger/paths/v2_tags_{tag}_visits.json index df1242f6..a6701850 100644 --- a/docs/swagger/paths/v2_tags_{tag}_visits.json +++ b/docs/swagger/paths/v2_tags_{tag}_visits.json @@ -94,49 +94,47 @@ } } } - } - } - }, - "examples": { - "application/json": { - "visits": { - "data": [ - { - "referer": "https://twitter.com", - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0 Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0", - "visitLocation": null, - "potentialBot": false - }, - { - "referer": "https://t.co", - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36", - "visitLocation": { - "cityName": "Cupertino", - "countryCode": "US", - "countryName": "United States", - "latitude": 37.3042, - "longitude": -122.0946, - "regionName": "California", - "timezone": "America/Los_Angeles" + }, + "example": { + "visits": { + "data": [ + { + "referer": "https://twitter.com", + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0 Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0", + "visitLocation": null, + "potentialBot": false }, - "potentialBot": false - }, - { - "referer": null, - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "some_web_crawler/1.4", - "visitLocation": null, - "potentialBot": true + { + "referer": "https://t.co", + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36", + "visitLocation": { + "cityName": "Cupertino", + "countryCode": "US", + "countryName": "United States", + "latitude": 37.3042, + "longitude": -122.0946, + "regionName": "California", + "timezone": "America/Los_Angeles" + }, + "potentialBot": false + }, + { + "referer": null, + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "some_web_crawler/1.4", + "visitLocation": null, + "potentialBot": true + } + ], + "pagination": { + "currentPage": 5, + "pagesCount": 12, + "itemsPerPage": 10, + "itemsInCurrentPage": 10, + "totalItems": 115 } - ], - "pagination": { - "currentPage": 5, - "pagesCount": 12, - "itemsPerPage": 10, - "itemsInCurrentPage": 10, - "totalItems": 115 } } } diff --git a/docs/swagger/paths/v2_visits.json b/docs/swagger/paths/v2_visits.json index 3c712b1f..765d5eec 100644 --- a/docs/swagger/paths/v2_visits.json +++ b/docs/swagger/paths/v2_visits.json @@ -28,14 +28,12 @@ "$ref": "../definitions/VisitStats.json" } } - } - } - }, - "examples": { - "application/json": { - "visits": { - "visitsCount": 1569874, - "orphanVisitsCount": 71345 + }, + "example": { + "visits": { + "visitsCount": 1569874, + "orphanVisitsCount": 71345 + } } } } diff --git a/docs/swagger/paths/v2_visits_orphan.json b/docs/swagger/paths/v2_visits_orphan.json index ce52b197..e2a10285 100644 --- a/docs/swagger/paths/v2_visits_orphan.json +++ b/docs/swagger/paths/v2_visits_orphan.json @@ -85,55 +85,53 @@ } } } - } - } - }, - "examples": { - "application/json": { - "visits": { - "data": [ - { - "referer": "https://twitter.com", - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0 Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0", - "visitLocation": null, - "potentialBot": false, - "visitedUrl": "https://doma.in", - "type": "base_url" - }, - { - "referer": "https://t.co", - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36", - "visitLocation": { - "cityName": "Cupertino", - "countryCode": "US", - "countryName": "United States", - "latitude": 37.3042, - "longitude": -122.0946, - "regionName": "California", - "timezone": "America/Los_Angeles" + }, + "example": { + "visits": { + "data": [ + { + "referer": "https://twitter.com", + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0 Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0", + "visitLocation": null, + "potentialBot": false, + "visitedUrl": "https://doma.in", + "type": "base_url" }, - "potentialBot": false, - "visitedUrl": "https://doma.in/foo", - "type": "invalid_short_url" - }, - { - "referer": null, - "date": "2015-08-20T05:05:03+04:00", - "userAgent": "some_web_crawler/1.4", - "visitLocation": null, - "potentialBot": true, - "visitedUrl": "https://doma.in/foo/bar/baz", - "type": "regular_404" + { + "referer": "https://t.co", + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36", + "visitLocation": { + "cityName": "Cupertino", + "countryCode": "US", + "countryName": "United States", + "latitude": 37.3042, + "longitude": -122.0946, + "regionName": "California", + "timezone": "America/Los_Angeles" + }, + "potentialBot": false, + "visitedUrl": "https://doma.in/foo", + "type": "invalid_short_url" + }, + { + "referer": null, + "date": "2015-08-20T05:05:03+04:00", + "userAgent": "some_web_crawler/1.4", + "visitLocation": null, + "potentialBot": true, + "visitedUrl": "https://doma.in/foo/bar/baz", + "type": "regular_404" + } + ], + "pagination": { + "currentPage": 5, + "pagesCount": 12, + "itemsPerPage": 10, + "itemsInCurrentPage": 10, + "totalItems": 115 } - ], - "pagination": { - "currentPage": 5, - "pagesCount": 12, - "itemsPerPage": 10, - "itemsInCurrentPage": 10, - "totalItems": 115 } } }