/expedition/start
Метод запускает экспедицию в указанном слоте с назначенными приёмами.
Приём остаётся у игрока и доступен в других активностях, но занят для остальных экспедиций до тех пор, пока награда за эту не будет забрана: блокировка снимается клеймом, а не окончанием таймера.
Основные условия привязаны к месту: условие expeditions.mainConditions с slotIndex = N проверяет приём, переданный на позиции N — звёздность не ниже minStars и цвет из colorGroups (пустой список означает любой цвет). Место без условия принимает любой приём. Дополнительное условие одно и относится ко всему набору: см. bonus_qualified в /expedition/list. Оно не проверяется на старте и не мешает запуску, а только решает, будет ли выдана бонусная награда.
Уровень игрока на старте не проверяется. playerLevelMin / playerLevelMax фильтруют только выдачу предложения, поэтому экспедиция, уже лежащая в слоте, остаётся запускаемой после того, как игрок перерос её.
Адрес метода
/expedition/start
Требует сессию пользователя
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
| slot_index | НЕТ | int | Номер слота, 0-based. По умолчанию 0. |
| skill_ids | ДА | json | Массив идентификаторов приёмов (cid или числовой id), по одному на каждое место экспедиции. Порядок значим: условия привязаны к номеру места. |
Результат
Возвращает то же состояние, что и /expedition/list, уже с обновлённым слотом.
{
"response": {
"success": 1,
"unlocked": true,
"max_slots": 2,
"slots": [
{
"slot_index": 0,
"expedition_cid": "easy_any_1star",
"status": 1,
"skill_cids": ["tossACoin"],
"started_at": 1788239500,
"ends_at": 1788241300,
"bonus_qualified": false,
"skip_price": 100,
"base_rewards": [
{ "type": "soft", "amount": 400 }
],
"bonus_rewards": [
{ "type": "particleOfPower", "amount": 1 }
]
}
],
"rerolls_used": 0,
"rerolls_reset_at": 1788296400,
"paid_reroll_limit": 1,
"reroll_price": null
}
}
Старт увеличивает счётчик заданий expeditions_sent.
Ошибки
| Код | Условие |
|---|---|
| 10000 | skill_ids не передан. |
| 10001 | Слот не найден, экспедиция не свободна (в том числе занята параллельным запросом или клеймом в процессе), передано неверное количество приёмов, приём неизвестен или назначен дважды. |
| 10405 | Фича закрыта по уровню, приём не выучен, приём занят в другой экспедиции, либо назначенные приёмы не удовлетворяют основным условиям. Занятость приёма решается уникальным ключом таблицы назначений, а не проверкой перед записью, поэтому параллельный старт другого слота с тем же приёмом получает этот же отказ, а не делит приём на двоих. |