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

Так же обращайте внимание на формат передачи данных, поля у всех рекламодателей максимально стандартизированы, но по некоторым полям у рекламодателей могут быть особенности или ограничения.

Обязательные параметры

Параметр Значение
product_group accounting

JSON

POST https://firano.cityads.com/api/rest/v2/applications.json

Данные по заявке передаются в теле запроса в формате JSON, в заголовках запроса передается Content-Type: application/json.

Формат ответа: JSON.

Параметры

Параметр Тип Обяз. Описание
Название Допустимое значение Пример
surname string да Фамилия Только русские буквы, дефисы и пробелы. "surname": "Иванов"
name string да Имя Только русские буквы, дефисы и пробелы. "name": "Иван"
mobile string да Мобильный телефон Номер в формате: +7(xxx)xxx-xx-xx "mobile": "+7(901)901-90-01"
is_agree_personal boolean да Согласие на обработку данных "is_agree_personal": true
patronymic string нет Отчество Только русские буквы, дефисы и пробелы. "patronymic": "Иванович"
birth_date date нет Дата рождения ≥ 14 лет "birth_date": "1990-01-01"
birth_place string нет Место рождения Только русские буквы, цифры, дефис, пробел и точка. "birth_place": "Москва"
gender enum нет Пол
Значение Описание
m Мужской
f Женский
"gender": "m"
phone string нет Телефон Номер в формате: +7(xxx)xxx-xx-xx "phone": "+7(901)901-90-01"
email string нет E-mail Домен 1-го уровня в email не может содержать цифры. "email": "test@test.ru"
is_rf_citizen string нет Гражданство РФ "is_rf_citizen": { "true": "да", "false": "нет" }
country string нет Страна "country": "Россия"
social_status enum нет Социальный статус
Значение Описание
working Работает
unemployed Безработный
retired Пенсионер
working_less_3_months Работает меньше 3-ех месяцев
working_informally Работает неофициально
businessman Предприниматель
"social_status": "working"
products array нет Продукты
Значение Описание
rko РКО, дебетовые карты
"products": [ "rko", "cash" ]
personal_code integer нет Персональный номер "personal_code": "12345567"
inn string нет ИНН 10 или 12 цифр "inn": "1234567899"
social_network string нет social_network "social_network": ""
secret_word string нет Кодовое слово, для ответа на звонок из банка "secret_word": "СЕКРЕТ"
snils string нет Номер свидетельства СНИЛС СНИЛС в формате xxx-xxx-xxx xx "snils": "123-456-789 12"
company_name string нет Название компании "company_name": "Рога и копыта"
ogrn string нет ОГРН 13 или 15 цифр "ogrn": "1234567890123"
address_live country_code enum нет Код страны проживания
Значение Описание
AU Австралия
AT Австрия
AZ Азербайджан
AX Аландские острова
AL Албания
DZ Алжир
VI Виргинские Острова (США)
AS Американское Самоа
AI Ангилья
AO Ангола
AD Андорра
AQ Антарктида
AG Антигуа и Барбуда
AR Аргентина
AM Армения
AW Аруба
AF Афганистан
BS Багамы
BD Бангладеш
BB Барбадос
BH Бахрейн
BZ Белиз
BY Белоруссия
BE Бельгия
BJ Бенин
BM Бермуды
BG Болгария
BO Боливия
BQ Бонэйр, Синт-Эстатиус и Саба
BA Босния и Герцеговина
BW Ботсвана
BR Бразилия
IO Британская территория в Индийском океане
VG Британские Виргинские острова
BN Бруней
BF Буркина-Фасо
BI Бурунди
BT Бутан
VU Вануату
VA Ватикан
GB Великобритания
HU Венгрия
VE Венесуэла
UM Внешние малые острова (США)
TL Восточный Тимор
VN Вьетнам
GA Габон
HT Гаити
GY Гайана
GM Гамбия
GH Гана
GP Гваделупа
GT Гватемала
GF Гвиана
GN Гвинея
GW Гвинея-Бисау
DE Германия
GG Гернси
GI Гибралтар
HN Гондурас
HK Гонконг
GD Гренада
GL Гренландия
GR Греция
GE Грузия
GU Гуам
DK Дания
JE Джерси
DJ Джибути
DM Доминика
DO Доминиканская Республика
CD Демократическая Республика Конго
EU Европейский союз
EG Египет
ZM Замбия
EH САДР
ZW Зимбабве
IL Израиль
IN Индия
ID Индонезия
JO Иордания
IQ Ирак
IR Иран
IE Ирландия
IS Исландия
ES Испания
IT Италия
YE Йемен
CV Кабо-Верде
KZ Казахстан
KY Острова Кайман
KH Камбоджа
CM Камерун
CA Канада
QA Катар
KE Кения
CY Кипр
KG Киргизия
KI Кирибати
TW Китайская Республика
KP КНДР (Корейская Народно-Демократическая Республика)
CN КНР (Китайская Народная Республика)
CC Кокосовые острова
CO Колумбия
KM Коморы
CR Коста-Рика
CI Кот-д’Ивуар
CU Куба
KW Кувейт
CW Кюрасао
LA Лаос
LV Латвия
LS Лесото
LR Либерия
LB Ливан
LY Ливия
LT Литва
LI Лихтенштейн
LU Люксембург
MU Маврикий
MR Мавритания
MG Мадагаскар
YT Майотта
MO Макао
MK Македония
MW Малави
MY Малайзия
ML Мали
MV Мальдивы
MT Мальта
MA Марокко
MQ Мартиника
MH Маршалловы Острова
MX Мексика
FM Микронезия
MZ Мозамбик
MD Молдавия
MC Монако
MN Монголия
MS Монтсеррат
MM Мьянма
NA Намибия
NR Науру
NP Непал
NE Нигер
NG Нигерия
NL Нидерланды
NI Никарагуа
NU Ниуэ
NZ Новая Зеландия
NC Новая Каледония
NO Норвегия
AE ОАЭ
OM Оман
BV Остров Буве
IM Остров Мэн
CK Острова Кука
NF Остров Норфолк
CX Остров Рождества
PN Острова Питкэрн
SH Острова Святой Елены, Вознесения и Тристан-да-Кунья
PK Пакистан
PW Палау
PS Государство Палестина
PA Панама
PG Папуа — Новая Гвинея
PY Парагвай
PE Перу
PL Польша
PT Португалия
PR Пуэрто-Рико
CG Республика Конго
KR Республика Корея
RE Реюньон
RU Россия
RW Руанда
RO Румыния
SV Сальвадор
WS Самоа
SM Сан-Марино
ST Сан-Томе и Принсипи
SA Саудовская Аравия
SZ Свазиленд
MP Северные Марианские Острова
SC Сейшельские Острова
BL Сен-Бартелеми
MF Сен-Мартен
PM Сен-Пьер и Микелон
SN Сенегал
VC Сент-Винсент и Гренадины
KN Сент-Китс и Невис
LC Сент-Люсия
RS Сербия
SG Сингапур
SX Синт-Мартен
SY Сирия
SK Словакия
SI Словения
SB Соломоновы Острова
SO Сомали
SD Судан
SU СССР (до сентября 1992 года)
SR Суринам
US США
SL Сьерра-Леоне
TJ Таджикистан
TH Таиланд
TZ Танзания
TC Тёркс и Кайкос
TG Того
TK Токелау
TO Тонга
TT Тринидад и Тобаго
TV Тувалу
TN Тунис
TM Туркмения
TR Турция
UG Уганда
UZ Узбекистан
UA Украина
WF Уоллис и Футуна
UY Уругвай
FO Фареры
FJ Фиджи
PH Филиппины
FI Финляндия
FK Фолклендские острова
FR Франция
PF Французская Полинезия
TF Французские Южные и Антарктические Территории
HM Херд и Макдональд
HR Хорватия
CF ЦАР
TD Чад
ME Черногория
CZ Чехия
CL Чили
CH Швейцария
SE Швеция
SJ Шпицберген и Ян-Майен
LK Шри-Ланка
EC Эквадор
GQ Экваториальная Гвинея
ER Эритрея
EE Эстония
ET Эфиопия
ZA ЮАР
GS Южная Георгия и Южные Сандвичевы Острова
SS Южный Судан
JM Ямайка
JP Япония
"address_live": { "country_code": "AU", "index": "124365", "region": 77, "area": "Ногинский район", "city": "Москва", "street": "Ленина", "housing": 3, "building": "3", "house": 32, "flat": 78, "start_date": "2000-01-01" }
index string нет Адрес проживания, индекс
region integer нет Адрес проживания, регион 2 первые цифры в коде КЛАДР записи. Ссылка на кладр: https://www.gnivc.ru/technical_support/classifiers_reference/kladr/
area string нет Адрес проживания, район
city string нет Адрес проживания, населенный пункт Код КЛАДР записи города или наименование города (на русском языке). Ссылка на КЛАДР: https://www.gnivc.ru/technical_support/classifiers_reference/kladr/
street string нет Адрес проживания, улица
housing integer нет Адрес проживания, корпус
building integer нет Адрес проживания, строение
house integer нет Адрес проживания, дом
flat integer нет Адрес проживания, квартира
start_date date нет Адрес проживания, дата начала проживания ГГГГ-ММ-ДД
address_reg index string нет Адрес регистрации, индекс "address_reg": { "index": "129075", "region": 77, "area": "Ногинский район", "city": "Москва", "street": "Ленина", "housing": 3, "building": "3", "house": 32, "flat": 78, "start_date": "2000-01-01", "country_code": "AU" }
region integer нет Адрес регистрации, регион 2 первые цифры в коде КЛАДР записи. Ссылка на кладр: https://www.gnivc.ru/technical_support/classifiers_reference/kladr/
area string нет Адрес регистрации, район
city string нет Адрес регистрации, населенный пункт Код КЛАДР записи города или наименование города (на русском языке). Ссылка на КЛАДР: https://www.gnivc.ru/technical_support/classifiers_reference/kladr/
street string нет Адрес регистрации, улица
housing integer нет Адрес регистрации, корпус
building integer нет Адрес регистрации, строение
house integer нет Адрес регистрации, дом
flat integer нет Адрес регистрации, квартира
start_date date нет Адрес регистрации, дата начала проживания ГГГГ-ММ-ДД
country_code enum нет Код страны проживания
Значение Описание
AU Австралия
AT Австрия
AZ Азербайджан
AX Аландские острова
AL Албания
DZ Алжир
VI Виргинские Острова (США)
AS Американское Самоа
AI Ангилья
AO Ангола
AD Андорра
AQ Антарктида
AG Антигуа и Барбуда
AR Аргентина
AM Армения
AW Аруба
AF Афганистан
BS Багамы
BD Бангладеш
BB Барбадос
BH Бахрейн
BZ Белиз
BY Белоруссия
BE Бельгия
BJ Бенин
BM Бермуды
BG Болгария
BO Боливия
BQ Бонэйр, Синт-Эстатиус и Саба
BA Босния и Герцеговина
BW Ботсвана
BR Бразилия
IO Британская территория в Индийском океане
VG Британские Виргинские острова
BN Бруней
BF Буркина-Фасо
BI Бурунди
BT Бутан
VU Вануату
VA Ватикан
GB Великобритания
HU Венгрия
VE Венесуэла
UM Внешние малые острова (США)
TL Восточный Тимор
VN Вьетнам
GA Габон
HT Гаити
GY Гайана
GM Гамбия
GH Гана
GP Гваделупа
GT Гватемала
GF Гвиана
GN Гвинея
GW Гвинея-Бисау
DE Германия
GG Гернси
GI Гибралтар
HN Гондурас
HK Гонконг
GD Гренада
GL Гренландия
GR Греция
GE Грузия
GU Гуам
DK Дания
JE Джерси
DJ Джибути
DM Доминика
DO Доминиканская Республика
CD Демократическая Республика Конго
EU Европейский союз
EG Египет
ZM Замбия
EH САДР
ZW Зимбабве
IL Израиль
IN Индия
ID Индонезия
JO Иордания
IQ Ирак
IR Иран
IE Ирландия
IS Исландия
ES Испания
IT Италия
YE Йемен
CV Кабо-Верде
KZ Казахстан
KY Острова Кайман
KH Камбоджа
CM Камерун
CA Канада
QA Катар
KE Кения
CY Кипр
KG Киргизия
KI Кирибати
TW Китайская Республика
KP КНДР (Корейская Народно-Демократическая Республика)
CN КНР (Китайская Народная Республика)
CC Кокосовые острова
CO Колумбия
KM Коморы
CR Коста-Рика
CI Кот-д’Ивуар
CU Куба
KW Кувейт
CW Кюрасао
LA Лаос
LV Латвия
LS Лесото
LR Либерия
LB Ливан
LY Ливия
LT Литва
LI Лихтенштейн
LU Люксембург
MU Маврикий
MR Мавритания
MG Мадагаскар
YT Майотта
MO Макао
MK Македония
MW Малави
MY Малайзия
ML Мали
MV Мальдивы
MT Мальта
MA Марокко
MQ Мартиника
MH Маршалловы Острова
MX Мексика
FM Микронезия
MZ Мозамбик
MD Молдавия
MC Монако
MN Монголия
MS Монтсеррат
MM Мьянма
NA Намибия
NR Науру
NP Непал
NE Нигер
NG Нигерия
NL Нидерланды
NI Никарагуа
NU Ниуэ
NZ Новая Зеландия
NC Новая Каледония
NO Норвегия
AE ОАЭ
OM Оман
BV Остров Буве
IM Остров Мэн
CK Острова Кука
NF Остров Норфолк
CX Остров Рождества
PN Острова Питкэрн
SH Острова Святой Елены, Вознесения и Тристан-да-Кунья
PK Пакистан
PW Палау
PS Государство Палестина
PA Панама
PG Папуа — Новая Гвинея
PY Парагвай
PE Перу
PL Польша
PT Португалия
PR Пуэрто-Рико
CG Республика Конго
KR Республика Корея
RE Реюньон
RU Россия
RW Руанда
RO Румыния
SV Сальвадор
WS Самоа
SM Сан-Марино
ST Сан-Томе и Принсипи
SA Саудовская Аравия
SZ Свазиленд
MP Северные Марианские Острова
SC Сейшельские Острова
BL Сен-Бартелеми
MF Сен-Мартен
PM Сен-Пьер и Микелон
SN Сенегал
VC Сент-Винсент и Гренадины
KN Сент-Китс и Невис
LC Сент-Люсия
RS Сербия
SG Сингапур
SX Синт-Мартен
SY Сирия
SK Словакия
SI Словения
SB Соломоновы Острова
SO Сомали
SD Судан
SU СССР (до сентября 1992 года)
SR Суринам
US США
SL Сьерра-Леоне
TJ Таджикистан
TH Таиланд
TZ Танзания
TC Тёркс и Кайкос
TG Того
TK Токелау
TO Тонга
TT Тринидад и Тобаго
TV Тувалу
TN Тунис
TM Туркмения
TR Турция
UG Уганда
UZ Узбекистан
UA Украина
WF Уоллис и Футуна
UY Уругвай
FO Фареры
FJ Фиджи
PH Филиппины
FI Финляндия
FK Фолклендские острова
FR Франция
PF Французская Полинезия
TF Французские Южные и Антарктические Территории
HM Херд и Макдональд
HR Хорватия
CF ЦАР
TD Чад
ME Черногория
CZ Чехия
CL Чили
CH Швейцария
SE Швеция
SJ Шпицберген и Ян-Майен
LK Шри-Ланка
EC Эквадор
GQ Экваториальная Гвинея
ER Эритрея
EE Эстония
ET Эфиопия
ZA ЮАР
GS Южная Георгия и Южные Сандвичевы Острова
SS Южный Судан
JM Ямайка
JP Япония
passport issue_by string нет Паспорт, выдан "passport": { "issue_by": "отделом УФМС России по Республике Марий Эл в городе Йошкар-Оле", "issue_code": "231-231", "issue_date": "1997-01-01", "number": 123142, "series": 2324, "issue_city": "Москва" }
issue_code string нет Паспорт, код подразделения Формат 000-000
issue_date date нет Паспорт, дата выдачи 1997-01-01 — 2024-12-26
number integer нет Паспорт, номер 6 цифр
series integer нет Паспорт, серия 4 цифры
issue_city string нет Паспорт, город выдачи
sub_id string нет Ваша разметка трафика. Может быть любое ваше значение до 255 символов "sub_id": ""
sub_id_2 string нет Ваша разметка трафика. Может быть любое ваше значение до 255 символов "sub_id_2": ""
sub_id_3 string нет Ваша разметка трафика. Может быть любое ваше значение до 255 символов "sub_id_3": ""
sub_id_4 string нет Ваша разметка трафика. Может быть любое ваше значение до 255 символов "sub_id_4": ""
sub_id_5 string нет Ваша разметка трафика. Может быть любое ваше значение до 255 символов "sub_id_5": ""

Пример

    $applicationData = '{"surname":"Иванов","name":"Иван","mobile":"+7(901)901-90-01","is_agree_personal":true}';

    $queryParams = [
        'wm_id' => 'ВАШ_WM_ID',
        'token' => 'ВАШ_TOKEN',
        'product_group' => 'accounting',
        'sandbox' => 1 // тестовый режим
    ];

    $url = 'https://firano.cityads.com/api/rest/v2/applications.json';

    $headers = [
        'Content-Type: application/json'
    ];

    $curl = curl_init($url . '?' . http_build_query($queryParams));
    curl_setopt($curl, CURLOPT_TIMEOUT, 50);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $applicationData);
    curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
    curl_setopt($curl, CURLOPT_MAXREDIRS, 3);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($curl, CURLOPT_HEADER, 1);

    $response = curl_exec($curl);

    var_dump($response); exit;