API для работы в MainLink

webmaster

Для получения полного списка операций щелкните здесь.

mlapi_AddSite

MLAPI: добавить новый сайт
вход: [Url] url домена (без http:// или https://), [Name] название сайта, [Description] описание сайта, [CategoryID] каталог сайта (см. справочники), [ScanSite] сканирование сайта при добавлении (true-сканировать, false-не сканировать), [ssl] - защищенный протокол (true, если сайт на https, или false)
выход: [0] неавторизован, [-1] некорректный урл домена, [-2] сайт с таким URL уже есть в базе, [-3] сайт недоступен, [-4] не добавлен (проблема с СУБД), [-5] письмо не отправлено, [-6] код не найден (или секьюрный файл не найден в коде, см. описание на сайте), [-7] проверьте название/описание (не более 100/1000символов) [целое] #ID добавленного сайта

Тест

Форма для тестирования доступна только для запросов от локальных компьютеров.

SOAP 1.1

В следующем примере показаны запрос и ответ SOAP 1.1. Вместо элементов-заполнителей следует подставить фактические значения.

POST /webmaster.asmx HTTP/1.1
Host: api.mainlink.ru
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://api.mainlink.ru/mlapi_AddSite"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <mlapi_AddSite xmlns="http://api.mainlink.ru/">
      <Url>string</Url>
      <Name>string</Name>
      <Description>string</Description>
      <CategoryID>int</CategoryID>
      <ScanSite>boolean</ScanSite>
      <ssl>boolean</ssl>
    </mlapi_AddSite>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <mlapi_AddSiteResponse xmlns="http://api.mainlink.ru/">
      <mlapi_AddSiteResult>int</mlapi_AddSiteResult>
    </mlapi_AddSiteResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

В следующем примере показаны запрос и ответ SOAP 1.2. Вместо элементов-заполнителей следует подставить фактические значения.

POST /webmaster.asmx HTTP/1.1
Host: api.mainlink.ru
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <mlapi_AddSite xmlns="http://api.mainlink.ru/">
      <Url>string</Url>
      <Name>string</Name>
      <Description>string</Description>
      <CategoryID>int</CategoryID>
      <ScanSite>boolean</ScanSite>
      <ssl>boolean</ssl>
    </mlapi_AddSite>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <mlapi_AddSiteResponse xmlns="http://api.mainlink.ru/">
      <mlapi_AddSiteResult>int</mlapi_AddSiteResult>
    </mlapi_AddSiteResponse>
  </soap12:Body>
</soap12:Envelope>