Mail.RuПочтаМой МирОдноклассникиИгрыЗнакомстваНовостиПоискВсе проекты
Регистрация сайта и управление

Регистрация сайта

url: http://top.mail.ru/json/add

Параметр Обязательно Описание
apikey да Ключ к API, требуется для регистрации сайтов. Для получения ключа напишите нам в https://top.mail.ru/feedback
category нет Опционально, требуется в случае участия в рейтинге (rating=1). Для участия в рейтинге выберите наиболее подходящую для Вашего ресурса категорию рейтинга @Mail.ru. Правильный выбор категории обеспечит Вам наибольший приток целевой аудитории со страниц рейтинга @Mail.ru. А также поможет сравнить популярность своего ресурса с популярностью ресурсов конкурентов.
email да Адрес электронной почты, по которому Вам будет выслано подтверждение регистрации счётчика, его ID. Если Вы забудете свой пароль, то сервер сможет выслать Вам его по этому адресу. Также в случае значительной реорганизации рейтинга @Mail.ru по этому адресу Вам может быть послано уведомление. Этот адрес не будет показываться на общедоступных страницах рейтинга @Mail.ru.
ignore_url_warn нет
Игнорирование ограничения на регистрацию нескольких счетчиков на один домен: ignore_url_warn=yes
password да

Пароль Вам понадобится, если Вы захотите изменить какие-либо параметры счётчика или удалить свой ресурс из рейтинга @Mail.ru. Также Вы можете закрыть свободный доступ к статистике по Вашему ресурсу - эта статистика будет доступна по паролю.

