Shortener

An API Key is required for this service. See Shared Responses for common error responses.

Shorten A URL

POST https://yiff.rocks/create

If Read Only is enabled, a 503 Service Unavailable will be returned.

Query Parameters

Name
Type
Description

editable

Boolean

If the shortened url should be editable (you will get a code to edit with)

Request Body

Name
Type
Description

code

String

The code to use, random if not specified.

credit

String

The name to credit, Unknown if not specified.

url*

String

The URL to shorten.

// Max: 50
{
  "success": false,
  "error": "Provided code is too long.",
  "code": 1070
}

Get A Short URL (Redirect)

GET https://yiff.rocks/:code

// Redirected to original url

Get A Short URL (Preview)

GET https://yiff.rocks/:code+

// HTML Page

Get A Short URL (JSON)

GET https://yiff.rocks/:code.json

{
  "success": true,
  "data": {
    "code": "",
    "createdAt": "0000-00-00T00:00:00.000Z",
    "modifiedAt": "0000-00-00T00:00:00.000Z", // nullable
    "url": "",
    "pos": 0,
    "credit": "",
    "fullURL": "https://yiff.rocks/{code}"
  }
}

Delete A Short URL

DELETE https://yiff.rocks/:code

If Read Only is enabled, a 503 Service Unavailable will be returned.

Request Body

Name
Type
Description

managementCode*

String

The management code you received when creating the shorturl.

{
  "success": false,
  "error": "You must provide an authorization code. These are created at the time the short url was created.",
  "code": 1076
}

Modify A Short URL

PATCH https://yiff.rocks/:code

If Read Only is enabled, a 503 Service Unavailable will be returned.

Request Body

Name
Type
Description

managementCode*

String

The management code you received when creating the shorturl.

credit

String

The new credit name for the url.

url

String

The new url for the shorturl.

{
  "success": false,
  "error": "You must provide an authorization code. These are created at the time the short url was created.",
  "code": 1076
}

Last updated