Заказы

Добавление заказа

HTTP-метод GET/POST
Путь /order/create
Возвращает

Объект заказа:

Имя свойства Тип данных Описание
id int ID Заказа
order int ID Заказа (старое название свойства, сохранено для обратной совместимости)
charge double Стоимость заказа
currency string Валюта заказа в формате ISO 4217 (например RUB)
quantity int Количество заказанной услуги
url string Ссылка на объект заказа указанная при оформлении
service Service Object Объект услуги
Пример URL https://socpower.io/api/v1/order/create?link=http%3A%2F%2Fintagram.com%2Fitan&quantity=5000&service=4&key=4c6e77e3094328f9e49ee3ac62d0b8b8

Параметры запроса

Имя параметра Тип данных Описание
quantity int Количество выполнений. Должно быть в диапазоне минимального/максимального количества для заказываемой услуги
link string Ссылка (старое название свойства, сохранено для обратной совместимости, можно использовать как link, так и url, при использовании обоих параметров приоритет отдается url)
url string Ссылка
service int ID услуги
key string API ключ

Пример ответа:

{
    "success": true,
    "data": {
        "order": 1750,
        "charge": 0.5022,
        "currency": "RUB",
        "quantity": 100,
        "url": "https://www.tiktok.com/@hello.josh.ninja.sipes",
        "service": {
            "service": 22,
            "name": "Репосты [USA]",
            "description": "Оказывает влияние на общий поиск. При репостах — добавляются просмотры. Указывайте ссылку на конкретный пост 
 Доступна кнопка отмены
 Стабильная услуга. Надежная работа в последних заказах",
            "category": "Telegram",
            "group": "Репосты",
            "rate": 0.005022,
            "min": 10,
            "max": 100000,
            "purchase_counter": 1
        }
    }
}

Объекты ошибок:

{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "url: Необходимо заполнить «Ссылка».",
        "code": 0,
        "status": 400,
        "error_id": "INVALID_ORDER_DATA"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Промокод не найден",
        "code": 0,
        "status": 400,
        "error_id": "PROMO_CODE_NOT_FOUND"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Достигнут лимит активаций промо-кода",
        "code": 0,
        "status": 400,
        "error_id": "PROMO_CODE_ACTIVATION_LIMIT_REACHED"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Промокод не активен",
        "code": 0,
        "status": 400,
        "error_id": "PROMO_CODE_NOT_ACTIVE"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Минимальное число для заказа 100, максимальное - 100000",
        "code": 0,
        "status": 400,
        "error_id": "QUANTITY_OUT_OF_BOUNDS"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Услуга не найдена",
        "code": 0,
        "status": 400,
        "error_id": "SERVICE_NOT_FOUND"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Недостаточно средств на балансе."
        "code": 0,
        "status": 400,
        "error_id": "INSUFFICIENT_BALANCE"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Произошла ошибка услуги. Пожалуйста, попробуйте позже или выберите другую услугу"
        "code": 0,
        "status": 400,
        "error_id": "ORDER_CREATION_SERVICE_ERROR"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Произошла серверная ошибка при создании заказа. Пожалуйста, попробуйте ещё раз"
        "code": 0,
        "status": 400,
        "error_id": "ORDER_CREATION_SERVER_ERROR"
    }
}

Просмотр заказа

HTTP-метод GET
Путь /order/view
Возвращает

Объект заказа:

