youring · api v1RU / EN

Открытый API кольца

JSON, без ключей и регистрации. Кэш 60s, мягкие лимиты. Полная схема — /openapi.json (OpenAPI 3.1).

Кольцо

GET/api/v1/ring

Всё кольцо: активные сайты в порядке кольца.

GET/api/v1/ring/{slug}

Сайт и его соседи: site, prev, next, index, total.

GET/api/v1/ring/{slug}/next|prev|random

Один сосед. Удобно для навигации.

GET/api/v1/ring/opml

OPML-бандл: одна подписка на все фиды кольца (RSS/Atom).

Поиск

GET/api/v1/random?exclude=slug

Случайный участник. ?kind= — только из подкольца.

GET/api/v1/search?q=код&limit=10

Поиск по имени, домену, описанию и тегам.

Цифры и здоровье

GET/api/v1/stats

Участники, заявки, новые за неделю, клики.

GET/api/v1/health

Оценки участников: онлайн 40 · виджет 30 · ссылки 15 · профиль 15 → S...F.

Виджет, бейдж, редиректы

GET/{slug}

302 на сайт участника, считает переход.

GET/{slug}/prev · /{slug}/next · /{slug}/random

302 на соседа — для кнопок на сайте.

GET/badge/{slug}.svg

SVG-бейдж с именем и стрелками.

GET/widget.js

Веб-компонент <youring-ring>.

Пример

curl https://youring.roxera.net/api/v1/ring/xxiivv

{
  "site": { "slug": "xxiivv", "name": "XXIIVV", ... },
  "index": 0, "total": 8,
  "prev": { "slug": "...", "name": "..." },
  "next": { "slug": "...", "name": "..." }
}

Генератор виджета

Вставь slug своего сайта — получишь готовый код.


  
предпросмотр появится здесь