Документация

API для партнёров

Размещение заявок на бирже из своей системы. Один обязательный метод, остальное - справочники.

Стать партнёром

Коротко

Заявки, созданные через API, попадают на биржу по тем же правилам, что и заявки из формы на сайте: те же коридоры цен, та же квалификация, те же лимиты. Отдельных «API-условий» не существует.

Проверка ключа

curl -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  "https://masterchpch.ru/api.php?r=ping"
{"ok":true,"service":"chepochem",
 "you":{"id":45,"name":"Диспетчерская «Дом»","role":"partner"}}

Разместить заявку

POST /api.php?r=orders

curl -X POST "https://masterchpch.ru/api.php?r=orders" \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "city": "Ярославль",
    "category": "plumbing",
    "title": "Заменить смеситель на кухне",
    "description": "Смеситель течёт у основания, воду перекрыли. Свой смеситель есть.",
    "client_name": "Ольга",
    "client_phone": "+7 900 111-22-33",
    "address": "ул. Свободы, 12, кв. 40",
    "urgency": "today",
    "price": 1600,
    "is_qualified": true
  }'
{"ok":true,
 "order":{"id":2869,"status":"open","is_qualified":true,
          "price_start":1600,"price_floor":1400,"step":50,
          "expires_at":"2026-09-11 12:59:58",
          "url":"https://masterchpch.ru/order.php?id=2869"}}

Поля

ПолеОбяз.Что это
cityда Название города как в справочнике. Можно вместо него city_id.
categoryда Код вида работ (оффера). Можно вместо него category_id.
titleда Коротко, что нужно. От 3 символов. Это первое, что видит мастер.
descriptionда Подробности от клиента, от 10 символов. «Нужен мастер, позвоните» не берут.
client_phoneда Российский номер в любом виде: +79001112233, 89001112233, +7 900 111-22-33. Открывается мастеру только после оплаты.
client_nameнетИмя клиента.
addressнетАдрес. Тоже скрыт до оплаты.
is_qualifiedнет true (по умолчанию) - вы договорились с клиентом о визите. false - только контакт, договариваться будет мастер: цена до 1000 ₽, жизнь 120 мин, до 4 попыток. Отвечайте честно - мастер видит это до покупки.
priceнет Стартовая цена лида, ₽. Не указали - возьмём рекомендованную для оффера.
price_floorнет Ниже этой цены аукцион не опустится. По умолчанию - минимум оффера.
stepнетНа сколько ₽ дешевеет каждую минуту.
life_minutesнет Сколько заявка живёт на бирже, 5-180. По умолчанию 15. Исключение: у квалифицированной заявки (is_qualified: true) с urgency: date жизнь автоматически растягивается до needed_at, если это дальше, чем указано здесь.
urgencyнет now - мастер нужен сейчас, today - сегодня (по умолчанию), date - к сроку, тогда нужен needed_at.
needed_atнет Когда нужен мастер: 2026-09-15 14:00. Только при urgency: "date".

Справочники

Чтобы не угадывать города и коды офферов, спросите их у сервиса - они меняются.

curl -H "Authorization: Bearer ВАШ_КЛЮЧ" "https://masterchpch.ru/api.php?r=cities"
curl -H "Authorization: Bearer ВАШ_КЛЮЧ" "https://masterchpch.ru/api.php?r=categories"

Сейчас на бирже 64 городов и 12 видов работ. Вот часть офферов с коридорами цен:

КодВид работЦена лида, ₽Рекомендуем
plumbingСантехника 600-5000 1400
electricЭлектрика 600-5000 1400
of310b42Компьютерная помощь 600-5000 2600
bigobjectКрупные объекты 600-5000 2250
washerСтиральные машины 600-5000 1400
fridgeХолодильники 600-5000 1400
applianceПрочая бытовая техника 600-5000 1400
handymanМелкий ремонт, муж на час 600-5000 1400
cleaningУборка и вывоз 600-5000 1400
renovationРемонт под ключ 600-5000 2250
constructionКрупная стройка 600-10000 6500
oknОкна 600-5000 2800

Свои условия

GET /api.php?r=me - ваш уровень, комиссия сервиса, потолок цены и сколько заявок сейчас открыто. Полезно перед публикацией: если лимит открытых заявок исчерпан, новая не пройдёт.

Статус заявки

GET /api.php?r=orders/2869 - состояние своей заявки: выкуплена, сгорела, снята. Видны только ваши заявки.

{"ok":true,"order":{"id":2869,"status":"taken","taken":true,…}}

Значения status: open - на бирже, taken - выкуплена мастером, working - мастер поехал, done - заказ закрыт, expired - сгорела, никто не взял, failed - по не квал заявке не смогли договориться, cancelled - вы сняли её сами.

Ошибки

Если ok равно false, в ответе есть машинный код error, человеческий текст message и, когда применимо, поле field, из-за которого отказ.

{"ok":false,"error":"price_high",
 "message":"По офферу «Сантехника» цена лида не выше 5000 ₽.",
 "field":"start_price"}
HTTPerrorЧто делать
401unauthorized Ключ не передан, отозван или аккаунт заблокирован.
403not_verified Не пройдена проверка документов. Один раз, в кабинете.
422city_unknown, category_unknown Город или оффер не найдены. Сверьтесь со справочниками.
422phone_badТелефон не похож на российский номер.
422title_short, descr_short Слишком короткий текст: мастер по нему не решит, ехать ли.
422price_low, price_high, price_over_cap Цена вне коридора оффера или выше потолка вашего уровня.
429too_many_open, publish_gap Уперлись в лимит открытых заявок или в паузу между публикациями.
400bad_jsonТело не разобралось. Проверьте UTF-8 и запятые.

Что важно знать

Вопросы по интеграции - в поддержку или лично @therealtigus.