💻 SHORTT-LY (URL-Shortener)

A simple yet useful web service to compress long URLs into shorter ones.

• https://shortt-ly.herokuapp.com/

Features

1. General URL shortening
2. Custom URL shortening
3. Easy to integrate with other applications

Open Endpoints

• Shorten given long URL : POST /api/short
• Shorten URL with custom code : POST /api/custom
• Redirect to website : GET /:code
• Check API health : GET /health

---

POST /api/short

Request schema

{
    "longUrl": "<the-long-url-to-be-shortened>"
}

Response schema

{
  "_id": "5f81dca70f685f2f104",
  "longUrl": "<the-long-url-to-be-shortened>",
  "shortUrl": "https://<base-url>/-i8bZ5O9B",
  "urlCode": "-i8bZ5O9B",
  "date": "Sat Oct 10 2017 21:39:11 GMT+0530 (India Standard Time)",
  "__v": 0
}

{
  "errors": {
    "message": "Invalid long URL"
  }
}

{
  "errors": {
    "message": "Invalid base URL"
  }
}

{
  "errors": {
    "message": "Server error"
  }
}

---

POST /api/custom

Request schema

{
    "longUrl": "<the-long-url-to-be-shortened>",
    "urlCode": "<custom-code>"
}

Response schema

{
  "_id": "5f81dca70f685f2f104",
  "longUrl": "<the-long-url-to-be-shortened>",
  "shortUrl": "https://<base-url>/-i8bZ5O9B",
  "urlCode": "-i8bZ5O9B",
  "date": "Sat Oct 10 2017 21:39:11 GMT+0530 (India Standard Time)",
  "__v": 0
}

{
  "errors": {
    "message": "Code already in use"
  }
}

{
  "errors": {
    "message": "Invalid long URL"
  }
}

{
  "errors": {
    "message": "Invalid base URL"
  }
}

{
  "errors": {
    "message": "Server error"
  }
}

---

Instructions

• Clone the repository
• Install node from official website
• Install the dependencies for the project using below command

  npm install

• To run the application locally

  npm run dev

• In the browser goto : http://localhost:5000/health

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Check Contributing.md for more instructions.

License

MIT