API Meowx

Загрузка и продажа аккаунтов — API v2

Для размещения своих VK-аккаунтов используйте POST /api/v2/accounts/sell или массовую загрузку POST /api/v2/account_uploads. В API v1 этих методов нет. Открыть инструкцию по продаже: разрешения, формат запроса и результаты загрузки →

Telegram tdata сейчас загружается через сайт; API-загрузка поддерживает VK.

1. Токен и доступ

Откройте «Мой профиль» → «Настройки» → «API-токен». Личный токен создаётся автоматически при первом открытии настроек API. Его можно показать, скрыть, скопировать, отключить и заменить. Замена сразу отзывает старый токен.

Передавайте его только заголовком Authorization: Bearer ВАШ_API_ТОКЕН. Для покупок и файлов включите «Разрешить покупки за баланс и скачивание купленных файлов». Токен даёт доступ только к вашему аккаунту. Не публикуйте его в исходном коде или браузерном коде стороннего сайта.

Базовый адрес: https://chernovik.shop/api/v1. JSON-запросы используют Content-Type: application/json. Суммы с суффиксом _cents указаны в копейках: 6500 означает 65 ₽; unitPrice — строка в рублях, например "65.00".

curl 'https://chernovik.shop/api/v1/catalog?sort=cheap&page=1' \
  -H 'Authorization: Bearer ВАШ_API_ТОКЕН'

2. Доступные запросы

В ответе каталога: products, total, page, pageSize. Профиль содержит только публичные сведения. GET /orders принимает page=1…100 и status=purchased|checking|refunded, category=VK|Telegram, по 40 заказов на странице.

3. Полный сценарий покупки

1. Выберите товары через GET /catalog либо POST /quote с телом {"query":"category=1&gender=female&sort=cheap","quantity":3}. Ответ quote содержит items, сумму total_cents и баланс available_cents. Цена и наличие проверяются снова при покупке.
2. Сгенерируйте UUID v4 и отправьте POST /checkouts с key, items, необязательными bulk и label. До 10 аккаунтов на запрос. Ответ 201 содержит orders, batchId, checking. Сохраните отправленный key.
3. Опрашивайте GET /checkouts/ВАШ_KEY раз в 3–5 секунд. Ответ содержит orders, checks, checking, progress, totals, confirmation. Во время проверки средства зарезервированы.
4. Если confirmation.state равен pending, отправьте POST /checkouts/ВАШ_KEY/decision с {"decision":"accept"}, чтобы оплатить валидные, либо {"decision":"cancel"}, чтобы отказаться и вернуть резерв. До решения валидные файлы закрыты. Срок указан в confirmation.expires_at.
5. Скачайте GET /checkouts/ВАШ_KEY/download?cookieFormat=json-base64. Для VK это TXT с одной Base64 JSON-строкой на аккаунт. cookieFormat=netscape-base64 выдаёт по одной Base64-строке полного текста Netscape на аккаунт: с доменом, путём, HttpOnly, secure и сроком действия. cookieFormat=netscape сохраняет обычный Netscape. Telegram выдаётся как tdata ZIP; смешанная покупка — общий ZIP. Заголовок Content-Disposition содержит имя файла.

Если вход в Telegram подтверждён, но @SpamBot не сообщил статус ограничений, аккаунт помечается «Спамблок неизвестен». В ответе проверки будет spamBlockStatus: "unknown", а confirmation.unknown_spam_count покажет число таких аккаунтов. Покупка ждёт вашего решения даже при успешной авторизации всех аккаунтов; до принятия решения файлы закрыты, деньги остаются в резерве. Для подтверждения используйте тот же метод /decision. Фильтр spamBlock=0 исключает неизвестные статусы.

curl -X POST 'https://chernovik.shop/api/v1/checkouts' \
  -H 'Authorization: Bearer ВАШ_API_ТОКЕН' \
  -H 'Content-Type: application/json' \
  --data '{"key":"UUID_ДЛЯ_ЭТОЙ_ПОКУПКИ","bulk":true,"items":[{"productId":123,"quantity":1,"unitPrice":"65.00"}]}' 

