/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 Фича закрыта по уровню, приём не выучен, приём занят в другой экспедиции, либо назначенные приёмы не удовлетворяют основным условиям. Занятость приёма решается уникальным ключом таблицы назначений, а не проверкой перед записью, поэтому параллельный старт другого слота с тем же приёмом получает этот же отказ, а не делит приём на двоих.