Имя свойства Тип данных Описание
id int ID Заказа
charge double Первоначальная стоимость заказа
actual_charge double Актуальная стоимость заказа, учитывающая возможные изменения (отмена заказа или частичное выполнение)
currency string Валюта заказа в формате ISO 4217 (например RUB)
quantity int Количество заказанной услуги
url string Ссылка на объект заказа указанная при оформлении
service Service Object Объект услуги
created_at int Дата создания заказа в Unixtime
from string Источник создания заказа (возможные значения: web — в веб-интерфейсе магазина, api — через API)
status string Статус заказа (возможные значения: Processing, Completed, Canceled, Partial, Problem, Error, Not_paid)
Processing — "В процессе", заказ принят к исполнению.
Completed — "Завершен", заказ был успешно выполнен.
Canceled — "Отменен", заказ был отменен, средства за него возвращены на баланс.
Partial — "Частично выполнен", заказ был частично выполнен, средства за невыполненную часть возвращены на баланс.
Problem — "Проблема", с заказом произошёл технический сбой или автоматическая пре-модерация обнаружила потенциальные проблемы. Дополнительных действий от пользователя не требуется, можно расценивать этот статус как в "В процессе". Если проблему устранить не удастся, либо модерация не будет пройдена — заказ будет отменён.
Error — "Ошибка", произошла системная ошибка при исполнении заказа. Вскоре менеджер её обработает. Не встречается для заказов сделанных через API. Встречается только для гостевых заказов сайта, сделанных через веб-интерфейс.
Not_paid — "Не оплачен", гостевой заказ ещё не был оплачен. Не встречается для заказов сделанных через API. Встречается только для гостевых заказов сайта, сделанных через веб-интерфейс.
start_count null|int Какое количество было на объекте перед началом выполнения заказа, null если значение не определено
remains null|int Какое количество осталось выполнить, null если значение не определено
Пример URL https://socpower.io/api/v1/order/view?id=1748&key=4c6e77e3094328f9e49ee3ac62d0b8b8

Параметры запроса

Имя параметра Тип данных Описание
id int ID заказа на сервисе
key string API ключ

Пример ответа:

{
    "success": true,
    "data": {
        "id": 1748,
        "charge": 0.7031,
        "actual_charge": 0.7031,
        "currency": "RUB",
        "quantity": 100,
        "url": "https://www.tiktok.com/@hello.josh.ninja.sipes",
        "service": {
            "id": 41,
            "service": 41,
            "name": "Быстрые подписчики",
            "description": "Старт в течении 2-ух минут, скорость 5000 в сутки",
            "category": "Instagram",
            "group": "Просмотры",
            "rate": 0.007031,
            "rate_per_thousand": 7.031,
            "min": 100,
            "max": 10000000,
            "purchase_counter": 5,
            "is_cancel_allowed": false,
            "is_refill_allowed": false,
            "stability_status": "Stable",
            "is_popular": false
        },
        "created_at": 1741089996,
        "from": "api",
        "status": "Processing",
        "start_count": null,
        "remains": null
    }
}

Объекты ошибок:

{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Заказ №545 не найден",
        "code": 0,
        "status": 400,
        "error_id": "ORDER_NOT_FOUND"
    }
}

Просмотр списка заказов

HTTP-метод GET
Путь /order/list
Возвращает

Массив объектов заказа:

