# Сети-партнеры
# Создание площадок для сетей-партнеров  <span id="creating-ad-spaces" />

*   Перед началом работы с API для сетей-партнеров попросите менеджера добавить метку «subnetwork» к вашему аккаунту веб-мастера в Admitad.
*   Для использования метода нужно получить ключ доступа access\_token. [Описание авторизации](/article/ru/304)
*   В параметре scope нужно передавать название прав «manage\_websites».

## Параметры <span id="parametrs-creating" />

| HTTP-метод | Права доступа                                                                                   | URL                                                     | Примечание                                                                       |
| ---------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------- |
| POST       | [manage\_websites](/article/ru/308#manage-websites) | https://api.admitad.com/subnetworks/v1/websites/create/ | Формат данных запроса application/json                                           |
|            |                                                                                                 |                                                         | Возвращает созданную площадку или информацию об ошибках валидации в формате JSON |

## Список параметров для запроса <span id="list-creating" />

Запрос принимает в body список json-объектов с параметрами площадки, которую нужно создать.

| Название     | Type              | Обязательный | Ограничения параметров          | Примечание, допустимые значения                                                                                                                                                                                                                      |
| ------------ | ----------------- | ------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name         | string            |              | Максимальная длина 200 символов |                                                                                                                                                                                                                                                      |
| url          | string            |              | Максимальная длина 255 символов |                                                                                                                                                                                                                                                      |
| category     | array of integers |              |                                 | [Категории партнерских программ](/article/ru/316#categories-of-affiliate-programs)                                                                                                                       |
| region       | array of strings  |              |                                 | [Регионы площадок](/article/ru/316#ad-space-regions)                                                                                                                                                     |
| native\_kind | string            |              |                                 | [Типы площадок](/article/ru/316#types-of-ad-spaces) |

## Пример запроса для создания 3 площадок <span id="example-creating-ad-spaces" />

```
curl -i -L -H 'Authorization: Bearer ${ACCESS_TOKEN_HERE}' -H "Content-Type: application/json" -X POST  

http://api.admitad.com/subnetworks/v1/websites/create/ -d '[{ "name": "Test subnetwork with native 615125QCQ",  

"native_kind":"social_network_other", "url": "https://example1.com/", "region": ["RU","BY"]}, { "name": "Test subnetwork with native 623225QQC", "native_kind":"social_network_other","url": "https://example1.com/",  

"region": ["UA", "GB"]}, { "name": "Test subnetwork with native 73135QCQ",  

"native_kind":"social_network_other", "url": "https://example1.com/", "category": [1,2,3], "region": ["US",  

"CN"]}]'
```

## Пример ответа при успешной обработке запроса <span id="example-response-successful-request" />

Если запрос обработан успешно, в качестве ответа будет возвращен json-объект с созданным ключом, где ключ — это индекс площадки, переданной в запросе, а значение — объект созданной площадки.

```
HTTP/1.1 200 OK  
{  
  "0": {  
    "status": "active",  
    "kind": "subnetwork",  
    "is_old": false,  
    "account_id": "",  
    "verification_code": "8dfcc8fec5",  
    "creation_date": "2020-12-02T17:15:28",  
    "id": 349022,  
    "site_url": "https://example1.com/",  
    "validation_passed": false,  
    "name": "Test subnetwork with native 61",  
    "is_lite": false  
  },  
  "1": {  
    "status": "active",  
    "kind": "subnetwork",  
    "is_old": false,  
    "account_id": "",  
    "verification_code": "8c6210ac87",  
    "creation_date": "2020-12-02T17:15:28",  
    "id": 349023,  
    "site_url": "https://example1.com/",  
    "validation_passed": false,  
    "name": "Test subnetwork with native 62",  
    "is_lite": false  
  },  
  "2": {  
    "status": "active",  
    "kind": "subnetwork",  
    "is_old": false,  
    "account_id": "",  
    "verification_code": "a82bdc1022",  
    "creation_date": "2020-12-02T17:15:28",  
    "id": 349024,  
    "site_url": "https://example1.com/",  
    "validation_passed": false,  
    "name": "Test subnetwork with native 73",  
    "is_lite": false  
  }  
}
```

**Важно:**

*   Если хотя бы для одной из площадок сети-партнера в параметре передается невалидное значение, то запрос не будет обработан, и ни одна из площадок не будет создана.
*   При успешном создании площадок будет создана отложенная задача на подключение всех созданных площадок сети-партнера ко всем партнерским программам, к которым подключена основная площадка сети-партнера. Для фактического подключения созданных площадок может потребоваться некоторое время (обычно не больше пары минут).

## Пример ответа при невалидном запросе <span id="example-invalid-request" />

Ответ будет возвращен в виде json-объекта.

```
HTTP/1.1 400 Bad Request  
{  
  "0": {  
    "name": [  
      "У вас уже есть площадка с таким названием"  
    ]  
  },  
  "1": {  
    "name": [  
      "У вас уже есть площадка с таким названием"  
    ]  
  },  
  "2": {  
    "name": [  
      "У вас уже есть площадка с таким названием"  
    ]  
  }  
}
```

## Пример ответа при частично невалидном запросе <span id="example-partially-invalid-request" />

```
HTTP/1.1 400 Bad Request  
{  
  "0": "ok",  
  "1": "ok",  
  "2": {  
    "name": [  
      "У вас уже есть площадка с таким названием"  
    ]  
  }
```

# Статус подключения площадки сети-партнера к партнерской программе <span id="status-of-connecting-ad-space" />

*   Перед началом работы с API для сетей-партнеров попросите менеджера добавить метку «subnetwork» к вашему аккаунту веб-мастера в Admitad.
*   Для использования метода нужно получить ключ доступа access\_token. [Описание авторизации](/article/ru/304)
*   В параметре scope нужно передавать название прав «advcampaigns\_for\_website».

## Параметры <span id="parameters-status" />

| HTTP-метод | Права доступа                                                                                                      | URL                                                                            | Примечание                                                                                                                                                       |
| ---------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET        | [advcampaigns\_for\_website](/article/ru/308#advcampaigns-for-website) | http://api.admitad.com/subnetworks/v1/advcampaign/${ADVCAMPAIGN\_ID}/statuses/ | ${ADVCAMPAIGN\_ID}— ID партнерской программы для получения статусов и ссылок                                                                                     |
|            |                                                                                                                    |                                                                                | Возвращает информацию о статусе подключения площадки к программе в формате JSON, а также goto-ссылку, обогащенную инструментом, если статус подключения активный |

*   В параметре websites\_id нужно передавать ID площадок, разделенные запятыми.
*   Параметр websites\_id не может содержать больше 30 ID площадок.

## Пример запроса для получения статуса подключения площадки к программе <span id="example-request-ad-space-status" />

```
curl -L -H 'Authorization: Bearer ${ACCESS_TOKEN}' -X GET  
https://api.admitad.com/subnetworks/v1/advcampaign/${ID_ADVCAMPAIGN}/statuses/\?  
websites_id\=349001,349004
```

## Пример ответа в формате JSON <span id="h_01HZPQN62RN0C90MD94XNSENDQ" />

```
HTTP/1.1 200 OK  
[  
  {  
    "gotolink": "http://192.168.50.1:5000/g/xxmfo49zqsfbe235de1202e3d93061/?i=15",  
    "connection_status": "active",  
    "website_id": 349001,  
    "advcampaign_id": 15939  
  },  
  {  
    "gotolink": "",  
    "connection_status": "disabled",  
    "website_id": 349004,  
    "advcampaign_id": 15939  
  }  
]
```