Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/roast-cms/links
An Express.js API for managing affiliate links
https://github.com/roast-cms/links
affiliate-marketing expressjs nextjs nodejs react
Last synced: 3 months ago
JSON representation
An Express.js API for managing affiliate links
- Host: GitHub
- URL: https://github.com/roast-cms/links
- Owner: roast-cms
- License: mit
- Archived: true
- Created: 2021-10-28T20:26:25.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-11-27T01:02:36.000Z (about 2 years ago)
- Last Synced: 2024-09-26T01:33:27.187Z (3 months ago)
- Topics: affiliate-marketing, expressjs, nextjs, nodejs, react
- Language: TypeScript
- Homepage:
- Size: 170 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# `links`
> An Express.js server middleware for managing affiliate links.
This project creates an API service which will return a link URL in response to a keyword (or another URL) and parameters (like locale). You can use the returned URL to either create redirects (link cloaking) or to simply manage links the HTML of your blog, website, or a tool.
## Installation:
### Prerequisites:
- [Express.js](https://arorachakit.hashnode.dev/how-to-start-a-basic-node-and-express-server) server.
- [MongoDB](https://docs.mongodb.com/guides/server/install/) database.
- [Redis](https://www.javaniceday.com/post/install-and-run-redis-locally) server.
- A **secret** `.env` file in your root dir with a random `APPLICATION_SECRET` string & connection URIs (see `.env.example`).
### `yarn add @roast-cms/links`
### Implementation example:
```javascript
import links from "@roast-cms/links";
app.use(
links({
// OPTIONAL path name for the `links` API on local Express router
pathName: "/recommends",
})
);
```
Complete example can be found in `./example-server.ts` and can be run with `yarn dev:example` from this repo.
## API:
#### GET `/recommends/widget`
```json
{
"link": "widget",
"status": 200,
"vendor": {
"name": "eBay",
"url": "https://ebay.com/us/widget?referral=you"
}
}
```
For this example to work, MongoDB collection `links` should have the following document (`vendors[].locale` is optional):
```json
{
"link": "widget",
"vendors": [
{
"url": "https://shop.com/us/widget?referral=you",
"value": 1,
"locale": "us",
"name": "eBay"
}
]
}
```
##### Parameters:
- `locale` - Not implemented but planned. Would prioritize local vendors.
- `vendors` - Select vendor groups. Currently implemented: `"ALL"`, which lists all vendors for the link.
#### GET `/recommends/group?tag=cameras`
Returns all links for a given `tag` param.
#### GET `/recommends/bulk?links=widget,toy,fancy-garmet`
Returns all links (including all vendors) from array inferred from `links` param (uses `array.split(",")`). Limit of 10.
## Usage (with React):
This an example using React framework, however, the idea would be the same in any kind of project (both on server and on the browser):
1. Make an XHR (or fetch) request to `links` service with the key (must be a string) as a URL path and any parameters sent as a query.
2. Wait for response.
3. Use the response to create link in the returned HTML (though this could be any language your app is built in).
```javascript
export const MyPage = () => {
// manage state of the app (React-specific)
const [myLink, setMyLink] = useState("#default-link");
// send fetch request on page load and update state
useEffect(() => {
try {
const linkResponse = await fetch("/recommends/widget?locale=us");
const linkResponseJson = await linkResponse.json();
setMyLink(linkResponseJson.vendor.url);
} catch(error) {
console.log(error);
}
},[]);
// return page HTML
return
This is my example text, oh, and look: an affiliate link!
}
```
_See example for authenticated implementation with an option to edit and archive links_
## To Do:
- [x] Initialize project in Node.js with Mongoose (MongoDB)
- [x] TypeScript and Jest
- [ ] Add locale selection logic
- [x] Allow link disabling/archiving