???
Это всего лишь мои предложения, а ты естественно можешь своё предложить. И не только ты, но и любой заинтересованный.

Сразу скажу, я подумал и решил -- в моих предложениях по API не будет методов записи в сообщения (т.е. создание тем/опросов, новых сообщений и их редактирования).

Но не унывай, моё предложение по API, которое я опубликую последним, перекроет собой отсутствие записи в сообщения.     

Осталось -- доступ к:
спискам юзеров (там же рейтинг поста),
нтмл-контенту,
ЛС,
опросам,
серверному хранилищу.

А я считаю, что из-за того что куки хранятся на стороне клиента, т.е. браузеров пользователей, Admin'у до лампочки на кукисы.
Ему, пожалуй, важно чтобы "печенюжки", которые создаются движком форумов, нормально работали - читались, писались и сохранялись.

Не понял.

Отредактировано RUSSIAN_GOBLIN (Чт, 15 Мар 2012 19:34:08)

Продолжаем-с 

3. Доступ к спискам юзеров

а) доступ к списку участников форума

Аргумент -> data
Значение -> userList

Возвращает массив с инфой об участниках форума.
По сути, это доступ к данным что отображаются здесь: /userlist.php
но всё-таки с большим количеством доступных данных.

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

http://forum.mybb.ru/api.php?data=userList

Ответ:

 [{"id":"2","login":"Admin","groupId":"1","groupTitle":"Администраторы","status":"без бороды и бубна","avatar":"/img/avatars/0000/14/1c/2-1248194534.gif","posts":"2555","registered":"1330839545","lastVizit":"1331839545"},
{"ключ":"значение","ключ":"значение" и т.д.},
{"ключ":"значение","ключ":"значение" и т.д.},
{"ключ":"значение","ключ":"значение" и т.д.},
и т.д.
]

Доп. параметры запроса:

Аргумент -> groupId
Значение -> id-шник группы
При не нулевом значении ограничивает массив ответа участниками какой-либо одной группы

0 или явное отсутствие в запросе - все группы
1 - админы, 2 - модеры, 3 гости, 4 юзеры и т.п.

Аргумент -> sort_by
Значение -> номер признака сортировки юзеров в массиве ответа
Указывает порядок расположения инфы в массиве ответа

0 или явно не указано в запросе - по UserID
1 - по алфавитному расположению логинов
2 - по времени регистрации в формате кол-ва сек с начала эпохи UNIX
4 - по времени последнего визита в формате кол-ва сек с начала эпохи UNIX
5 - по количеству сообщений

Аргумент -> sort_dir
Значение -> номер признака упорядочивания юзеров в массиве ответа
Указывает принцип упорядочивания инфы в массиве ответа

0 или явно не указано - по возрастанию
1 - по убыванию

Аргумент -> timeVizit
Значение -> число секунд
Ограничивает массив ответа участниками что были последних раз на форуме не позднее заданного (значением в запросе) числа секунд назад.

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

http://forum.mybb.ru/api.php?data=userList&timeVizit=3600

Ответом будет массив с инфой об участниках, которые были на форуме в течении одного часа до момента запроса.
Т.е.:

Массив будет иметь сортировку по UserID, упорядочивание по возрастанию, т.к. значения сортировки и упорядочивания явно не указаны.

Аргумент -> max
Значение -> максимальное кол-во юзеров выводимых в массиве
Ограничивает в массиве ответа количество данных об участниках, по кол-ву участников

Используемые ключи:
id - UserID
login - логин
groupId - идентификационный номер группы
groupTitle - название группы
status - статус участника
avatar - относительный путь к аватару "/img/avatars/0000/*********.jpg", если не установлен - пустая текст. строка
posts - число постов данного юзера
registered - дата регистрации на форуме (для гл. админа момент создания форума) в секундах от начала эпохи UNIX
lastVizit - дата последнего визита в секундах от начала эпохи UNIX

