Начало работы с Mozscape API

Я новичок в SEOmoz, и один из проектов, над которым я работаю, — это улучшение вики-контента Mozscape API, чтобы вам было легче узнать, как получить доступ ко всем интересным данным, доступным через Mozscape API.

Я решил вскочить и попытаться разобраться. Мой первоначальный план состоял в том, чтобы не обманывать … то есть не использовать помощь, которую я имею как сотрудник, которая недоступна большинству пользователей API. Но я застрял, поэтому мне пришлось изменить правила … Вы ведь слышали о Кальвинболле, верно? Я ввел новое правило, согласно которому я могу жульничать, пока делюсь.

Присоединение к игре

Я уже записался, так как работаю здесь, но это не сложно. Если вы еще не являетесь участником, перейдите на эту страницу и либо подпишитесь на бесплатную пробную версию PRO, либо зарегистрируйтесь в сообществе SEOmoz. Оба они предоставляют вам доступ к бесплатной версии API Mozscape. Если вам нравится то, что вы видите, и вы хотите больше запросов и полный доступ к API, подробности о том, что доступно, можно найти на нашей странице цен на API.

Получение моего секретного ключа API SEOmoz

Эта деталь подошла бы прямо к Кельвину Боллу … Я получил секретный ключ! После входа в систему на странице «Начало работы» отображается раздел «Создание учетных данных API». Я не знал, что добавить в раздел «Ваш идентификатор доступа», поэтому просто нажал кнопку. Затем пришлось согласиться с условиями обслуживания, щелкнуть их еще раз, и вуаля, у меня есть свой идентификатор доступа и секретный ключ.

Совет # 1: Вы не вводите свой идентификатор доступа, мы его генерируем. Просто прочтите наши условия обслуживания, установите флажок, подтверждающий их согласие, а затем нажмите Создать секретный ключ кнопку (или Регенерировать, если вы уже сделали это один раз).

Секретные ключи, подписи и подписанная аутентификация, о боже!

Когда я посмотрел на создание своего первого запроса API, я полностью остановился, пытаясь выяснить, как аутентифицировать свой запрос. Мои проблемы были полностью вызваны мной, но мне пришлось прибегнуть к обману, чтобы преодолеть их.

Чит №1 — Обращение за помощью к внутреннему гуру

Я начал читать форумы, и сейчас проблема номер один на форумах — это неудачная аутентификация. Перед тем, как начать это упражнение, я прочитал сообщение на форуме, в котором говорилось, что пример аутентификации на странице «Начало работы» устарел и больше не является рекомендуемым способом работы.

Это привело меня к тому, что я проигнорировал то, что на самом деле говорилось на этой странице, и попробовал всевозможные вещи для создания Unix Timestamp и Valid Signature самостоятельно, когда они все время находились передо мной. Чтобы вернуть меня в нужное русло, потребовалось поговорить с людьми здесь.

Совет №2. Помните, что форумы представляют собой момент времени. Мы что-то меняли и исправляли, и то, что вы читаете на форумах, * могло * быть устаревшим. Мы заметили, что образец был плохим, написали об этом на форумах, а затем исправили его, что означает, что сообщение на форуме устарело.

Образец действительной подписи API действительно является действительной подписью API

После описанного выше и моего первого обмана я понял, что Образец действительной подписи API на самом деле является подлинной, действительной подписью API №1 и позволяет мне сразу же делать запрос.

Итак, я смог использовать образец запроса на странице «Начало работы», чтобы получить правильный идентификатор участника, отметку времени и подпись в правильном формате.

Совет № 3 и 4:

• Если вы мучились после получения секретного ключа (как и я), вам нужно обновить страницу, чтобы обновить метку времени. Отметка времени на образце действительна только около 5 минут.

• Ваша подпись должна быть в формате base64, а затем в кодировке URL. Вот почему строка «Подпись» на странице «Приступая к работе» немного отличается от закодированной для вас подписи в образце запроса. Убедитесь, что вы используете строку запроса образца.

Показатели URL для победы

Как только я понял, что подписанная аутентификация была предоставлена ​​мне в образце запроса, я просто использовал документацию вики для изменения запроса на URL и метрики, которые я хотел. URL был легким; Я просто изменил веб-сайт в образце запроса с «www.seomoz.org & 2fblog» на веб-сайт моего местного общепита.

Затем, поскольку в примере запроса используется вызов API URL-метрик, я посмотрел, как добавить нужные мне метрики URL-адресов, на вики-страницу API-интерфейсов URL-метрик. Я выбрал эти показатели:

Добавление всех битовых флагов для них дает мне 2061. Поэтому я ввел 2061 в параметр Cols.

Чит №2 — Предусмотренные знания

Поскольку я здесь чуть больше месяца, я уже просмотрел страницу API метрик URL и работал над улучшением содержания там. Итак, я уже знал, как использовать параметр Cols и как складывать битовые флаги, чтобы получить нужные мне показатели.

Гоббс получает данные связи

Все вышеперечисленные модификации Образца запроса дали мне мой первый рабочий запрос:

http://lsapi.seomoz.com/linkscape/url-metrics/www.snoislefoods.coop?Cols=2061&AccessID=&Expires=&Signature=

Я поместил его в новое окно браузера, нажал Enter и получил свой первый ответ:

{«ufq»: «www.snoislefoods.coop/»,»uid»:864,»ut»:»Organic Produce Co op, Natural Food Cooperative | Sno-Isle Natural Foods Co-op Everett WA», «uu»: «www.snoislefoods.coop/»}

Успех! Я использовал таблицу на странице API метрик URL (отрывок выше), чтобы интерпретировать данные моих ссылок.

Изменение правил

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

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

Если у вас есть предложения, истории успеха или действительно хорошие читы, я хотел бы услышать от вас. Электронная почта [email protected].

Лиза — Мозстафф