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.
| Parameter | Required | Description |
|---|---|---|
url | required | target URL (http/https) |
alias | optional | custom code, 2–32 chars [a-zA-Z0-9_-] |
mode | optional | redirect (default), preview, frame |
expire | optional | lifetime in seconds (0 = never) |
password | optional | password 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).
| Method | Parameters | Description |
|---|---|---|
GET /api/qr.json | data*, format, fg, bg, ecc, size | QR code: format = png/svg, colors fg/bg |
GET /api/mailbox.json | address or username | get or create a temporary address |
GET /api/messages.json | address | list messages in a temporary inbox |
GET /api/message.json | address, id | read 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.