Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/itsjoniur/bitlygo
URL Shortener - Short URLs & Custom Free Link Powered by Goland and ... database
https://github.com/itsjoniur/bitlygo
Last synced: about 1 month ago
JSON representation
URL Shortener - Short URLs & Custom Free Link Powered by Goland and ... database
- Host: GitHub
- URL: https://github.com/itsjoniur/bitlygo
- Owner: itsjoniur
- License: gpl-3.0
- Created: 2022-08-22T20:20:45.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-09-09T11:19:07.000Z (over 2 years ago)
- Last Synced: 2024-10-12T09:43:12.999Z (2 months ago)
- Language: Go
- Homepage:
- Size: 111 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bitly Go
URL Shortener - Short URLs & Custom Free Link Powered by GoLang and PostgreSQL database.
## Dependencies
- Golang 1.18+
- [Tern](https://github.com/jackc/tern) 1.13+ (The SQL Fan's Migrator)## Getting started
- Rename `config.yaml.example` to `config.yaml`, and `tern.conf.example` to `tern.conf`;
- Change the database connection info with your own.### Run without docker
```bash
cd cmd/bitlygo/
go run main.go
```### Run as a docker container
NOTE: Make sure you changed the database connection info in `docker-compose.yaml` file
```bash
$ docker-compose build --no-cache
$ docker-compose up -d
```## Routes
### `GET /`
This route will show this README to show the features of the projects to everyone.
### `POST /register`
- STRING `username` (required, The minimum length is 4 and maximum length is 88 also does not allow empty username)
- STRING `password` (required)This route will make new user if didn't exist
Example response:
```json
{
"username": "john",
"api_key": "abcd-efgh-ijkl-mnop-124v-852a"
}
```OR
```json
{
"status": false,
"message": "Error message"
}
```### `POST /login`
- STRING `username` (required)
- STRING `password` (required)This route will log into user account if exists
Example response:
```json
{
"status": true
}
```OR
```json
{
"status": false,
"message": "Error message"
}
```### `GET /search`
- STRING `q` (required, The minimum length is 1 and does not allow empty queries also we will trim the value to make it ready to search)
We will remove and skip all non-English and non-Digits characters and after that, if `q` is not empty we will search and fetch the results. Otherwise, throw an error!- POSITIVE INT `limit` (default is 10, Minimum value is 1 and Maximum is 100. Otherwise, throw an error!)
Example response:
```json
{
"status": true,
"items": {
"google": "https://google.com",
"facebook": "https://fb.com/?from_my_site",
"telegram": "https://t.me/"
}
}
```OR
```json
{
"status": false,
"error": "Error message"
}
```### `GET /top`
- POSITIVE INT `limit` (default is 10, Minimum value is 1 and Maximum is 100. Otherwise, throw an error!)
Example response:
```json
{
"status": true,
"items": [
{
"name": "google",
"link": "https://google.com",
"visits": 300
},
{
"name": "github",
"link": "https://github.com/test",
"visits": 255
},
{
"name": "fb",
"link": "https://fb.com",
"visits": 200
}
]
}
```OR
```json
{
"status": false,
"error": "Error message"
}
```### `GET /expire-soon`
- POSITIVE INT `limit` (default is 10, Minimum value is 1 and Maximum is 100. Otherwise, throw an error!)
Example response:
```json
{
"status": true,
"items": {
"google": "https://google.com",
"facebook": "https://fb.com/?from_my_site",
"telegram": "https://t.me/"
}
}
```OR
```json
{
"status": false,
"error": "Error message"
}
```### `POST /add` or `POST /add/`
- STRING `name` (optional, If not defined, we will generate a short and unique random name)
- STRING `link` (required, and we will check the link should be valid and pass URL standard format)
About link value: we must support **UTF-8** characters or query values.If you send `API-KEY` in the headers, your short link will be alive for ever, otherwise, all links you are creating will only live for 2 days. It should be nice to easily config this limitation inside the source.
Note: you cannot create a duplicate name and It should throw an error. But it's okay to store the same link in different names.
### `POST /:name` or `POST /:name/`
- STRING `link` (required, and we will check the link should be valid and pass URL standard format)
About link value: we must support **UTF-8** characters or query values.If you send `API-KEY` in the headers, your short link will be alive for ever, otherwise, all links you are creating will only live for 2 days. It should be nice to easily config this limitation inside the source.
Note: you cannot create a duplicate name and It should throw an error. But it's okay to store the same link in different names.
### `GET /:name`
If the name is available on the databases. we will redirect the clients to the target URL. 301 redirect is fine.
Otherwise, we should alert that is a 404 (HTTP Status) route and display a 404 warning.
### `UPDATE /:name`
- STRING `new_name` (optional)
- STRING `link` (required, and we will check the link should be valid and pass URL standard format)
About link value: we must support **UTF-8** characters or query values.You can only update a link created by an API-KEY.
So if the owner of that link is same as your API-KEY, you are allowed to update that.Note: you cannot change the name, you only can change the link value and link that to another new URL.
### `DELETE /:name` or `DELETE /:name/`
You can only delete links created by an API-KEY.
So if the owner of that link is same as your API-KEY, you are allowed to delete.Example response:
```json
{
"status": true
}
```OR
```json
{
"status": false,
"error": "Sorry, no permission"
}
```**Important NOTE:** Note that `search`, `add`, `expire-soon`, and `top` are not allowed for names and we should make sure it's not allowed to create such names. since they are already reserved in the router.
The **minimum** allowed name length is 4 and the **maximum** is 25.
The name can only contain English and numeric characters. Any other character is ignored.
## Database
It's okay to use **PostgreSQL** or **MariaDB**.
Note: since this project supports short lifetime links, we can use other databases too. but it's possible to use SQL and delete old rows.
## Authors
- Its Joniur
- Max Base