Имя свойства Тип данных Описание
id int ID Заказа
charge double Первоначальная стоимость заказа
actual_charge double Актуальная стоимость заказа, учитывающая возможные изменения (отмена заказа или частичное выполнение)
currency string Валюта заказа в формате ISO 4217 (например RUB)
quantity int Количество заказанной услуги
url string Ссылка на объект заказа указанная при оформлении
service Service Object Объект услуги
created_at int Дата создания заказа в Unixtime
from string Источник создания заказа (возможные значения: web — в веб-интерфейсе магазина, api — через API)
status string Статус заказа (возможные значения: Processing, Completed, Canceled, Partial, Problem, Error, Not_paid)
Processing — "В процессе", заказ принят к исполнению.
Completed — "Завершен", заказ был успешно выполнен.
Canceled — "Отменен", заказ был отменен, средства за него возвращены на баланс.
Partial — "Частично выполнен", заказ был частично выполнен, средства за невыполненную часть возвращены на баланс.
Problem — "Проблема", с заказом произошёл технический сбой или автоматическая пре-модерация обнаружила потенциальные проблемы. Дополнительных действий от пользователя не требуется, можно расценивать этот статус как в "В процессе". Если проблему устранить не удастся, либо модерация не будет пройдена — заказ будет отменён.
Error — "Ошибка", произошла системная ошибка при исполнении заказа. Вскоре менеджер её обработает. Не встречается для заказов сделанных через API. Встречается только для гостевых заказов сайта, сделанных через веб-интерфейс.
Not_paid — "Не оплачен", гостевой заказ ещё не был оплачен. Не встречается для заказов сделанных через API. Встречается только для гостевых заказов сайта, сделанных через веб-интерфейс.
start_count null|int Какое количество было на объекте перед началом выполнения заказа, null если значение не определено
remains null|int Какое количество осталось выполнить, null если значение не определено
Если заказ не найден, то вместо объекта будет идентификатор исключения ORDER_NOT_FOUND 
"1755": "ORDER_NOT_FOUND"
Пример URL https://socpower.io/api/v1/order/list?ids=1745%2C1748%2C1755&key=4c6e77e3094328f9e49ee3ac62d0b8b8

Параметры запроса

Имя параметра Тип данных Описание
ids string список ID заказов через запятую, не более 100 идентификаторов
key string API ключ

Пример ответа:

{
    "success": true,
    "data": {
        "1745": {
            "id": 1745,
            "charge": 0.6278,
            "actual_charge": 0.6278,
            "currency": "RUB",
            "quantity": 100,
            "url": "http_i_td",
            "service": {
                "id": 20,
                "service": 20,
                "name": "[🟢] Просмотры для статистики из поиска [RU][КО: ➕]",
                "description": "Все просмотры происходят с российских IP. Данные о просмотрах засчитываются в аналитику канала. В статистике указан источник просмотров — поиск. Работает только для публичных каналов.
 Доступна кнопка отмены

🟢 Стабильная услуга. Надежная работа в последних заказах",
                "category": "Telegram",
                "group": "Просмотры на пост",
                "rate": 0.006278,
                "rate_per_thousand": 6.278,
                "min": 100,
                "max": 100000,
                "purchase_counter": 5,
                "is_cancel_allowed": true,
                "is_refill_allowed": false,
                "stability_status": "Stable",
                "is_popular": false
            },
            "created_at": 1741086139,
            "from": "api",
            "status": "Processing",
            "start_count": null,
            "remains": null
        },
        "1748": {
            "id": 1748,
            "charge": 0.7031,
            "actual_charge": 0.7031,
            "currency": "RUB",
            "quantity": 100,
            "url": "https://www.tiktok.com/@hello.josh.ninja.sipes",
            "service": {
                "id": 41,
                "service": 41,
                "name": "[🟢] Просмотры видео",
                "description": "Быстрый запуск. Указывать ссылку на публикацию.  Текущая скорость: ≈2500-5000/час. 

🟢 Стабильная услуга. Надежная работа в последних заказах",
                "category": "Instagram",
                "group": "Просмотры",
                "rate": 0.007031,
                "rate_per_thousand": 7.031,
                "min": 100,
                "max": 10000000,
                "purchase_counter": 5,
                "is_cancel_allowed": false,
                "is_refill_allowed": false,
                "stability_status": "Stable",
                "is_popular": false
            },
            "created_at": 1741089996,
            "from": "api",
            "status": "Processing",
            "start_count": null,
            "remains": null
        },
        "1755": "ORDER_NOT_FOUND"
    }
}

Объекты ошибок:

{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Не переданы идентификаторы заказов",
        "code": 0,
        "status": 400
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Количество заказов в запросе не должно превышать 100 шт.",
        "code": 0,
        "status": 400
    }
}

Отмена заказа

