API Documentation

Cách 1 — Header X-API-Key (khuyến nghị)

curl https://rutgon.vmeta.vn/api/v1/links \
  -H "X-API-Key: ls_live_YOUR_API_KEY_HERE"

Cách 2 — Header Authorization: Bearer

curl https://rutgon.vmeta.vn/api/v1/links \
  -H "Authorization: Bearer ls_live_YOUR_API_KEY_HERE"

Response thành công

{
  "data": { ... },       // Đối với endpoint đơn lẻ
  "data": [ ... ],       // Đối với endpoint danh sách
  "meta": {             // Đính kèm khi phân trang
    "total": 42,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  }
}

Response lỗi

{
  "error": "Mô tả lỗi",
  "code": "ERROR_CODE"    // Mã lỗi để xử lý trong code
}

Node.js / TypeScript

const API_KEY = process.env.LINKSHORT_API_KEY // ls_live_xxx
const BASE    = 'https://rutgon.vmeta.vn/api/v1'

async function shortenUrl(originalUrl: string, title?: string) {
  const res = await fetch(`${BASE}/links`, {
    method: 'POST',
    headers: {
      'X-API-Key': API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ originalUrl, title }),
  })

  if (!res.ok) {
    const err = await res.json()
    throw new Error(err.error)
  }

  const { data } = await res.json()
  return data.shortUrl  // "https://rutgon.vmeta.vn/p/abc123"
}

// Sử dụng
const shortUrl = await shortenUrl('https://example.com/very/long/path', 'Trang chủ')
console.log(shortUrl)

Python

import os
import requests

API_KEY = os.environ['LINKSHORT_API_KEY']  # ls_live_xxx
BASE    = 'https://rutgon.vmeta.vn/api/v1'

def shorten_url(original_url: str, title: str = None) -> str:
    response = requests.post(
        f'{BASE}/links',
        headers={'X-API-Key': API_KEY, 'Content-Type': 'application/json'},
        json={'originalUrl': original_url, 'title': title},
    )
    response.raise_for_status()
    return response.json()['data']['shortUrl']

# Sử dụng
short_url = shorten_url('https://example.com/very/long/path', 'Trang chủ')
print(short_url)  # https://rutgon.vmeta.vn/p/abc123

PHP

<?php
$apiKey = getenv('LINKSHORT_API_KEY'); // ls_live_xxx
$base   = 'https://rutgon.vmeta.vn/api/v1';

function shortenUrl(string $url, string $title = ''): string {
    global $apiKey, $base;
    $ch = curl_init("$base/links");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_HTTPHEADER     => ["X-API-Key: $apiKey", 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS     => json_encode(['originalUrl' => $url, 'title' => $title]),
    ]);
    $body = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $body['data']['shortUrl'];
}

echo shortenUrl('https://example.com/very/long/path', 'Trang chủ');
// https://rutgon.vmeta.vn/p/abc123