API docs

Введение.

Хархив АПИ - это удобный способ управлять контентом и получать к нему доступ. Все данные получаются с помощью REST API, через get запросы в виде JSON массивов.

Самый простой пример запроса, который выводит случайную картинку:
https://harhive.pp.ua/api/?action=img-rand&number=1

Основные параметры

  • ?action - главный параметр, указывает что хотим получить. Он должен быть обязательно.
  • ?number - количество элементов (в некоторых случаях если не указывать или ставить неверное значение будет null).
  • ?nomer - указывает id, используется без number или если number = 1.
  • ?row - используется для разбития на страницы. Тоисть при значении 30 показывает следующие 30 картинок.
  • ?timemark - используется для бесконечной ленты. Чтобы не было повторов картинок, ведь может появиться новая за время между запросами. Можно использовать и для страниц.

    • Есть и другие, но о них в другой раз.

    img-rand

    Выдаёт случайные картинки. Используется только с ?number.
    Пример:
    https://harhive.pp.ua/api/?action=img-rand&number=1

    img-get

    Выдаёт картинку с определённым id. Используется только с ?nomer.
    Пример:
    https://harhive.pp.ua/api/?action=img-get&nomer=1317

    img-list

    Выдаёт список картинок которые сменяются со временем. Используется только с ?number. Также из дополнительных опций есть ?row и ?timemark. Также если не задавать ?timemark выдаст его для данного запроса в специальном массиве, там где зачастую null.
    Пример:
    https://harhive.pp.ua/api/?action=img-list&number=50&row=20&timemark=980

    msg-get

    Выдаёт список последних комментариев. Используется только с ?number. Также ?number может принимать значение all, которое позволит вывести все комментарии.
    Пример:
    https://harhive.pp.ua/api/?action=msg-get&number=all

    Добавление контента

    Пока что публично надавать доступ до редактирования / добавления контента, комментариев не планируется. Сейчас оно доступно только при наличии специального ключа.