API-ключи YoozMarket: заказы из своей панели или скрипта
Обновлено:
Если у вас своя панель, бот или скрипт, заказы YoozMarket можно оформлять из кода, а не из личного кабинета. В руководстве: как работают ключи, какие есть действия и что происходит с кошельком.
Создайте ключ и берегите его
Откройте раздел API в кабинете и создайте ключ. Дайте ему имя, чтобы помнить, где он используется; активных ключей может быть до 5, поэтому заведите отдельный для каждого приложения. Ключ показывается только один раз и хранится лишь в виде хеша, поэтому скопируйте его сразу. Если потеряли — отзовите и создайте новый.
Что можно вызывать
Отправляйте JSON- (или form-) запросы на https://yooz.market/api/v1 с ключом и действием.
- balance: баланс вашего кошелька.
- services: услуги, которые можно заказать, с мин./макс. и ставкой за единицу.
- add: оформить заказ — услуга, ссылка и количество (и реакция, где она нужна).
- status: статус заказа по его id.
- getCountries: страны с виртуальными номерами в наличии и цена одного номера.
- getNumber: купить номер по country_code; возвращает номер и order_id.
- getCode: код входа для купленного номера или waiting.
Оплата, повторы и возвраты
Заказы через API оплачиваются с кошелька по тем же ценам, что и в кабинете, а неудавшийся заказ возвращается автоматически. Добавьте необязательный idempotency_key к add или getNumber, чтобы повтор запроса не создал второй заказ. Ошибки приходят со status "error" и полем message_error.
Отзыв ключа
Отзовите ключ на той же странице — всё, что его использует, сразу перестанет работать. Это необратимо, поэтому отдельный ключ для каждого приложения полезен.