При сетевом сбое повторяйте покупку с тем же UUID и тем же составом. Повторный запрос не создаст второе списание; изменение состава с прежним UUID вернёт 409. Для новой покупки используйте новый UUID. Возвращённые и неоплаченные аккаунты нельзя скачать. Переданные ссылки downloadUrl из деталей заказа относятся к интерфейсу сайта; для программ используйте соответствующий /api/v1/units/ID/download с Bearer-токеном.

4. Выбор аккаунтов для скачивания

В интерфейсе «Мои покупки» есть отдельные категории VK и Telegram, чекбоксы аккаунтов и кнопка «Скачать выбранные». Через API доступен такой же выбор.

1. Получите GET /purchases/accounts?category=VK&page=1. Ответ: items, total, page, pageSize, по 40 аккаунтов. Каждая запись содержит id аккаунта, order_id, format, category, название товара, цену в копейках и дату покупки. Здесь только ваши оплаченные аккаунты; пароли и cookies в списке не передаются. Для Telegram используйте category=Telegram, для всех — опустите параметр.
2. Выберите до 100 уникальных items[].id и передайте их через запятую: GET /purchases/download?ids=101,102,103,104,105. Это ID отдельных аккаунтов, а не заказов. Разрешено выбрать аккаунты из разных заказов.
3. VK cookies по умолчанию выдаются одним TXT: одна JSON Base64-строка на аккаунт. Для Base64 от полного Netscape добавьте cookieFormat=netscape-base64: одна строка на аккаунт. Для обычного Netscape используйте cookieFormat=netscape. Telegram выдаётся одним ZIP с отдельными архивами tdata; смешанный набор — общий ZIP. Если хотя бы один выбранный аккаунт чужой, возвращён или недоступен, запрос целиком вернёт 404. Измените выбор после обновления списка.

curl "https://chernovik.shop/api/v1/purchases/download?ids=101,102,103,104,105" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -o selected-accounts.txt

Скачивание использует общую квоту: до пяти запросов в минуту. Перечень покупок и файлы не кешируются.

5. Фильтры каталога

GET /categories возвращает ID категорий и доступные значения стран и городов. GET /filters дополнительно возвращает описание параметров. Неизвестные и повторяющиеся параметры отклоняются.

Семейное положение VK: 0 — не указано, 1 — не женат/не замужем, 2 — встречается, 3 — помолвлен, 4 — женат/замужем, 5 — всё сложно, 6 — активный поиск, 7 — влюблён, 8 — гражданский брак. unknown означает, что платформа не передала данные.

6. Лимиты, кеш и ошибки

• 60 запросов в минуту на пользователя и два одновременно; на один IP — до 120 в минуту, с защитой от частых всплесков; замена токена лимиты не сбрасывает.
• До 5 новых покупок в минуту, до 10 аккаунтов за покупку и до 100 запрошенных аккаунтов в час на пользователя. Повторы уже созданной покупки с тем же UUID не расходуют новую квоту аккаунтов.
• Подбор: 15 запросов в минуту. Решение по покупке: 10 в минуту. Скачивание: 5 в минуту, до 1000 файлов и действующих ограничений размера выдачи сайта.
• Общие защитные лимиты: 1200 запросов в минуту, 24 одновременно и до 1000 запрошенных аккаунтов в час через API всего сервера.
• Каталог, карточки и публичные профили кешируются на сервере на 10 секунд, категории и значения фильтров — на 60 секунд. Баланс, покупки и файлы не кешируются. Наличие и цену перед покупкой всегда проверяем в БД.
• Тело запроса — до 8 КБ, строка параметров — до 4 КБ; не более 40 результатов на странице и 100 страниц. Запросы публичного каталога ограничены по времени и используют отдельный небольшой пул БД.

Успешные ответы содержат X-Request-ID, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (Unix seconds). Для кешируемых методов есть X-API-Cache: HIT|MISS. Коды: 400 — параметры, 401 — токен, 403 — нет разрешения, 404 — не найдено, 409 — цена/наличие/повтор изменился, 413 — размер, 415 — Content-Type, 429 — лимит, 503 — занято или временно недоступно.

{"error":{"code":"rate_limited","message":"Лимит API исчерпан. Повторите запрос позже.","requestId":"..."}}

При 429 и временном 503 учитывайте Retry-After, затем повторяйте с увеличением паузы. Ошибка после отправки покупки не доказывает, что она не создана: используйте тот же UUID и запрос статуса. В документации используются примеры, реальные ID и цены берите из каталога.