nip-urls
TypeScript icon, indicating that this package has built-in type declarations

1.0.3 • Public • Published

Nip URL Shortening SDK

This is a simple Node.js package to allow easy consumption of the Nip URL shortening service. This library is built with TypeScript.

The service allows you to pass it a url and then receive back a short-url (or longer one) that is fully tracked. These short-urls only work for GET requests.

Installation

npm install nip-urls --save

Usage

To use this library, first import and instantiate the class with your reserved domain name and API key.

const { Nip } = require('nip-urls');
 
const nip = new Nip('nip.is', 'INSERT_API_KEY_HERE');

Generate tracked short url

const url = await nip.shorten('https://root.co.za/careers');

Generate tracked longer url

const url = await nip.track('https://root.co.za/careers');

Fetch a url

const url = await nip.getUrl('b4949c2b-8a76-44df-8c34-04ccad2f9fb8');

Fetch a url's visits

const visits = await nip.getUrlVisits('b4949c2b-8a76-44df-8c34-04ccad2f9fb8');

Interface definitions

type Url

export interface Url {
  id: string;
  domainName: string;
  sourceUrl: string;
  destinationUrl: string;
  visitCount: number;
  createdAt: moment.Moment;
};
{
  id'b4949c2b-8a76-44df-8c34-04ccad2f9fb8',
  domainName'nip.is',
  sourceUrl'https://nip.is/cXCUn',
  destinationUrl'https://root.co.za/careers',
  visitCount1,
  createdAtmoment("2019-05-27T20:48:48.519")
}

type Visit

export interface Visit {
  id: string;
  url_id: string;
  headers: any;
  createdAt: moment.Moment;
};
{
  id'11bee574-626e-447f-9864-329c56756872',
  urlId'b4949c2b-8a76-44df-8c34-04ccad2f9fb8',
  headers{
    host'nip.is',
    'user-agent':
    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/74.0.3729.169 Safari/537.36',
    'cf-ipcountry''ZA',
    'x-forwarded-for''41.56.11.31, 197.234.242.47',
    'cf-connecting-ip''41.56.11.31',
    ...
  },
  createdAtmoment("2019-05-27T20:50:59.141"),
}

Created by Root.

Readme

Keywords

none

Package Sidebar

Install

npm i nip-urls

Weekly Downloads

0

Version

1.0.3

License

ISC

Unpacked Size

23.3 kB

Total Files

9

Last publish

Collaborators

  • louwhopley
  • nthfloor