Pisano External API - Link Shortening - Pisano Link Shortening Service
Pisano Link Shortening Service
Shorten a URL using Pisano's psn.vc HTTP API.
POST
https://psn.vc/shorten
Headers
| Header | Required | Description | Example |
|---|---|---|---|
Content-Type |
Yes | Request content type. | application/json |
Request Body
{
"url": "https://www.google.com"
}
Request Body Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
url |
string | Yes | URL to shorten. | https://www.google.com |
Request Example
cURL
Request Example
curl --location --request POST 'https://psn.vc/shorten' \
--header 'Content-Type: application/json' \
--data '{"url":"https://www.google.com"}'
Response Schema
result
├── id string
├── fullUrl string
├── shortUrl string
└── createdAt string
Response Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
id |
string | Generated short code identifier. | czmx32vldv |
|
fullUrl |
string | Original URL. | https://www.google.com | |
shortUrl |
string | Generated short URL. | https://psn.vc/czmx32vldv | |
createdAt |
string | Creation timestamp. | 2023-04-13T16:06:41.964Z |
Response Example
{
"id": "czmx32vldv",
"fullUrl": "https://www.google.com",
"shortUrl": "https://psn.vc/czmx32vldv",
"createdAt": "2023-04-13T16:06:41.964Z"
}
Additional Information
Usage Limitations
The service is exposed as an HTTP API rather than a browser interface. For on premise environments, the Pisano cluster must be able to reach the Pisano link shortener over port 443 when this service is used.
Notes
Links use psn.vc by default and can use a configured customer domain prefix.