Во избежание различных проблем с кодировками в пароле можно использовать только цифры, латинские буквы и символы _-+/*^%=~#$@:;.,!?{}()[]. Прописные и строчные буквы различаются. Не менее 7 и не более 15 символов.

public да
Открытость статистики: 0 (нет) или 1 (да). Вы можете запретить просмотр подробной статистики Вашего ресурса другими пользователями (общедоступной будет только информация о количестве визитов и посетителей, показываемая на страницах рейтинга @Mail.ru). Для доступа к подробной статистике Вы должны будете использовать свой пароль, введённый выше.
После регистрации вы сможете настроить разрешение или запрет просмотра каждого вида отчета по отдельности.
rating да
Участие в рейтинге: 0 (нет) или 1 (да). Участие в рейтинге не влияет на сбор и показ статистики ресурса.
title да
Название сайта, будет выводиться на страницах Рейтинг@Mail.ru и в заголовке страниц статистики по ресурсу.
В названии должно быть не более 60 символов. Разрешены русские и латинские буквы нижнего и верхнего регистров, цифры, пробел и символы _ + / = & ! @ * : % . , ? ; ~ # " ' ( ) [ ] { } -
url да
Адрес (URL), по которому расположен Ваш ресурс. Адрес должен начинаться с http://, не превышать 100 символов в длину и не должен содержать символа @ в имени домена.
Мы поддерживаем кириллические домены в адресе, Вам не нужно вводить их в Punycode.

 
Ответ
HTTP GET
{   
    "error" : STR,
    "id" : STR,
    "result" : STR
}
Описание полей
Имя
Описание
error

Описание ошибки.

Отсутствует если ошибки не было.

id

Номер нового счетчика(с.м. параметр &id).

Отсутствует если произошла ошибка.

result
Имя действия которое произошло, для /json/add это "result":"created".

Список категорий рейтинга

url: http://top.mail.ru/json/categories

Ответ содержит объект categories с массивом категорий, которые в свою очередь, имеют подкатегории.

Ответ
HTTP GET
{
    "categories" : [
    {
        "id" : STR,
        "number" : NUM,
        "name" : STR,
        "childs" : [
        {
            "id": STR,
            "name": STR
        },
        ...
        ],
    },
    ...
    ]
}
Описание полей
Имя
Описание

categories[].id

Уникальный идентификатор родительской категории.

categories[].number

Индекс категории.

categories[].name

Имя категории.

categories[].childs[].id

Уникальный идентификатор дочерней категории.

categories[].childs[].name

Имя дочерней категории.

Аутентификация 

url: http://top.mail.ru/json/login

Параметр Обязательно Описание
apikey нет
Ключ к API, требуется только при аутентификации по хешу от пароля.
session нет
Сессия, к которой привязывается доступ после успешной аутентификации. При отсутствии создается новый.
id да
id счетчика
password да
Пароль к счетчику. При аутентификации по хешу от пароля password не требуется, вместо него используется параметр ph.
action да  Управление ответом:
    • при action=redirect при корректной аутентификации редиректит на статистику счетчика, полезно для использования вместе с веб формой
    • при action=json все ответы в json

    Ответ содержит json объект, в utf-8. Наличии error показывает, что произошла ошибка. В случае успешной регистрации в action=json ответе будет "logged":"yes".

    Для аутентификации обязательны id,password.

      Ответ
      HTTP GET
      {   
          "error" : STR,
          "wrong" : STR,
          "id" : NUM,
          "session" : STR,
          "logged" : STR
      }
      Описание полей 
      Имя
      Описание
      error

      Описание ошибки. Отсутствует если ошибки не было.

      wrong

      Указание на место ошибки, к примеру, если указан неправильный &id - "wrong":"id".  Отсутствует если ошибки не было.

        id

      Уникальный идентификатор счетчика. Отсутствует если произошла ошибка.

      session
      Уникальный идентификатор сессии.
      logged

      "yes" - в случае успешной аутентификации, в другом случае отсутствует.

      Редактирование информации

      url: http://top.mail.ru/json/edit

      Параметр Обязательно Описание
      url нет
      Адрес (URL), по которому расположен Ваш ресурс. Адрес должен начинаться с http://, не превышать 100 символов в длину и не должен содержать символа @ в имени домена.
      Мы поддерживаем кириллические домены в адресе, Вам не нужно вводить их в Punycode.
      title нет
      Название сайта, будет выводиться на страницах Рейтинг@Mail.ru и в заголовке страниц статистики по ресурсу.
      В названии должно быть не более 60 символов. Разрешены русские и латинские буквы нижнего и верхнего регистров, цифры, пробел и символы _ + / = & ! @ * : % . , ? ; ~ # " ' ( ) [ ] { } -
      rating нет
      Участие в рейтинге: 0 (нет) или 1 (да). Участие в рейтинге не влияет на сбор и показ статистики ресурса.
      password или session да

      Пароль или сессия для авторизации

      pass_new нет

      Пароль Вам понадобится, если Вы захотите изменить какие-либо параметры счётчика или удалить свой ресурс из рейтинга @Mail.ru. Также Вы можете закрыть свободный доступ к статистике по Вашему ресурсу - эта статистика будет доступна по паролю.

      Во избежание различных проблем с кодировками в пароле можно использовать только цифры, латинские буквы и символы _-+/*^%=~#$@:;.,!?{}()[]. Прописные и строчные буквы различаются. Не менее 7 и не более 15 символов.

      id да
      ID счетчика
      email нет
      Адрес электронной почты, по которому Вам будет выслано подтверждение регистрации счётчика, его ID. Если Вы забудете свой пароль, то сервер сможет выслать Вам его по этому адресу. Также в случае значительной реорганизации рейтинга @Mail.ru по этому адресу Вам может быть послано уведомление. Этот адрес не будет показываться на общедоступных страницах рейтинга @Mail.ru.
      category нет
      Опционально, требуется в случае участия в рейтинге (rating=1). Для участия в рейтинге выберите наиболее подходящую для Вашего ресурса категорию рейтинга @Mail.ru. Правильный выбор категории обеспечит Вам наибольший приток целевой аудитории со страниц рейтинга @Mail.ru. А также поможет сравнить популярность своего ресурса с популярностью ресурсов конкурентов.

      Все параметры кроме id и password, опциональные. 

      Ответ
      HTTP GET
      {   
          "result" : STR,
          "error" : STR,
          "message" : STR
      }
      Описание полей 
      Имя
      Описание
      error

      Описание ошибки. Отсутствует если ошибки не было.

      result

      Имя действия которое произошло, для /json/edit это "result":"edited". Отсутствует если произошла ошибка.

      message

      Дополнительная информации о редактирование. Может отсутствовать.

      Код счетчика

      url: http://top.mail.ru/json/code

      Параметр Обязательно Описание
      id да ID счетчика
      mode Вид логотипа: nologo (без логотипа, только код), double (код и логотип)
      type_8 Номер картинки (http://top.mail.ru/table.html) или "wot"
      pagetype Тип страницы: html/xhtml

      В ответе будет 2 объекта, logo и code, с кодом для вставки.

      Ответ
      HTTP GET
      {
          "error" : STR,
          "code" : STR,
          "logo" : STR
      }
      Описание полей 
      Имя
      Описание
      error

      Описание ошибки. Отсутствует если ошибки не было.

      code

      Javascript код счетчикаОтсутствует если произошла ошибка.

      logo

      html код логотипа или null если &mode=nologo. Отсутствует если произошла ошибка.