Changed documented paths on short URL-related endpoints from short-code to short-url

This commit is contained in:
Alejandro Celaya 2018-09-20 20:52:27 +02:00
parent 80fe3a73e2
commit d53a3222d0
8 changed files with 44 additions and 14 deletions

View file

@ -1,5 +1,6 @@
{
"post": {
"operationId": "authenticate",
"tags": [
"Authentication"
],

View file

@ -1,7 +1,8 @@
{
"get": {
"operationId": "listShortUrls",
"tags": [
"ShortCodes"
"Short URLs"
],
"summary": "List short URLs",
"description": "Returns the list of short codes",
@ -142,8 +143,9 @@
},
"post": {
"operationId": "createShortUrl",
"tags": [
"ShortCodes"
"Short URLs"
],
"summary": "Create short URL",
"description": "Creates a new short code",

View file

@ -1,7 +1,8 @@
{
"get": {
"operationId": "shortenUrl",
"tags": [
"ShortCodes"
"Short URLs"
],
"summary": "Create a short URL",
"description": "Creates a short URL in a single API call. Useful for third party integrations",

View file

@ -1,7 +1,8 @@
{
"get": {
"operationId": "getShortUrl",
"tags": [
"ShortCodes"
"Short URLs"
],
"summary": "Parse short code",
"description": "Get the long URL behind a short code.",
@ -78,8 +79,9 @@
},
"put": {
"operationId": "editShortUrl",
"tags": [
"ShortCodes"
"Short URLs"
],
"summary": "Edit short code",
"description": "Update certain meta arguments from an existing short URL.",
@ -162,8 +164,9 @@
},
"delete": {
"operationId": "deleteShortUrl",
"tags": [
"ShortCodes"
"Short URLs"
],
"summary": "Delete short code",
"description": "Deletes the short URL for provided short code.",

View file

@ -1,8 +1,8 @@
{
"put": {
"operationId": "editShortUrlTags",
"tags": [
"ShortCodes",
"Tags"
"Short URLs"
],
"summary": "Edit tags on short URL",
"description": "Edit the tags on provided short code.",

View file

@ -1,7 +1,7 @@
{
"get": {
"operationId": "getShortUrlVisits",
"tags": [
"ShortCodes",
"Visits"
],
"summary": "List visits for short URL",

View file

@ -1,5 +1,6 @@
{
"get": {
"operationId": "listTags",
"tags": [
"Tags"
],
@ -60,6 +61,7 @@
},
"post": {
"operationId": "createTags",
"tags": [
"Tags"
],
@ -143,6 +145,7 @@
},
"put": {
"operationId": "renameTag",
"tags": [
"Tags"
],
@ -216,6 +219,7 @@
},
"delete": {
"operationId": "deleteTags",
"tags": [
"Tags"
],

View file

@ -32,21 +32,40 @@
}
},
"tags": [
{
"name": "Authentication",
"description": "Authentication-related endpoints"
},
{
"name": "Short URLs",
"description": "Operations that can be performed on short URLs"
},
{
"name": "Tags",
"description": "Let you handle the list of available tags"
},
{
"name": "Visits",
"description": "Operations to manage visits on short URLs"
}
],
"paths": {
"/v1/authenticate": {
"$ref": "paths/v1_authenticate.json"
},
"/v1/short-codes": {
"/v1/short-urls": {
"$ref": "paths/v1_short-codes.json"
},
"/v1/short-codes/shorten": {
"/v1/short-urls/shorten": {
"$ref": "paths/v1_short-codes_shorten.json"
},
"/v1/short-codes/{shortCode}": {
"/v1/short-urls/{shortCode}": {
"$ref": "paths/v1_short-codes_{shortCode}.json"
},
"/v1/short-codes/{shortCode}/tags": {
"/v1/short-urls/{shortCode}/tags": {
"$ref": "paths/v1_short-codes_{shortCode}_tags.json"
},
@ -54,7 +73,7 @@
"$ref": "paths/v1_tags.json"
},
"/v1/short-codes/{shortCode}/visits": {
"/v1/short-urls/{shortCode}/visits": {
"$ref": "paths/v1_short-codes_{shortCode}_visits.json"
}
}