Скрипт для обмена данными – offline_main.php
в него через POST в параметр xmlfile передается текстовый
файл, содержащий XML-запрос с необходимыми инструкциями.

Кодировки

Файл с XML-запросом пока может быть передан в двух кодировках:
1. UTF-8
2. Windows-1251
Кодировка файла должна быть корректно указана в заголовке XML-запроса, иначе возможна потеря русских букв.

Передаваемые значения

Файл XML запроса содержит

Какие данные хочется получить
Какие данные хочется передать на сервер

Возвращаемые значения

Возвращается XML файл, содержащий

Те данные, которые хотелось получить
Результаты добавления тех данных, что были переданы

Пример XML-Запроса

<?xml version="1.0" encoding="windows-1251"?>
<QUERYS username="toto" password="789456" mainid="1">
 
<query QID="1" TYPE="17">
<id>4193934</id>
</query>
 
<query QID="1" TYPE="1">
<message>тестовое сообщение</message>
<headerofpost>тема</headerofpost>
<jpostid>34658</jpostid>
<attachfile>тема</attachfile>
<commentsubscribe>1</commentsubscribe>
</query>
</QUERYS>

Разные свойства

Свойства QID и mainid могут быть заданы произвольно. На выходе они будут выданы такими же, какими были даны при посылке данных на сервер. Нужны для ориентации в cобственных запросах при разборе полученных результатов.
Желательно сохранять регистр таким, какой он указан в данном руководстве.
Парметры типа commentsubscribe, parseurl и т.д., если их значение нулевое, лучше совсем не включать в запрос.
dpost передается в виде Unix Timestamp, т.е. это количество секунд с начала эпохи Unix. Считайте и не забывайте о смещении к Гринвичу
messagedate передается в формате «dd.mm.yyyy hh:mm:ss»
Максимальный размер сообщений: комментарий и в форум – 10 000 симв.
Максимальный размер сообщений: пост в дневник – 50 000 симв.

Типы сообщений:

1. Новый комментарий

message – Текст сообщения
headerofpost – Заголовок сообщения
jpostid – Индификатор поста куда отвечать
attachfile – Имя переменной где файл (необязательный параметр)
commentsubscribe – 1 если подписаться на ветку комментариев (если 0 то не подписываться)

2. Новый пост в форум

message – Текст сообщения
headerofpost – Заголовок сообщения
threadid – Индификатор форума куда пишем
parseurl – Переводить URL в ссылку

3. Новый пост в дневники

messagedate – Дата, от которой будет сохранено сообщение (на самом деле лучше не писать этот параметр, тогда сервер вернёт своё время)
message – Текст сообщения
headerofpost – Заголовок сообщения
parseurl – Переводить URL в ссылку
attachfile – Имя переменной где файл
nocomment – Признак без комментариев
privatepost – Признак закрытая запись
commentsubscribe – 1 если подписаться на ветку комментариев (если 0 то не подписываться)

4. Новое приватное сообщение

message – Текст сообщения
headerofpost – Заголовок сообщения
tousername – Имя кому приватное сообщение
parseurl – Переводить URL в ссылку

5. Списки друзей

action – add (добавление), del (удаление), get
worknick – Рабочий ник

6. Регистрация

Данная функция еще не документирована

7. Получить новые комментарии

dpost – Время последнего получения комментариев
maxpost – Количество комментариев для получения

8. Получить новые сообщение с форумов

dpost – Время последней скачивания
maxpost – Количество скачиваемых постов

9. Получение новых сообщений друзей

dpost – Время последнего получения сообщений друзей
maxpost – Количество сообщений друзей

10. Получение новых приватных сообщений

maxpost – Максимальное количество получаемых приватных сообщений

11. Получение новых смайлов

lastsmilieid – Последний скаченный смайлик

12. Получение всех комментариев к заданному сообщению

dpost – Время последней скачивания
maxpost – Количество скачиваемых постов

13. Получение CSS оформления дневника

* (расшифровки данной функции пока не готовы)

17. Получение одного комментария

id – Индефикатор комментария
parent_id отвечает за идентификатор родителя
parent_id0 – идентификатор родителя нулевого уровня (корня ветки)

Если (parent_id, parent_id0) нули – то это комментарий нулевого уровня.

commentnum – порядковый номер ветки, к которой принадлежит комментарий. (Позволяет вычислить, поделив нацело на 30, номер страницы, на которой находится комментарий и правильно сформировать к ней ссылку)

18. Получение одного поста с форума

id – Индефикатор поста

19. Получение одного сообщения друзей

id – Индефикатор сообщения

Список ошибок, возвращаемых скриптом:

2. Недостаточно параметров
3. Ошибка авторизации
4. Ошибка авторизации
5. Нет прав для добавления поста в дневник
6. Нет прав для добавления комментария
21. Разрешение только jpg gif
22. Не картинка
23. Файл слишком большой
24. Ошибка при закачке
31. Неверное имя (при добавлении приватного, или нового друга)
51. Получатель не может получать приватные (отключена возможность в настройках)
52. Слишком длинное сообщение
53. Нет непрочитанных приватных сообщений
61. Форум закрыт для постов
62. Сообщение превышает максимально допустимый объем
63. Защита от флуда (только что было добавлено такое же сообщение)

Вариант не окончательный. возможны дополнения по мере тестирования
формата обмена.

Предложения по доработке (новые запросы, ответы, ошибки)

Если у вас есть предложения – пишите их в этом разделе, программисты по мере доработки будут переносить новые реализованные функции в основное описание, если эти предложения разумны и аргументировать отказ от тех, которые программе не нужны.

Файлов нет. [Показать файлы/форму]