Link

list of short urls

get

Get all short urls

Authorizations

Responses

200

success

application/json

get

HTTPcURLJavaScriptPython

GET /v1/link HTTP/1.1
Host: api.redirhub.com
Authorization: YOUR_API_KEY
Accept: */*

200

success

{
  "data": [
    {
      "id": "72288a61-034e-4596-80c9-88751cf0a937",
      "host": "www.example.com",
      "url": "www.example.com",
      "alias": "aBD",
      "https": true,
      "destination": "https://www.google.com",
      "destinations": "[]",
      "type": "301",
      "status": "active",
      "forward_query": false,
      "created_at": "2023-11-15T15:09:14.000000Z",
      "updated_at": "2023-11-15T15:09:14.000000Z"
    }
  ]
}

create short url

post

Authorizations

Body

hoststringRequired

Hostname

Example: url.com

aliasstringOptional

Slug

Example: 123

destinationstringRequired

Destination URL

Example: https://www.google.com

typestringOptional

Type

Example: 301

forward_querybooleanOptional

whether forwarding query params to destination

Example: false

Responses

200

success

application/json

post

HTTPcURLJavaScriptPython

POST /v1/link HTTP/1.1
Host: api.redirhub.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "host": "url.com",
  "alias": "123",
  "destination": "https://www.google.com",
  "type": "301",
  "forward_query": false
}

200

success

{
  "data": null
}

Get details about a specific short url by id

get

Authorizations

Path parameters

idstring · stringRequired

short url id

Example: 1639562002248499321

Responses

200

success

application/json

get

HTTPcURLJavaScriptPython

GET /v1/link/{id} HTTP/1.1
Host: api.redirhub.com
Authorization: YOUR_API_KEY
Accept: */*

200

success

{
  "id": "72288a61-034e-4596-80c9-88751cf0a937",
  "host": "www.example.com",
  "url": "www.example.com",
  "alias": "aBD",
  "https": true,
  "destination": "https://www.google.com",
  "destinations": "[]",
  "type": "301",
  "status": "active",
  "forward_query": false,
  "created_at": "2023-11-15T15:09:14.000000Z",
  "updated_at": "2023-11-15T15:09:14.000000Z"
}

update short url

put

Authorizations

Path parameters

idstring · stringRequired

short url id

Example: 1639562002248499321

Body

hoststringRequired

Hostname

Example: url.com

aliasstringOptional

Slug

Example: 123

destinationstringRequired

Destination URL

Example: https://www.google.com

typestringOptional

Type

Example: 301

forward_querybooleanOptional

whether forwarding query params to destination

Example: false

Responses

200

success

application/json

put

HTTPcURLJavaScriptPython

PUT /v1/link/{id} HTTP/1.1
Host: api.redirhub.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "host": "url.com",
  "alias": "123",
  "destination": "https://www.google.com",
  "type": "301",
  "forward_query": false
}

200

success

{
  "data": null
}

delete short url

delete

Authorizations

Path parameters

idstring · stringRequired

short url id

Example: 1639562002248499321

Responses

200

success

application/json

delete

HTTPcURLJavaScriptPython

DELETE /v1/link/{id} HTTP/1.1
Host: api.redirhub.com
Authorization: YOUR_API_KEY
Accept: */*

200

success

{
  "data": null
}