Заказ может быть отменен только для тех услуг, которые поддерживают отмену.
HTTP-метод POST
Путь /order/cancel
Возвращает Флаг успешности операции
Имя свойства Тип данных Описание
cancel int Возможные значения: 1 - заказ отменен
В случае невозможности отмены заказа вернет сообщение об ошибке общего формата:
Имя свойства Тип данных Описание
name string Название статуса ошибки
message string Текст причины невозможности совершения операции отмены
code int Код ошибки
status int Код статуса ошибки (например: 400)
error_id string Идентификатор ошибки
Пример URL https://socpower.io/api/v1/order/cancel?id=1746&key=4c6e77e3094328f9e49ee3ac62d0b8b8

Параметры запроса

Имя параметра Тип данных Описание
id int Номер заказа

Пример ответа:

{
    "success": true,
    "data": {
        "cancel": 1
    }
}

Объекты ошибок:

{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Заказ №545 не найден",
        "code": 0,
        "status": 400,
        "error_id": "ORDER_NOT_FOUND"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Данный заказ не поддерживает отмену по кнопке",
        "code": 0,
        "status": 400,
        "error_id": "ORDER_CANCEL_NOT_SUPPORTED"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Модуль отмены для данной услуги неактивен. Пожалуйста, свяжитесь с поддержкой для решения проблемы",
        "code": 0,
        "status": 400,
        "error_id": "SERVICE_CANCEL_NOT_SUPPORTED"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Заказ не был отправлен на выполнение. Пожалуйста, свяжитесь с поддержкой для его отмены",
        "code": 0,
        "status": 400,
        "error_id": "ORDER_NOT_SENT_FOR_EXECUTION"
    }
}
--------------------------------------------------------------------
С данным идентификатором ORDER_CANCEL_USER_CAUSED_API_ERROR могут быть ошибки возникшие в большинстве своём из-за действий пользователя,
или в случае если заказ уже на финальной стадии завершения (но ещё не сменил статус, тогда будет ошибка: ORDER_CANCEL_DENIED_DUE_FINAL_STATUS).

Текст ошибки можно показывать напрямую пользователю.
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Слишком быстрая попытка отмены заказа. Попробуйте позже",
        "code": 0,
        "status": 400,
        "error_id": "ORDER_CANCEL_USER_CAUSED_API_ERROR"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Произошла системная ошибка при отмене заказа. Пожалуйста, попробуйте позже или ещё раз.",
        "code": 0,
        "status": 400,
        "error_id": "ORDER_CANCEL_DUE_SYSTEM_FAILURE"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Заказ перешел в финальный статус и не может быть направлен на отмену",
        "code": 0,
        "status": 400,
        "error_id": "ORDER_CANCEL_DENIED_DUE_FINAL_STATUS"
    }
}

Создать refill заказа

Refill может быть создан только для тех услуг, которые поддерживают refill.
HTTP-метод POST
Путь /order/refill
Возвращает В случае невозможности создать refill для заказа, вернет сообщение об ошибке общего формата:
Имя свойства Тип данных Описание
name string Название статуса ошибки
message string Текст причины невозможности совершения операции
code int Код ошибки
status int Код статуса ошибки (например: 400)
error_id string Идентификатор ошибки
Пример URL https://socpower.io/api/v1/order/refill?id=1746&key=4c6e77e3094328f9e49ee3ac62d0b8b8

Параметры запроса

Имя параметра Тип данных Описание
id int Номер заказа

Пример ответа:

{
    "success": true,
    "data": {
        "refill": 1
    }
}

Объекты ошибок:

{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Заказ №545 не найден",
        "code": 0,
        "status": 400,
        "error_id": "ORDER_NOT_FOUND"
    }
}
--------------------------------------------------------------------
{
    "success": false,
    "data": {
        "name": "Bad Request",
        "message": "Услуга не поддерживает refill",
        "code": 0,
        "status": 400,
        "error_id": "SERVICE_REFILL_NOT_SUPPORTED"
    }
}
Вступление Заказы Услуги Пользователь