Описание системы команд
Работа с нашей системой производится с помощью системы команд. Ниже приведен их список и описание.
Вы также можете получить список комманд по электронной почте. Для этого отправьте письмо по адресу mailmarket@email.com, написав в теме письма GetCommands.
Subscribe (бывшая GetAll)
Unsubcribe (бывшая DontGetAll)
Для того, чтобы послать команду системе Mail Market Вам необходимо создать в Вашей почтовой программе письмо. В поле Кому (To) напишите mailmarket@email.com (запомните этот адрес, т.к. это основной адрес системы). В поле Тема (Subject) нужно написать команду (их список приведен выше). Далее, в теле сообщения первые две строки всегда должны быть MMID и Password. Эти строки содержат Ваш уникальный идентификатор в системе (он будет выслан Вам после регистрации) и пароль, соответсвенно. Эти данные необходимо использовать в целях безопасности, чтобы ни кто, кроме Вас не мог воспользоваться Вашей информацией. Вид этих строк следующий:
MMID: Ваш идентификатор
Password: Ваш пароль
Обратите внимание на регистр букв в названии полей - MMID пишется заглавными буквами, Password - пишется с заглавной буквы прописными (В последствии мы этот недостаток устраним. И вообще далее обращайте внимание на написание названий полей в примерах). После названия поля обязательно ставить двоеточие ":".
Небольшое техническое замечание. В данный момент система обрабатывает письма только в кодировке Win-1251 (BASE64, Quoted-printable). Эта кодировка используется по умолчанию в почтовых клиентах Microsoft - Internet Mail, Outlook Express, в других программах Вам, возможно, придется установить кодировку исходящих сообщений вручную.
Эта команда используется для размещения в базе объявления о покупке. Для этой команды в теле сообщения используются дополнительные поля. Ниже приведен список и описание этих полей:
Item: Что покупаете
Price: Цена
Currency: Валюта
Quantity: Количество
Comments: Коментарии
FreeDescr: Текст объявления в свободной форме.
Использование полей Price, Currency, Quantity, Comments необязательно, но обязательно использовать поля Item и FreeDescr, т.к. по полю Item производится анализ совпадений, а содержимое поля FreeDescr посылается пользователям в случае совпадения интересов. Необязательные поля зарезервированы для будущего использования.
Пример:
MMID:1
Password: 123456
Item: Сахар
Price: 180
Currency: руб.
Quantity: no limit
Comments: в мешках
FreeDescr: Куплю сахар в мешках по цене 180 руб. за мешок.
В ответ на эту команду система Mail Market посылает Вам письмо со справочной информацией. Эта команда не имеет ни каких полей, т.е. тело письма должно быть пустым.
Эта команда используется для размещения в базе объявления о поиске или предложении работы. Ниже приведены список полей и их описания (поля, выделенные красным цветом заполнять обязательно):
Type: Тип объявления Look - ищу работы, Offer - предлагаю работу
Position: Должность
Pay: размер зарплаты
Age: возраст (полных лет)
Sex: пол (M - мужской, W- женский, буквы латинские)
Married:Семейное положение (женат(замужем) - 1, не женат(не замужем) - 0)
Stage: стаж работы (в годах)
City:город
Permanent:постоянно или временно (1 или 0, соответственно)
FreeDescr:Текст объявления в свободной форме (одна строка, 255 символов)
Пример:
MMID:1
Password:123456
Type:Look
Position:програмист
Pay:500
Age:21
Sex:M
Married:1
Stage:2
City:Огромный
Permanent:0
FreeDescr:Ищу работу програмиста в городе Огромный, с зарплатой 500 $, по совместительству. Знаю Visual Basic, Visual C++, Delphi. Базы данных.
Вы можете использовать эту команду для того, чтобы послать сообщение любому пользователю системы, не зная его адреса электронной почты. Эта команда, кроме обязательных полей MMID и Password, имеет дополнительные поля TOMMID и BODY. Ниже их описание:
TOMMID: идентификатор пользователя, которому Вы хотите отправить сообщение
BODY: Текст сообщения. Может состоять только из одной строки.
Пример:
MMID:1
Password: 123456
TOMMID:2
BODY: Пожалуйста сообщите свой Email для дальнейших контактов.
Эта команда используется для размещения в базе объявления о продаже. Для этой команды в теле сообщения используются дополнительные поля. Ниже приведен список и описание этих полей:
Item: Что продаете
Price: Цена
Currency: Валюта
Quantity: Количество
Comments: Коментарии
FreeDescr: Текст объявления в свободной форме.
Использование полей Price, Currency, Quantity, Comments необязательно, но обязательно использовать поля Item и FreeDescr, т.к. по полю Item производится анализ совпадений, а содержимое поля FreeDescr посылается пользователям в случае совпадения интересов. Необязательные поля зарезервированы для будущего использования.
Пример:
MMID:1
Password: 123456
Item: Сахар
Price: 180
Currency: руб.
Quantity: no limit
Comments: в мешках
FreeDescr: Продается сахар в мешках по цене 180 руб. за мешок.
Команда Subscribe (бывшая GetAll)
Вы можете использовать эту команду если хотите, чтобы к Вам по электронной почте приходили все новые объявления, поступающие в базу данных, в независимости от того совпали Ваши интересы или нет. Команда не имеет дополнительных полей, только MMID и Password.
Используйте эту команду для того, чтобы отправить сообщение администратору. Эта команда не имеет полей, т.е. в теле сообщения Вы просто пишите сообщение администратору.
Команда Unsubscribe (бывшая DontGetAll)
Эту команду Вы можете использовать если не хотите, чтобы к Вам постоянно поступали по электронной почте новые объявления. У данной команды нет дополнительных полей, только MMID и Password.
Эта команда используется для регистрация пользователя в системе Mail Market. При использовании данной команды в начале сообщения не надо указывать MMID и Password (так как они Вам еще не известны;). Ниже приведен список полей регистрационного сообщения и их описание:
FirstName: Имя
MiddleName: Отчество
LastName: Фамилия
Email: адрес электронной почты
Password: пароль
Period: период регистрации, может принимать значения 1, 3, 6 или 12 (1 месяц, 3 месяца, полгода и год, соответсвенно)
Company: Наименование организации (необязательно)
Position: должность (необязательно)
ZIP: почтовый индекс
City: город
State: область
StreetAddress: адрес (улица, дом, квартира)
Homepage: домашняя страница в Интернет (необязательно)
ICQ: ICQ UIN (необязательно)
Phone: телефон, включая код города (необязательно)
Fax: факс, включая код города (необязательно)
Where: Ответ на вопрос - откуда Вы узнали о нашей системе? Это для статистики. (необязательно)
Comments: Коментарии, предложения (необязательно)
Конечно же желательно заполнение всех полей, но поля, заполнение которых невозможно (если у Вас нет домашней страницы или факса) можно не заполнять. Обязательно запомните пароль.
Пример:
FirstName: Петров
MiddleName: Иван
LastName: Сидорович
Email: ivan@petrov.ru
Password: MySecRetPaSsWord
Period: 3
Company: ЗАО "Петров и сын"
Position: генеральный директор
ZIP: 123456
City: Большой
State: Огромная
StreetAddress: ул. Хорошего человека, 12-34
Homepage: http://www.petrov.ru
ICQ: 1234567
Phone: (123) 12-34-56
Fax: (123) 12-34-57
Where: Нажал на баннер
Comments: Пока все OK.