API для партнёров
Размещение заявок на бирже из своей системы. Один обязательный метод, остальное - справочники.
Коротко
- Адрес:
https://masterchpch.ru/api.php - Метод выбирается параметром
?r=(или путём/api.php/v1/orders). - Ключ в заголовке
Authorization: Bearer chp_live_…либоX-Api-Key. - Тело запроса - JSON в UTF-8. Ответ всегда JSON с полем
ok. - Ключ выпускается в кабинете, раздел Интеграции.
Заявки, созданные через 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"}
| HTTP | error | Что делать |
|---|---|---|
| 401 | unauthorized |
Ключ не передан, отозван или аккаунт заблокирован. |
| 403 | not_verified |
Не пройдена проверка документов. Один раз, в кабинете. |
| 422 | city_unknown, category_unknown |
Город или оффер не найдены. Сверьтесь со справочниками. |
| 422 | phone_bad | Телефон не похож на российский номер. |
| 422 | title_short, descr_short |
Слишком короткий текст: мастер по нему не решит, ехать ли. |
| 422 | price_low, price_high, price_over_cap |
Цена вне коридора оффера или выше потолка вашего уровня. |
| 429 | too_many_open, publish_gap |
Уперлись в лимит открытых заявок или в паузу между публикациями. |
| 400 | bad_json | Тело не разобралось. Проверьте UTF-8 и запятые. |
Что важно знать
- Уведомление мастерам уходит в течение минуты, а не в момент ответа API. Ответ приходит сразу - ждать рассылки не нужно. Раньше заявку всё равно не купить: первые минуты работают окна раннего доступа по тарифам.
- Повторную отправку мы не склеиваем. Пришлёте ту же заявку дважды - на бирже будет две. Дубли мастера отмечают как брак, и это бьёт по вашей репутации, поэтому следите за этим на своей стороне.
- Ключ - это доступ к публикации от вашего имени. Держите его на сервере, не в браузере и не в мобильном приложении.
- Вебхуков о выкупе пока нет: узнать судьбу заявки можно опросом
?r=orders/{id}. Если они вам нужны - напишите, сделаем.
Вопросы по интеграции - в поддержку или лично @therealtigus.