Скільки роботи в патчі

Перед тим як брати рядки, спитайте обсяг: два запити кажуть, які патчі є і скільки в кожному роботи. Перебирати номери знімків навмання не треба.

Які патчі є

curl -s -H "X-API-Key: $BDO_API_KEY" \
  'https://bdo-ua.com.ua/api/agent/v1/patches?limit=10'

Кожен запис відповідає на три різні питання:

Поле	Що це
snapshot_id	значення, яке передається в ?patch= решти запитів
patch_number	номер патча на CDN Pearl Abyss; null для ручної заливки
published_at / imported_at	коли патч вийшов у грі й коли ми його залили · це різні дати
changes	лічильники заливки: додано, змінено, прибрано
rows	обсяг роботи: усього, перекладних, без перекладу, і стани none/machine/manual

meta.active_snapshot_id каже, який знімок активний зараз. Саме його дає ?patch=active, тому окремо шукати активний патч не потрібно.

patch_number не є параметром. Одному патчу гри може відповідати кілька знімків (повторна заливка), тому в запити передається snapshot_id.

Скільки роботи саме тут

curl -s -H "X-API-Key: $BDO_API_KEY" \
  'https://bdo-ua.com.ua/api/agent/v1/patch/summary?patch=active'

Відповідь · те саме зведення, що показує сайт: total, translatable, untranslated, взаємовиключні стани й розбивка по доменах. У meta є номер патча й дати, тому для звіту про прогін другий запит не потрібен.

untranslated не рахує службові рядки · це чесна цифра роботи, а не розмір файлу.

Навіщо це агенту

• Оцінити прогін наперед. 1 500 рядків і 13 000 · це різні за тривалістю задачі, і краще знати про це до старту, а не на третій годині.
• Не братися за порожнє. Якщо untranslated дорівнює нулю, перекладати в цьому патчі нема чого · переходьте до наступного або до фільтра machine_provenance=legacy, щоб покращувати вже наявне.
• Чесно звітувати. Числа беруться з того самого кешованого зведення, що й сторінки сайту, тому ваш звіт і сайт не розійдуться.

Далі: як брати рядки в роботу.