1010 license :
1111 name : ' All rights reserved'
1212 url : ' https://urlr.me/en/legal-notice'
13- version : ' 0.2 '
13+ version : ' 0.3 '
1414servers :
1515 -
1616 url : ' https://urlr.me/api'
@@ -31,8 +31,10 @@ paths:
3131 - ' username, password'
3232 properties :
3333 username :
34+ description : Email
3435 type : string
3536 password :
37+ description : Password
3638 type : string
3739 type : object
3840 responses :
@@ -57,10 +59,10 @@ paths:
5759 post :
5860 tags :
5961 - Link
60- summary : ' Reduce a link'
62+ summary : ' Shorten a link'
6163 operationId : reduceLink
6264 requestBody :
63- description : ' Infos of the link to reduce '
65+ description : ' Info of the link to shorten '
6466 content :
6567 application/json :
6668 schema :
@@ -69,23 +71,23 @@ paths:
6971 - team
7072 properties :
7173 url :
72- description : ' The url to reduce '
74+ description : ' URL to shorten '
7375 type : string
7476 team :
75- description : ' Team id (displayed on dashboard)'
77+ description : ' Team ID (displayed on dashboard)'
7678 type : string
7779 folder :
78- description : ' Folder id (displayed on dashboard)'
80+ description : ' Folder ID (displayed on dashboard)'
7981 type : string
8082 code :
81- description : ' Custom code'
83+ description : ' Custom short code'
8284 type : string
8385 pattern : ' ^[a-zA-Z0-9!-]{3,50}$'
8486 label :
85- description : ' Link label '
87+ description : Label
8688 type : string
8789 password :
88- description : ' Link password '
90+ description : Password
8991 type : string
9092 expired_at :
9193 description : ' Expiration date'
@@ -98,12 +100,12 @@ paths:
98100 application/json :
99101 schema :
100102 properties :
101- url : { description: 'Input url to reduce ', type: string }
103+ url : { description: 'Original URL ', type: string }
102104 expired_at : { description: 'Expiration date', type: string }
103- team : { description: 'Team id (displayed on dashboard)', type: integer }
104- folder : { description: 'Folder id (displayed on dashboard)', type: integer }
105- url_code : { type: string, example: xMs5c }
106- domain : { type: string, example: urlr.me }
105+ team : { description: 'Team ID (displayed on dashboard)', type: integer }
106+ folder : { description: 'Folder ID (displayed on dashboard)', type: integer }
107+ url_code : { description: 'Short code', type: string, example: xMs5c }
108+ domain : { description: Domain, type: string, example: urlr.me }
107109 code : { description: 'HTTP status code', type: integer, example: 200 }
108110 type : object
109111 ' 400 ' :
@@ -113,7 +115,7 @@ paths:
113115 schema :
114116 properties :
115117 code : { description: 'HTTP status code', type: integer, example: 401 }
116- error : { type: integer, example: -1 }
118+ error : { description: 'Error code', type: integer, example: -1 }
117119 message : { description: 'Message describing the error', type: string }
118120 type : object
119121 security :
@@ -134,7 +136,7 @@ paths:
134136 - code
135137 properties :
136138 code :
137- description : ' The short code of the url '
139+ description : ' The short code of the URL '
138140 type : string
139141 pattern : ' ^[a-zA-Z0-9!-]{3,50}$'
140142 from :
@@ -156,8 +158,8 @@ paths:
156158 application/json :
157159 schema :
158160 properties :
159- clicks : { type: integer, example: 32 }
160- uniqueClicks : { type: integer, example: 51 }
161+ clicks : { description: Clicks, type: integer, example: 32 }
162+ uniqueClicks : { description: 'Unique clicks', type: integer, example: 51 }
161163 type : object
162164 ' 400 ' :
163165 description : ' An error occurred'
@@ -171,6 +173,55 @@ paths:
171173 security :
172174 -
173175 bearerAuth : []
176+ /team :
177+ get :
178+ tags :
179+ - Team
180+ summary : ' Get teams of user'
181+ operationId : team
182+ responses :
183+ ' 200 ' :
184+ description : ' Teams of user'
185+ content :
186+ application/json :
187+ schema :
188+ properties :
189+ teams : { type: array, items: { properties: { id: { description: 'Team ID', type: integer, example: 131 }, name: { description: 'Team name', type: string, example: 'the best team' } }, type: object } }
190+ type : object
191+ security :
192+ -
193+ bearerAuth : []
194+ /folder :
195+ get :
196+ tags :
197+ - Folder
198+ summary : ' Get folders of team'
199+ operationId : folder
200+ requestBody :
201+ description : ' Infos to provide to get folders of team'
202+ content :
203+ application/json :
204+ schema :
205+ required :
206+ - team
207+ properties :
208+ team :
209+ description : ' Team ID (displayed on dashboard)'
210+ type : integer
211+ example : 123
212+ type : object
213+ responses :
214+ ' 200 ' :
215+ description : ' Folders of team'
216+ content :
217+ application/json :
218+ schema :
219+ properties :
220+ folders : { type: array, items: { properties: { id: { description: 'Folder ID', type: integer, example: 123 }, name: { description: 'Folder name', type: string, example: folder-campaign-google-ads } }, type: object } }
221+ type : object
222+ security :
223+ -
224+ bearerAuth : []
174225components :
175226 securitySchemes :
176227 bearerAuth :
0 commit comments