API сокращения ссылок 9g.su

X-API-Key: ваш_api_ключ

POST /v1/create-links

Создает новую короткую ссылку.

Параметры запроса:

• url (обязательный) - оригинальный URL для сокращения
• lifetime (опциональный) - срок жизни ссылки в днях (по умолчанию 90 дней)

Пример запроса:

curl -X POST https://api.9g.su/v1/create-links \
    -H "X-API-Key: ваш_api_ключ" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://example.com/very/long/url", "lifetime": 30}'

Пример ответа:

{
    "status": 201,
    "data": {
        "id": 123,
        "link": "https://9g.su/abc123",
        "lifetime": "2024-12-31 12:00:00"
    }
}

GET /v1/get-links

Получает список всех коротких ссылок пользователя.

Пример запроса:

curl -X GET https://api.9g.su/v1/get-links \
    -H "X-API-Key: ваш_api_ключ"

Пример ответа:

{
    "status": 200,
    "data": [
        {
            "id": 1,
            "link": "https://example.com/very/long/url",
            "short": "abc123",
            "lifetime_to": "2024-12-31 12:00:00",
            "source": "api",
            "created_at": "2024-06-04 10:07:08"
        }
    ]
}

GET /v1/get-links/{id}

Получает информацию о конкретной короткой ссылке по её ID.

Пример запроса:

curl -X GET https://api.9g.su/v1/get-links/1 \
    -H "X-API-Key: ваш_api_ключ"

Пример ответа:

{
    "status": 200,
    "data": [
        "link": [
            {
                "id": 1,
                "link": "https://example.com/very/long/url",
                "short": "abc123",
                "user_id": 1,
                "lifetime_to": "2024-12-31 12:00:00",
                "source": "api",
                "created_at": "2024-06-04 10:07:08"
            }
        ],
        "stats": [
            {
                "id": 2088,
                "link_id": 1,
                "access_at": "2025-05-07 13:29:02",
                "country": "RU",
                "ip": "123.123.123.123",
                "device": "desktop",
                "os": "Windows 10",
                "browser": "Chrome 136",
                "origin": null,
                "city": "Ryazan’",
                "latitude": "54.6269",
                "longitude": "39.6916",
                "ip_organisation": "AS25159 PJSC MegaFon"
            }
    ]
}

DELETE /v1/delete-links/{id}

Удаляет ссылку её ID.

Пример запроса:

curl -X DELETE "https://api.9g.su/v1/delete-links/777" \
-H "X-API-Key: ваш_api_ключ"

Пример ответа:

{
    "status": 200,
    "data": ""
}