Счётчики укорачивателя

GET /api/partners/linkly/

🔒 bot-key или OAuth

Кратко: Получить список счётчиков укорачивателя ссылок в проекте.

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

• limit (integer, опциональный), offset (integer, опциональный) — используется для пагинации результатов

• is_system (boolean, опциональный) — фильтр по системным счётчикам

• created_at__gte / created_at__lte (string, date-time) — диапазон дат создания

Возвращает: 200 OK — список объектов Linkly.

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

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "sqid": "string",
      "name": "string",
      "description": "string",
      "created_at": "2026-06-10T09:19:21.336Z",
      "last_jumped_at": "2026-06-10T09:19:21.336Z",
      "total_urls": 0,
      "total_jumped": 0,
      "is_system": true
    }
  ]
}

Ошибки: 401 — ошибка авторизации.

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

bash

# Только пользовательские (несистемные) счётчики
curl -X GET "https://dashboard.fstrk.io/api/partners/linkly/?is_system=false&limit=50" \
  -H "bot-key: your_bot_key"

---

GET /api/partners/linkly/{sqid}/

🔒 bot-key или OAuth

Кратко: Получить детальную информацию по счётчику.

Параметры пути:

• sqid (string, обязательный) — идентификатор счётчика

Возвращает: 200 OK — объект Linkly:

sqid — идентификатор счётчика, name — название счетчика на платформе, description — описание к счетчику, created_at — дата и время создания счетчика, last_jumped_at — дата и время последнего перехода по ссылке счетчика, total_urls — количество укорачиваний ссылок счетчика, total_jumped — количество переходам по ссылкам счетчика, is_system — является ли счетчик системным.

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

{
  "sqid": "string",
  "name": "string",
  "description": "string",
  "created_at": "2026-06-10T09:51:23.919Z",
  "last_jumped_at": "2026-06-10T09:51:23.919Z",
  "total_urls": 0,
  "total_jumped": 0,
  "is_system": true
}

Ошибки: 401 — ошибка авторизации; 404 — счётчик не найден.

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

bash

curl -X GET "https://dashboard.fstrk.io/api/partners/linkly/abc123/" \
  -H "bot-key: your_bot_key"

---

GET /api/partners/linkly/{sqid}/statistic/

🔒 bot-key или OAuth

Кратко: Получить дневную статистику переходов по счётчику.

Параметры пути:

• sqid (string, обязательный) — идентификатор счётчика

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

• created_at__gte (string, date, обязательный) — начало периода YYYY-MM-DD

• created_at__lte (string, date, обязательный) — конец периода YYYY-MM-DD

• limit (integer, опциональный), offset (integer, опциональный)

Возвращает: 200 OK — постраничный список объектов LinklyStatistic: date, count.

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

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "date": "2026-06-10T09:34:29.551Z",
      "count": 0
    }
  ]
}

Ошибки: 400 — не указан обязательный параметр даты; 401 — ошибка авторизации; 404 — счётчик не найден.

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

bash

curl -X GET "https://dashboard.fstrk.io/api/partners/linkly/abc123/statistic/?created_at__gte=2024-09-01&created_at__lte=2024-09-30" \
  -H "bot-key: your_bot_key"