REST API

Base URL: https://urlik.xyz/api/. Responses are JSON of the form:

{ "status": "success", "message": "...", "return": { ... } }

Authentication (optional for basic shortening) — the X-Api-Key header. Your key is in your account. Links created with a key are attached to your account.

Endpoints

POST /api/getLink.json

Create a short link.

ParameterRequiredDescription
urlrequiredtarget URL (http/https)
aliasoptionalcustom code, 2–32 chars [a-zA-Z0-9_-]
modeoptionalredirect (default), preview, frame
expireoptionallifetime in seconds (0 = never)
passwordoptionalpassword to follow the link
curl -X POST https://urlik.xyz/api/getLink.json \
 -H "X-Api-Key: YOUR_KEY" \
 -d "url=https://example.com/very/long/path" \
 -d "mode=redirect"
{ "status":"success", "return":{
 "hex":"a1b2c3", "url":"https://urlik.xyz/a1b2c3",
 "qr":"https://urlik.xyz/qr/a1b2c3.png",
 "stats":"https://urlik.xyz/a1b2c3+", "mode":"redirect" } }

POST /api/stats.json

Stats for a link. The code parameter is the short code. Returns the click count, a daily series, sources, devices and browsers.

POST /api/links.json

List your links. Requires X-Api-Key.

POST /api/update.json

Update a link (code + fields url, mode, expire, password). Requires a key/session.

POST /api/delete.json

Delete a link (code). Requires X-Api-Key or the owner's session.

QR codes and temporary email

These methods require the X-Api-Key header (your key is in your account).

MethodParametersDescription
GET /api/qr.jsondata*, format, fg, bg, ecc, sizeQR code: format = png/svg, colors fg/bg
GET /api/mailbox.jsonaddress or usernameget or create a temporary address
GET /api/messages.jsonaddresslist messages in a temporary inbox
GET /api/message.jsonaddress, idread a single message

Простий REST API для коротких посилань

REST API Urlik дає змогу створювати, читати, оновлювати та видаляти короткі посилання з вашого власного коду й отримувати статистику кліків у форматі JSON. Це звичайний HTTPS API — надішліть POST-запит і отримайте передбачувану JSON-відповідь — тож він працює з будь-якої мови чи платформи.

Для базового скорочення облікові дані не потрібні. Щоб прив'язувати посилання до вашого облікового запису та керувати ними згодом, надсилайте свій ключ у заголовку X-Api-Key, який ви знайдете у своєму обліковому записі. Відповіді завжди мають той самий формат зі статусом, повідомленням і полем return, показаний нижче.

Чи потрібен мені ключ API?

Для базового скорочення — ні, посилання можна створити анонімно. Ключ, який є у вашому обліковому записі, прив'язує посилання до вас і потрібен, щоб переглядати, оновлювати чи видаляти їх.

У якому форматі надходять відповіді?

Кожна кінцева точка повертає JSON зі статусом, зрозумілим людині повідомленням і об'єктом return, що містить дані, тож розбір відповідей однаковий для всіх викликів.

Чи є обмеження за частотою запитів?

Так, запити обмежуються за частотою для кожного викликача, щоб сервіс залишався швидким і справедливим. Автентифіковані ключі отримують більший ліміт, ніж анонімний трафік.

Чи можна використовувати його з будь-якої мови?

Так. Це стандартний HTTPS JSON API, тож ним може користуватися все, що вміє надсилати POST-запит — curl, Python, PHP, JavaScript або Go.