Redirects

This entity records all user interactions with shortened links, collecting information about the user's system, the time of the redirect, and other relevant data.

Base requirements

• Auth: NO

CREATE

• Method: POST
• Url: /api/v1/redirects

name	type	data type	description
os	required	string	client os
device	required	string	client device
ip	required	string	client IpV4
userKey	required	UUID	unique client ID (generated on client)
domain	required	string	domain address
subdomain		string?	subdomain address
path	required	string	url path

Validation

• os
  • len: [2, 16]
• device
  • only: Mobile Desktop
• domain
  • len: [5, 32]
  • regex: ^[a-z0-9]+[.:][a-z0-9]{2,}$
• subdomain
  • len: [2, 16]
  • regex: ^[a-zA-Z]{2,16}$
• path
  • len: [2, 16]

Example

{
  "os": "windows",
  "device": "Mobile",
  "ip": "127.0.0.1",
  "userKey": "41c6e485-b373-4723-a31e-3ee767367fbd",
  "domain": "sh0.su",
  "subdomain": "test",
  "path": "fcaz6p"
}

Errors

• Not found

GET

• Method: GET
• Url: /api/v1/redirects/link?{domain}=&{path}=&{subdomain}=

name	type	data type	description
domain	required	string	domain address
subdomain		string?	subdomain address
path	required	string	url path

Validation

• domain
  • len: [5, 32]
  • regex: ^[a-z0-9]+[.:][a-z0-9]{2,}$
• subdomain
  • len: [2, 16]
  • regex: ^[a-zA-Z]{2,16}$
• path
  • len: [2, 16]

Example

GET /api/v1/redirects/link?domain=sh0.su&path=ml6v1s

{
  "uid": "41c6e485-b373-4723-a31e-3ee767367fbd",
  "password": null,
  "urls": [
    "https://www.youtube.com/",
    "https://vk.com/"
  ]
}

Errors

• Not found