Получение только нужных данных в массиве
Это возможно при использовании доп. аргументов со значением 1.

Примеры:

Запрос:

http://forum.mybb.ru/api.php?data=userList&login=1

Ответ:

[{"login":"Admin"},
{"login":"Dron"},
{"login":"Priest"},
и т.д.
]

В ответе массив логинов всех зарегистрированных участников форума, сортировка по умолчанию (UserID), упорядочивание по умолчанию (возрастание).

Запрос:

http://forum.mybb.ru/api.php?data=userList&groupId=2&login=1

Ответ:

[{"login":"Le$vEr"},
{"login":".Slip"},
{"login":"prizrak"},
{"login":"Bendernative"},
{"login":"[M.@.t.r.i.x]"},
{"login":"mkusher"},
{"login":"Impuls 101"},
{"login":"Romul"}]

В ответе массив логинов членов группы Модераторы,  сортировка по умолчанию т.е. по UserID, упорядочивание по умолчанию, т.е. по возрастанию.

----------------------

б) доступ к списку посетителей форума, находящихся онлайн
Т.е. доступ к инфе отсюда: /online.php

Аргумент -> data
Значение -> userOnline

Возвращает массив со доступной информацией о посетителях форума, находящихся онлайн.
Сортировка в массиве осуществляется по времени последнего действия, упорядочивание по убыванию.

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

http://forum.mybb.ru/api.php?data=userOnline

Ответ:

[{"id":"2", "login":"Admin","groupId":"2","ip":"","avatar":"/img/avatars/0000/14/1c/2-1248194534.gif","lastAction":"<a href="http://forum.mybb.ru/">Админит с форумами</a>","time":"1331839553"},
{"id":"11", "login":"Dron","groupId":"4","ip":"","avatar":"/img/avatars/0000/********.gif","lastAction":"Читает тему: <a href="http://forum.mybb.ru/viewtopic.php?id=30011">НескончаеМЫе общие вопросы от новичков (37)</a>","time":"1331839530"},
{"id":"12", "login":"Priest","groupId":"4","ip":"","avatar":"/img/avatars/0000/*******.gif","lastAction":"В форуме: <a href="http://forum.mybb.ru/viewforum.php?id=16">Новые возможности форумов</a>","time":"1331839510"},
и т.д.
]

Используемые ключи:
id - номер идентификатора участника, у Гостя - 1
login - логин участника, у гостя - Гость
status - статус участника; у гостя пустая текст. строка, если статус не установлен гостям в Администрирование / Группы
groupId - идентификационный номер группы
ip - айпи-адрес (ай-пи возвращается только членам гр. Админ., остальные получают пустую тект. строку.
Т.е. тут нужен учёт авторизованной сессии: если есть сессия участника форума и юзер гр. Админ - передавать айпи-адрес. Всем остальным - модераторам, простым юзерам и гостям - пустая текст. строка)
avatar - относительный путь к аватару "/img/avatars/0000/*********.jpg", у гостя и тех, у кого авик не установлен - пустая текст. строка
lastAction - описание действия + ссылка, т.е. "Действие <a href="http://*******">*******</a>"
timeAction - дата последнего действия в секундах от начала эпохи UNIX

Получение только нужных данных
Это возможно при использовании доп. аргументов со значением 1.

Примеры:
Запрос:

http://forum.mybb.ru/api.php?data=userOnline&login=1

Ответ:

[{"login":"Admin"},
{"login":"Dron"},
{"login":"Priest"},
и т.д.
]

Запрос:

http://forum.mybb.ru/api.php?data=userOnline&login=1&lastAction=1

Ответ:

[{"login":"Admin","lastAction":"<a href="http://forum.mybb.ru/">Админит с форумами</a>"},
{"login":"Dron","lastAction":"Читает тему: <a href="http://forum.mybb.ru/viewtopic.php?id=30011">НескончаеМЫе общие вопросы от новичков (37)</a>"},
{"login":"Priest","lastAction":"В форуме: <a href="http://forum.mybb.ru/viewforum.php?id=16">Новые возможности форумов</a>"},
и т.д.
]

-------------------------------

в) доступ к списку участников форума, давших оценку конкретному посту
Т.е. примерно эту инфу - http://forum.mybb.ru/respect.php?id=2 , но не для всех постов, а только для выбранного поста путём передачи в запросе обязательного аргумента  postId со значением равным идентификационному номеру поста.

Аргумент -> data
Значение -> patingPost

Аргумент -> postId - обязательный аргумент в запросе
Значение -> идентификационный номер поста

Возвращает массив с информацией об участниках форума, давших оценку определённому посту.
Сортировка по дате оценки, упорядочивание по убыванию.

Пример:

Запрос:

http://forum.mybb.ru/api.php?data=ratingPost&postId=746501

Ответ:

[{"id":"20753", "login":"geka996", "avatar":"/img/avatars/0000/********.gif", "rating":"1", "time":"1331839553"},
{"id":"22787", "login":"Deff", "avatar":"/img/avatars/0000/********.gif", "rating":"1", "time":"1331839530"}]

Используемые ключи:
id - номер идентификатора участника
status - статус участника
avatar - относительный путь к аватару строкой, т.е. "/img/avatars/********.jpg"; если не установлен аватар, то пустая текст. строка
time - дата выставления оценки в секундах от начала эпохи UNIX
rating - оценка: "1" если положит., и "-1" если отриц.

Получение только нужных данных
Это возможно при использовании доп. аргументов со значением 1.

Примеры:
Запрос:

http://forum.mybb.ru/api.php?data=ratingPost&postId=746501&id=1&login=1&rating=1

Ответ:

[{"id":"20753", "login":"geka996", "rating":"1"},
{"id":"22787", "login":"Deff", "rating":"1"}]

Отредактировано RUSSIAN_GOBLIN (Пт, 16 Мар 2012 12:07:11)

Внимание - исправление!

Дополнение к: 2. Доступ к информации об участнике форума
Часть: доступ по UserLogin

Перед отправкой get-запросом логина, он должен быть кодирован с помощью метода Base64:

Код метода:

<script type="text/javascript">
var Base64 = {
   _keyStr : "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=",
    encode : function (input) {
      var output = "";
      var chr1, chr2, chr3, enc1, enc2, enc3, enc4;
      var i = 0
         while (i < input.length) {
       chr1 = input.charCodeAt(i++);
        chr2 = input.charCodeAt(i++);
        chr3 = input.charCodeAt(i++);
       enc1 = chr1 >> 2;
        enc2 = ((chr1 & 3) << 4) | (chr2 >> 4);
        enc3 = ((chr2 & 15) << 2) | (chr3 >> 6);
        enc4 = chr3 & 63;
       if( isNaN(chr2) ) {
           enc3 = enc4 = 64;
        }else if( isNaN(chr3) ){
          enc4 = 64;
        }
       output = output +
        this._keyStr.charAt(enc1) + this._keyStr.charAt(enc2) +
        this._keyStr.charAt(enc3) + this._keyStr.charAt(enc4);
     }
      return output;
    }
}
</script>

Пример вызова:

<script type="text/javascript">
var mylogin = 'Неадекватный адекват';
$.getJSON("api.php", { data: "user", login: Base64.encode(mylogin)  }, function(json) {
      //тут получение инфы об юзере и манипуляции с инфой...
    });
</script>

На сервере, логин должен быть раскодирован функцией языка PHP - base64_decode();

Это всё из-за того что в логине могут быть пробелы, русские символы и спецсимволы   
Хотя может Admin придумает другое решение, что-нибудь поудачней 

Опиши что это поподробней в ЛС.

Дык вроде бы нет в PHP функции для расшифровки этого.
Кажется:  rawurldecode(); и urldecode(); не так расшифровывают, как расшифровывает в javascript функция decodeURIComponent();