Skip to content

Сервис сокращения ссылок

Сервис позволяет сокращать ссылки по одной или сразу по несколько штук. API работает только в случае, если для кластера on-premise или white-label задан домен для коротких ссылок.

В SaaS-версии REES46 домен коротких ссылок по-умолчанию: rlnq.ru.

POST https://api.rees46.ru/url/create

Параметры

ПараметрОбязателен?Описание
shop_idДаAPI-ключ
shop_secretДаСекретный ключ API
linksДаСписок ссылок для сокращения
links[]ДаОбъект ссылки
links[].urlДаИсходный URL для сокращения
links[].lifetimeНетВремя жизни сокращенной ссылки в днях. По-умолчанию 30, не более 90, не менее 1

Запрос

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

shell
curl --header "Content-Type: application/json" \
  --request POST \
  --data-binary "@payload.json" \
  https://api.rees46.ru/url/create

Пример JSON-тела:

json
{
  "shop_id": "...",
  "shop_secret": "...",
  "links": [
    {
      "url": "https://example.com/page/1/?utm_source=source..."
    },
    {
      "url": "https://example.com/page/2/?utm_source=source...",
      "lifetime": 60
    },
    {
      "url": "https://example.com/page/3/?utm_source=source...",
      "code": "a",
      "lifetime": 10
    }
  ]
}

Ответ

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

json
[
  {
    "source": "https://example.com/page/1",
    "url": "https://r46.dev/x27FyAlR"
  },
  {
    "source": "https://example.com/page/2",
    "url": "https://r46.dev/a"
  }
]

Важно

Формат ответа устарел. В будущем он будет приведен к формату:

json
{
  "success": true,
  "payload": {
    "urls": [
      {
        "source": "https://example.com/page/1",
        "url": "https://r46.dev/x27FyAlR"
      },
      {
        "source": "https://example.com/page/2",
        "url": "https://r46.dev/a"
      }
    ]
  }
}

В случае ошибки ответ будет в формате:

json
{
  "success": false,
  "payload": {
    "message": "Identifier is not valid"
  }
}