Помощь"Одним щелчком: для программистов" / copi.ru:

<< вход

ячейка COPi
  создать новую
  редактировать
  забыли номер?
  забыли пароль?
  освободить

  VIP-услуги

на сайте
  списки
  чебурашка
  поиск
  фотографии
  статистика

информация
  ответы
  правила
  контакты

ваша кнопка

друзья COPi
  шутки, юмор
  выпить, закусить
  сон, сновидения
  карикатуры
  афоризмы

Помощь
"Одним щелчком: для программистов"

Внимание: сервис "одним щелчком" находится в стадии тестирования, поэтому возможны любые изменения, которые тут же буду отражены в этом документе.

Последняя редакция: 16.12.03, 11:20

Как устроена система автозаполнения анкеты.

На сайте-партнере, в регистрационную форму добавляются поля:

- COPi-номер/имя
- пароль для доступа к информации
- кнопка [заполнить]

Пользователь, имеющий COPi-ячейку, вводит свой номер и пароль, если требуется, после чего нажимает [заполнить]. Регистрационная форма тут же заполняется данными из COPi-анкеты "Одним щелчком".

Посмотреть, как это работает можно на странице: http://hostinfo.ru/forum/, в разделе "регистрация". Смело вводите свой номер и пароль доступа, если он у вас установлен.

Как происходит запрос данных.

Скрипт, обслуживающий регистрационную форму, делает http-запрос по адресу http://copi.ru/iface/copi/, передавая в качестве параметра к запросу следующие переменные с данными:

service_name (не обязательно) — название запрашивающего сервиса
service_pass — пароль запрашивающего сервиса

copi — номер или имя ячейки (первое поле формы)
copi_pass (может быть пустым) — пароль доступа к данным ячейки (второе поле формы)

w — список запрашиваемых полей

По этому запросу сервер COPi вернет список данных, разделенных кодом табуляции. После чего запрашивающий скрипт может "разрезать" полученную строку по символу табуляции и показать пользователю уже заполненную форму регистрации для ее последующего редактирования и подтверждения.

Теперь рассмотрим подробнее данные, передаваемые в запросе.

service_pass является обязательным параметром для идентификации запрашивающей стороны. Этот пароль высылается в ответ на email-заявку, которую следует направить по адресу click@copi.ru со следующими данными:

- русскоязычное название сайта или сервиса
- короткое англоязычное название
- URL ресурса
- email ответственного лица
- IP-адреса, с которых будет производиться запрос данных

Название, URL и email высылаются пользователю, если в настройках его анкеты стоит флаг "высылать уведомления о запросе данных". Остальные данные используются для авторизации запросов.

Авторизация производится по запрашивающему IP-адресу и паролю. Если сервис по тем или иным причинам имеет очень много различных IP-адресов, с которых могут производиться запросы или это партнер, которому COPi безоговорочно доверяет, вместо IP-источника и пароля может быть использована пара service_name + service_pass.

Если вы не знаете, с какого IP-адреса ваш сервер отправляет запросы, обратитесь из скрипта по адресу http://copi.ru/help/click/programmer/ip, эта страница вернет IP запрашивающей стороны.

В параметрах запроса copi и copi_pass, соответственно, передаются COPi-номер (или COPi-имя) и пароль, указанные пользователем.

Последняя переменная "w" должна содержать символические названия запрашиваемых данных, разделенных запятыми. Программист сам определяет, как именно данные нужны его сервису для автозаполнения полей формы.

На сегодняшний день можно запрашивать следующие данные:

'click_login' — логин
'click_email' — email-адрес
'click_hp' — домашняя страница (URL)

'click_yyyy' — год рождения
'click_mm' — месяц рождения
'click_dd' — день рождения

'click_icq' — номер ICQ
'click_fio' — ФИО
'click_odigo' — Odigo
'click_aolim' — AOL Messanger
'click_ym' — Yahoo Messanger
'click_msn' — MSN Messanger

'click_address' — адрес (страна, город)
'click_prof' — профессия
'click_hobby' — хобби

'click_sex' — пол
'click_signature' — автоматическая подпись к сообщениям

Соответственно, если для регистрации требуется указать логин, email и ФИО, то строка запрашиваемых данных будет выглядеть так: w=click_login,click_email,click_fio.

COPi вернет данные login, email и ФИО в том же порядке, разделив из табуляцией.

Если при запросе данных произошла какая-либо ошибка, вместо данные COPi возвращает "Error #n", где n — номер ошибки:

1 - запрет доступа, проверьте правильность COPi-номера и пароля
2 - запрошено неизвестное поле анкеты
3 - не активирован ваш COPi-сервис "одним щелчком": http://copi.ru/edit/click

4 - IP-адрес запрашивающего сервера не числится в списках партнеров COPi, обратитесь к администратору сайта
5 - предоставлен ошибочный партнерский идентификатор-пароль, обратитесь к администратору сайта

Ошибки 1, 2 и 3 адресованы к пользователю, а 4 и 5 к запрашивающему серверу.

Большая просьба к разработчикам — выводить пользователю не номера ошибок, а их словесное описание.

Для полной ясности рассмотрим конкретный пример запроса.

Дано:
- пароль запрашивающего сервиса: "mu-mu"
- пользователь ввел COPI-номер 1111
- пользователь ввел пароль доступа "gerasim"
- требуется получить поля: login, email, fio, hp.

Запрос:

http://copi.ru/iface/copi/?service_pass=mu-mu&copi=1111&copi_pass=gerasim&w=click_login,click_email,click_fio,click_hp

Если IP авторизован и пароли верны, ваш скрипт всегда получит строку данных для автозаполнения анкеты.

Если вам требуется получать каки-либо дополнительные данные из COPi-ячеек, обращайтесь под адресу click@copi.ru.

На сегодняшний день доступны готовые патчи для следующих популярных программных продуктов:

- форум phpBB ver 2.0.4.

Со всеми вопросами можно обращаться по адресу support@copi.ru