Pisano Link Shortening Service

Shorten a URL using Pisano's psn.vc HTTP API.

POST https://psn.vc/shorten

Headers

Field	Type	Required	Description
`Content-Type`	string	Yes	Request content type. Example: `application/json`.

Request Body

{
  "url": "https://example.com"
}

Request Body Fields

Field	Type	Required	Description	Example
`url`	string	Yes	URL to shorten.	`https://example.com`

Request Example

cURL

cURL Request Example

curl --location --request POST 'https://psn.vc/shorten' \
--header 'Content-Type: application/json' \
--data '{"url":"https://example.com"}'

Success Response

200 OK

Response Schema

result

├── id string

├── fullUrl string

├── shortUrl string

└── createdAt string

Response Fields

Field	Type	Description
`id`	string	Generated short-link identifier.
`fullUrl`	string	Original URL submitted for shortening.
`shortUrl`	string	Shortened URL generated by Pisano.
`createdAt`	string	Creation timestamp of the shortened URL.

Success Response Example

{
  "id": "<short_code>",
  "fullUrl": "https://example.com",
  "shortUrl": "https://psn.vc/<short_code>",
  "createdAt": "<created_at>"
}

Error Responses

422 Unprocessable Entity

Error Response Example

{
  "full_url": [
    "can't be blank"
  ]
}

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.

Pisano External API - Link Shortening - Pisano Link Shortening Service