[{"data":1,"prerenderedAt":128},["ShallowReactive",2],{"openapi-specs-catalog":3,"openapi-nav-ru-Alternative-API-UN":38,"openapi-doc-\u002Fru\u002FAlternative-API-UN\u002Fauth":123,"openapi-op-\u002Fru\u002FAlternative-API-UN\u002Fauth":127},["Reactive",4],{"defaultLocale":5,"base":6,"specs":7,"specsMeta":11,"locales":35},"en","\u002Fopenapi_docs\u002F",[8,9,10],"Onlinesim-API-UN","Reseller-API-UN","Alternative-API-UN",[12,22,29],{"name":8,"fileName":8,"title":13,"version":14,"description":15,"basePath":16,"specsPath":17,"locales":18,"defaultLocale":5},"Onlinesim API","1.1","General description This API will allow you to access all services provided by Onlinesim: SMS receiving from a single specific service on a virtual nu","Onlinesim-API-UN\u002F","\u002Fopenapi_docs\u002Fspecs\u002FOnlinesim-API-UN",{"en":19,"ru":20,"de":21},"English","Русский","Deutsch",{"name":9,"fileName":9,"title":23,"version":24,"description":25,"basePath":26,"specsPath":27,"locales":28,"defaultLocale":5},"Reseller API","1.0","General description The API is intended for current and potential Onlinesim partners. It allows you to monetize your numbers by providing them to our ","Reseller-API-UN\u002F","\u002Fopenapi_docs\u002Fspecs\u002FReseller-API-UN",{"en":19,"ru":20,"de":21},{"name":10,"fileName":10,"title":30,"version":24,"description":31,"basePath":32,"specsPath":33,"locales":34,"defaultLocale":5},"Alternative API","General description Alternative API for integration with Onlinesim. This API will allow you to access two main services of Onlinesim: rent numbers to ","Alternative-API-UN\u002F","\u002Fopenapi_docs\u002Fspecs\u002FAlternative-API-UN",{"en":19,"ru":20,"de":21},[5,36,37],"ru","de",[39,43,48,65,94],{"text":30,"link":40,"icon":41,"description":42},"\u002Fru\u002FAlternative-API-UN\u002Finfo","icons\u002Fdocs\u002Finfo","Обзор API и введение",{"text":44,"link":45,"icon":46,"description":47},"Авторизация","\u002Fru\u002FAlternative-API-UN\u002Fauth","icons\u002Fdocs\u002Fauth","API-ключи, OAuth и схемы безопасности",{"text":49,"collapsed":50,"items":51,"description":63,"icon":64},"profile (alt)",false,[52,58],{"text":53,"link":54,"method":55,"path":56,"description":57,"deprecated":50},"getBalance","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getbalance","GET","\u002Fstubs\u002Fhandler_api.php?action=getBalance","Получить информацию о балансе аккаунта",{"text":59,"link":60,"method":55,"path":61,"description":62,"deprecated":50},"getCountries","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getcountries","\u002Fstubs\u002Fhandler_api.php?action=getCountries","Получить список стран с доступными для заказа номерами","запросы для всех услуг или относящиеся к профилю","icons\u002Fdocs\u002Ffolder",{"text":66,"collapsed":50,"items":67,"description":93,"icon":64},"single-service activations",[68,73,78,83,88],{"text":69,"link":70,"method":55,"path":71,"description":72,"deprecated":50},"getNumbersStatus","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getnumbersstatus","\u002Fstubs\u002Fhandler_api.php?action=getNumbersStatus","Получить информацию о количестве доступных номеров по сервисам",{"text":74,"link":75,"method":55,"path":76,"description":77,"deprecated":50},"getNumber","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getnumber","\u002Fstubs\u002Fhandler_api.php?action=getNumber","Купить виртуальный номер для выбранного сервиса",{"text":79,"link":80,"method":55,"path":81,"description":82,"deprecated":50},"getStatus","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getstatus","\u002Fstubs\u002Fhandler_api.php?action=getStatus","Получить цифровой код из SMS-сообщения",{"text":84,"link":85,"method":55,"path":86,"description":87,"deprecated":50},"getFullSms","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getfullsms","\u002Fstubs\u002Fhandler_api.php?action=getFullSms","Получить полный текст SMS",{"text":89,"link":90,"method":55,"path":91,"description":92,"deprecated":50},"setStatus","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-setstatus","\u002Fstubs\u002Fhandler_api.php?action=setStatus","Изменить статус операции","запросы для доступа к функционалу для приема SMS от отдельных сервисов",{"text":95,"collapsed":50,"items":96,"description":122,"icon":64},"rent",[97,102,107,112,117],{"text":98,"link":99,"method":55,"path":100,"description":101,"deprecated":50},"getRentServicesAndCountries","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getrentservicesandcountries","\u002Fstubs\u002Fhandler_api.php?action=getRentServicesAndCountries","Получить список стран и тарифов для аренды виртуальных номеров",{"text":103,"link":104,"method":55,"path":105,"description":106,"deprecated":50},"getRentNumber","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getrentnumber","\u002Fstubs\u002Fhandler_api.php?action=getRentNumber","Арендовать виртуальный номер для приема SMS",{"text":108,"link":109,"method":55,"path":110,"description":111,"deprecated":50},"getRentList","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getrentlist","\u002Fstubs\u002Fhandler_api.php?action=getRentList","Получить список активных арендных номеров профиля",{"text":113,"link":114,"method":55,"path":115,"description":116,"deprecated":50},"getRentStatus","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-getrentstatus","\u002Fstubs\u002Fhandler_api.php?action=getRentStatus","Получить статус операции аренды",{"text":118,"link":119,"method":55,"path":120,"description":121,"deprecated":50},"setRentStatus","\u002Fru\u002FAlternative-API-UN\u002FAlternative-API-UN-get-stubs-handler_api-php-action-setrentstatus","\u002Fstubs\u002Fhandler_api.php?action=setRentStatus","Изменить статус операции аренды виртуального номера","запросы для доступа к функционалу аренды",{"title":124,"kind":125,"locale":36,"specName":10,"path":45,"body":126,"description":124},"Authorization","auth","\u003Ch1>Авторизация\u003C\u002Fh1>\n\u003Cdiv id=\"api_key\" class=\"openapi-auth-scheme\">\u003C\u002Fdiv>\n\u003Cdiv class=\"openapi-auth-scheme-head\">\n  api_key\n\u003C\u002Fdiv>\n\u003Cdiv data-editable data-file=\"Alternative-API-UN.yaml\" data-path=\"components.securitySchemes.api_key.x-description-ru\" data-type=\"textarea\">\u003C\u002Fdiv>\n\u003Cp>Секретный ключ, используемый для упрощенной авторизации в API Onlinesim.\u003C\u002Fp>\n\u003Chr>\n\u003Ch4>Как получить API ключ:\u003C\u002Fh4>\n\u003Col>\n  \u003Cli>Авторизоваться в личном кабинете, перейти в \u003Ca href=\"https:\u002F\u002Fonlinesim.io\u002Fv2\u002Fprofile\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">настройки профиля\u003C\u002Fa>, выбрать вкладку \u003Cstrong>API\u003C\u002Fstrong>.\u003C\u002Fli>\n  \u003Cli>Ключ будет указан в строке \u003Ccode>API key\u003C\u002Fcode>. Его необходимо скопировать и добавить в Ваше приложение\u002Fпрограмму.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Chr>\n\u003Ch4>Как использовать:\u003C\u002Fh4>\n\u003Col>\n  \u003Cli>Все запросы к текущему API Onlinesim (за исключением \u003Ca href=\"\u002Fopenapi_docs\u002Fru\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getfreelist\">getFreeList\u003C\u002Fa>) должны содержать API ключ.\u003C\u002Fli>\n  \u003Cli>\n    \u003Cp>API ключ можно указать как параметр запроса, например:\u003C\u002Fp>\n    \u003Cpre>\u003Ccode>   https:\u002F\u002Fonlinesim.io\u002Fapi\u002FgetTariffs.php?api_key={api_key}\u003C\u002Fcode>\u003C\u002Fpre>\n  \u003C\u002Fli>\n\u003C\u002Fol>\n\u003Caside class=\"my-4 rounded-lg border p-4 text-sm leading-relaxed not-prose border-brand-200 bg-brand-50 text-brand-950\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&_p:last-child]:mb-0 [&_p]:mb-2\">\u003Cp>Использование API ключа представляет собой способ для упрощенной авторизации запросов. Мы рекомендуем использовать OAuth 2.0 для более безопасной работы с данными.\u003C\u002Fp>\n\u003Cp>Для получения более подробной информации, пожалуйста, обратитесь к \u003Ca href=\"https:\u002F\u002Foauth.net\u002F2\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">официальной документации OAuth 2.0\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Faside>\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Property\u003C\u002Fth>\n      \u003Cth>Value\u003C\u002Fth>\n    \u003C\u002Ftr>\n  \u003C\u002Fthead>\n  \u003Ctbody>\n    \u003Ctr>\n      \u003Ctd>Тип\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>apiKey\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>В\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>query\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>Название\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>api_key\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cdiv id=\"bearerauth\" class=\"openapi-auth-scheme\">\u003C\u002Fdiv>\n\u003Cdiv class=\"openapi-auth-scheme-head\">\n  BearerAuth\n\u003C\u002Fdiv>\n\u003Cdiv data-editable data-file=\"Alternative-API-UN.yaml\" data-path=\"components.securitySchemes.BearerAuth.x-description-ru\" data-type=\"textarea\">\u003C\u002Fdiv>\n\u003Cp>API ключ также можно использовать для авторизации в заголовке запроса, используя схему \u003Ccode>Authorization: Bearer\u003C\u002Fcode>, например:\u003C\u002Fp>\n\u003Cpre language=\"http\">\u003Ccode class=\"language-http\">Authorization: Bearer {api_key}\nUser-Agent: PostmanRuntime\u002F7.29.2\nAccept: *\u002F\\*\nCache-Control: no-cache\nPostman-Token: 948bc880-8d25-4298-994f-fe6e22ada339\nHost: onlinesim.io\nAccept-Encoding: gzip, deflate, br\nConnection: keep-alive\nCookie: xxxx\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Caside class=\"my-4 rounded-lg border p-4 text-sm leading-relaxed not-prose border-brand-200 bg-brand-50 text-brand-950\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&_p:last-child]:mb-0 [&_p]:mb-2\">\u003Cp>Использование API ключа представляет собой способ для упрощенной авторизации запросов. Мы рекомендуем использовать OAuth 2.0 для более безопасной работы с данными.\u003C\u002Fp>\n\u003Cp>Для получения более подробной информации, пожалуйста, обратитесь к \u003Ca href=\"https:\u002F\u002Foauth.net\u002F2\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">официальной документации OAuth 2.0\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Faside>\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Property\u003C\u002Fth>\n      \u003Cth>Value\u003C\u002Fth>\n    \u003C\u002Ftr>\n  \u003C\u002Fthead>\n  \u003Ctbody>\n    \u003Ctr>\n      \u003Ctd>Тип\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>http\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>Схема\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>bearer\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cdiv id=\"oauth2\" class=\"openapi-auth-scheme\">\u003C\u002Fdiv>\n\u003Cdiv class=\"openapi-auth-scheme-head\">\n  OAuth2\n\u003C\u002Fdiv>\n\u003Cdiv data-editable data-file=\"Alternative-API-UN.yaml\" data-path=\"components.securitySchemes.OAuth2.x-description-ru\" data-type=\"textarea\">\u003C\u002Fdiv>\n\u003Cp>\u003Ca href=\"\">\u003C\u002Fa>\u003C\u002Fp>\n\u003Ch3>OAuth 2.0\u003C\u002Fh3>\n\u003Cp>Протокол OAuth 2.0 поддерживает несколько сценариев авторизации, для работы с нашим API можно использовать сценарии Authorization Code Flow или Implicit Flow.\u003C\u002Fp>\n\u003Caside class=\"my-4 rounded-lg border p-4 text-sm leading-relaxed not-prose border-brand-200 bg-brand-50 text-brand-950\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&_p:last-child]:mb-0 [&_p]:mb-2\">Для получения более подробной информации, пожалуйста, обратитесь к \u003Ca href=\"https:\u002F\u002Foauth.net\u002F2\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">официальной документации OAuth 2.0\u003C\u002Fa>.\u003C\u002Fdiv>\u003C\u002Faside>\u003Cp>\u003Cstrong>Authorization URL\u003C\u002Fstrong>: \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Token URL\u003C\u002Fstrong>: \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Scopes\u003C\u002Fstrong>:\u003C\u002Fp>\n\u003Cul>\n  \u003Cli>\u003Ccode>sms-scope\u003C\u002Fcode> открывает доступ к управлению номерами для услуги \"Прием SMS\" от Onlinesim;\u003C\u002Fli>\n  \u003Cli>\u003Ccode>rent-scope\u003C\u002Fcode> открывает доступ к аренде виртуальных телефонных номеров Onlinesim;\u003C\u002Fli>\n  \u003Cli>\u003Ccode>free-scope\u003C\u002Fcode> открывает доступ к использованию бесплатных номеров Onlinesim.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>\u003Cstrong>Регистрация вашего приложения на нашем сервисе авторизации\u003C\u002Fstrong>\u003C\u002Fh3>\n\u003Col>\n  \u003Cli>Перейдите на \u003Ca href=\"https:\u002F\u002Fonlinesim.io\u002Foauth\" target=\"_blank\" rel=\"noopener noreferrer\">страницу OAuth\u003C\u002Fa>\u003C\u002Fli>\n  \u003Cli>\n    \u003Cp>Создайте новый клиент, указав:\u003C\u002Fp>\n    \u003Cul>\n      \u003Cli>\u003Ccode>Name\u003C\u002Fcode> - название приложения или любое другое название, которое Вы и Ваши пользователи будут ассоциировать с приложением;\u003C\u002Fli>\n      \u003Cli>\u003Ccode>Redirect URL\u003C\u002Fcode> - URL, на который будет перенаправлен клиент после авторизации и куда будет направлен код авторизации приложения;\u003C\u002Fli>\n      \u003Cli>\n        \u003Ccode>Confidential\u003C\u002Fcode> - необзятально, отметье клиент как \u003Cu>Confidential\u003C\u002Fu>, если ваше приложение работает на сервере и может безопасно хранить \u003Cu>Client Secret\u003C\u002Fu>.\n      \u003C\u002Fli>\n    \u003C\u002Ful>\n  \u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fopenapi_docs\u002Fdocs\u002FCreateOAuthClient.png\" alt=\"Создание клиента\">\u003C\u002Fp>\n\u003Col start=\"3\">\n  \u003Cli>Нажмите \"Create\". Добавленное Вами приложение будет отображаться в списке клиентов.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fopenapi_docs\u002Fdocs\u002FOAuthClient.png\" alt=\"Список клиентов\">\u003C\u002Fp>\n\u003Col start=\"4\">\n  \u003Cli>Сохраните \u003Ccode>Client ID\u003C\u002Fcode> и \u003Ccode>Secret\u003C\u002Fcode> в безопасном месте, далее они будут использоваться Вашим приложении для авторизации.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Ca href=\"\">\u003C\u002Fa>\u003C\u002Fp>\n\u003Ch3>OAuth 2.0. Authorization Сode Flow\u003C\u002Fh3>\n\u003Ch4>\u003Cstrong>Авторизация пользователя и получение токена\u003C\u002Fstrong>\u003C\u002Fh4>\n\u003Col>\n  \u003Cli>Авторизуйте клиент через GET запрос к \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode> с параметрами \u003Ccode>client_id\u003C\u002Fcode>, \u003Ccode>redirect_uri\u003C\u002Fcode>, \u003Ccode>response_type\u003C\u002Fcode>, \u003Ccode>scope\u003C\u002Fcode>, \u003Ccode>state\u003C\u002Fcode>:\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch5>Описание параметров\u003C\u002Fh5>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Название параметра\u003C\u002Fth>\n      \u003Cth style=\"text-align:center\">Тип данных\u003C\u002Fth>\n      \u003Cth>Описание\u003C\u002Fth>\n    \u003C\u002Ftr>\n  \u003C\u002Fthead>\n  \u003Ctbody>\n    \u003Ctr>\n      \u003Ctd>client_id\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>Client ID\u003C\u002Fcode>, который был получен после регистрации приложения\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>redirect_uri\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Адрес на который будет перенаправлен клиент, после успешной авторизации, должен совпадать с \u003Ccode>Redirect URL\u003C\u002Fcode>, который Вы указали при регистрации приложения.\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>response_type\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Указать \u003Ccode>code\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>scope\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Права доступа, разрешение на которые запрашивает Ваше приложение у пользователя. Возможные варианты: \u003Ccode>sms-scope\u003C\u002Fcode>, \u003Ccode>rent-scope\u003C\u002Fcode>, \u003Ccode>free-scope\u003C\u002Fcode>. Можно указать несколько значений\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>state\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Случайная строка для защиты от CSRF (проверьте её после редиректа)\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Col start=\"2\">\n  \u003Cli>После запроса к \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode> пользователь из Вашего приложения будет перенаправлен на страницу авторизации, где ему необходимо указать логин пароль и, в случае успеха, авторизовать Ваше приложение для работы с данными пользователя в сервисе Onlinesim. Для этого ему необходимо будет нажать кнопку \u003Cem>\u003Ccode>Authorize\u003C\u002Fcode>\u003C\u002Fem>:\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fopenapi_docs\u002Fdocs\u002FOAuthRequest.png\" alt=\"OAuth запрос\">\u003C\u002Fp>\n\u003Caside class=\"my-4 rounded-lg border p-4 text-sm leading-relaxed not-prose border-brand-200 bg-brand-50 text-brand-950\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&_p:last-child]:mb-0 [&_p]:mb-2\">На этом этапе Вы можете проверить параметр \u003Ccode>state\u003C\u002Fcode>\n, для подтверждения безопасного взаимодействия с сервисом авторизации\u003C\u002Fdiv>\u003C\u002Faside>\u003Col start=\"3\">\n  \u003Cli>В случае успешной авторизации пользователь будет перенаправлен по адресу \u003Ccode>redirect_uri\u003C\u002Fcode> с параметром \u003Ccode>code\u003C\u002Fcode>. Теперь Вы можете получить \u003Ccode>access token\u003C\u002Fcode>, для этого необходимо сделать POST запрос к \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode>:\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch5>Описание параметров\u003C\u002Fh5>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Название параметра\u003C\u002Fth>\n      \u003Cth style=\"text-align:center\">Тип данных\u003C\u002Fth>\n      \u003Cth>Описание\u003C\u002Fth>\n    \u003C\u002Ftr>\n  \u003C\u002Fthead>\n  \u003Ctbody>\n    \u003Ctr>\n      \u003Ctd>grant_type\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Сценарий авторизации, для сценария Authorization Сode необходимо указать \u003Ccode>authorization_code\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>client_id\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>Client ID\u003C\u002Fcode>, который был получен после регистрации приложения\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>client_secret\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>Сlient_secret\u003C\u002Fcode>, который был получен после регистрации приложения\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>redirect_uri\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Адрес на который будет перенаправлен клиент, после успешной авторизации, должен совпадать с \u003Ccode>Redirect URL\u003C\u002Fcode>, который Вы указали при регистрации приложения\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>code\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Код авторизации, который был получен на предыдущем этапе\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Caside class=\"my-4 rounded-lg border p-4 text-sm leading-relaxed not-prose border-red-200 bg-red-50 text-red-950\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&_p:last-child]:mb-0 [&_p]:mb-2\">Так как \u003Ccode>client_secret\u003C\u002Fcode>\n -  это приватный ключ, крайне не рекомендуется хранить его на frontend клиента. Для большей безопасности необходимо хранить его в бэкенде Вашего приложения. Для реализации сценария с авторизационным кодом нужно передать полученный frontend'ем код в backend Вашего сервиса, а уже он должен обратится в авторизационный сервис для получения токена.\u003C\u002Fdiv>\u003C\u002Faside>\u003Col start=\"4\">\n  \u003Cli>В результате успешного выполнения запроса к \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode>, в ответ получите JSON, содержащий поля \u003Ccode>access_token\u003C\u002Fcode>, \u003Ccode>refresh_token\u003C\u002Fcode> и \u003Ccode>expires_in\u003C\u002Fcode>. Поле \u003Ccode>expires_in\u003C\u002Fcode> определяет количество секунд до истечения срока действия токена доступа, \u003Ccode>refresh_token\u003C\u002Fcode> используется для обновления токена доступа при истечении его срока действия.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Chr>\n\u003Ch4>\u003Cstrong>Авторизация запросов к API Onlinesim и обновление токена\u003C\u002Fstrong>\u003C\u002Fh4>\n\u003Cp>Во все запросы к API нужно добавлять заголовок \u003Cstrong>Authorization: Bearer \u003Cem>\u003Ccode>access_token\u003C\u002Fcode>\u003C\u002Fem>\u003C\u002Fstrong>.\nЕсли в ответ на ваш запрос пришел \u003Ccode>ERROR_WRONG_KEY\u003C\u002Fcode>, Вам необходимо обновить токен или получить новый.\u003C\u002Fp>\n\u003Cpre language=\"json\">\u003Ccode class=\"language-json\">{\n  \"response\": \"ERROR_WRONG_KEY\"\n}\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Для обновления токена необходимо сделать POST запрос к \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode> с параметрами \u003Ccode>grant_type\u003C\u002Fcode>, \u003Ccode>client_id\u003C\u002Fcode>, \u003Ccode>client_secret\u003C\u002Fcode> и \u003Ccode>refresh_token\u003C\u002Fcode>. Для поля \u003Ccode>refresh_token\u003C\u002Fcode> необходимо использовать значение, которое было получено в шаге 4.\u003C\u002Fp>\n\u003Ch5>Описание параметров\u003C\u002Fh5>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Название параметра\u003C\u002Fth>\n      \u003Cth style=\"text-align:center\">Тип данных\u003C\u002Fth>\n      \u003Cth>Описание\u003C\u002Fth>\n    \u003C\u002Ftr>\n  \u003C\u002Fthead>\n  \u003Ctbody>\n    \u003Ctr>\n      \u003Ctd>grant_type\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Необходимо указать \u003Ccode>refresh_token\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>client_id\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>client ID\u003C\u002Fcode>, который Вы получили при регистрации приложения\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>client_secret\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>client_secret\u003C\u002Fcode>, который был получен при регистрации приложения\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>refresh_token\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>refresh_token\u003C\u002Fcode> был получен вместе с \u003Ccode>access_token\u003C\u002Fcode>. Имеет гораздо большее время жизни и используется для обновления \u003Ccode>access_token\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>\u003Ca href=\"\">\u003C\u002Fa>\u003C\u002Fp>\n\u003Ch3>OAuth 2.0. Implicit flow\u003C\u002Fh3>\n\u003Ch4>\u003Cstrong>Авторизация пользователя и получение токена\u003C\u002Fstrong>\u003C\u002Fh4>\n\u003Col>\n  \u003Cli>Авторизуйте клиент через GET запрос к \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode> с параметрами \u003Ccode>client_id\u003C\u002Fcode>, \u003Ccode>redirect_uri\u003C\u002Fcode>, \u003Ccode>response_type\u003C\u002Fcode>, \u003Ccode>scope\u003C\u002Fcode>, \u003Ccode>state\u003C\u002Fcode>:\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch5>Описание параметров\u003C\u002Fh5>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Название параметра\u003C\u002Fth>\n      \u003Cth style=\"text-align:center\">Тип данных\u003C\u002Fth>\n      \u003Cth>Описание\u003C\u002Fth>\n    \u003C\u002Ftr>\n  \u003C\u002Fthead>\n  \u003Ctbody>\n    \u003Ctr>\n      \u003Ctd>client_id\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>Client ID\u003C\u002Fcode>, который был получен при регистрации приложения\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>redirect_uri\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Адрес на который будет перенаправлен клиент, после успешной авторизации, должен совпадать с \u003Ccode>Redirect URL\u003C\u002Fcode>, который Вы указали при добавлении приложения.\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>response_type\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Используйте \u003Ccode>token\u003C\u002Fcode> в качестве значения\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>scope\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Права доступа, разрешение на которые запрашивает Ваше приложение у пользователя. Возможные варианты: \u003Ccode>sms-scope\u003C\u002Fcode>, \u003Ccode>rent-scope\u003C\u002Fcode>, \u003Ccode>free-scope\u003C\u002Fcode>. Можно указать несколько значений\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>state\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Случайная строка для защиты от CSRF (проверьте её после редиректа)\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Col start=\"2\">\n  \u003Cli>После запроса к \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode>, пользователь из Вашего приложения будет перенаправлен на страницу авторизации, где ему необходимо указать логин пароль и, в случае успеха, авторизовать Ваше приложение для работы с данными пользователя в сервисе Onlinesim. Для этого ему необходимо будет нажать кнопку \u003Cem>\u003Ccode>Authorize\u003C\u002Fcode>\u003C\u002Fem>:\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fopenapi_docs\u002Fdocs\u002FOAuthRequest.png\" alt=\"OAuth запрос\">\u003C\u002Fp>\n\u003Caside class=\"my-4 rounded-lg border p-4 text-sm leading-relaxed not-prose border-brand-200 bg-brand-50 text-brand-950\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&_p:last-child]:mb-0 [&_p]:mb-2\">На этом этапе Вы можете проверить параметр \u003Ccode>state\u003C\u002Fcode>\n, для подтверждения безопасного взаимодействия с сервисом авторизации\u003C\u002Fdiv>\u003C\u002Faside>\u003Col start=\"3\">\n  \u003Cli>В случае успешной авторизации пользователь будет перенаправлен по адрес \u003Ccode>redirect_uri\u003C\u002Fcode> с параметром \u003Ccode>access_token\u003C\u002Fcode>. Это и есть необходимый токен для авторизации в API Onlinesim.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Chr>\n\u003Ch3>\u003Cstrong>Авторизация запросов к API Onlinesim\u003C\u002Fstrong>\u003C\u002Fh3>\n\u003Cp>Во все запросы к API нужно добавлять заголовок \u003Cstrong>Authorization: Bearer \u003Cem>\u003Ccode>access_token\u003C\u002Fcode>\u003C\u002Fem>\u003C\u002Fstrong>.\nЕсли в ответ на ваш запрос пришел \u003Ccode>ERROR_WRONG_KEY\u003C\u002Fcode>, Вам необходимо получить новый токен.\u003C\u002Fp>\n\u003Cpre language=\"json\">\u003Ccode class=\"language-json\">{\n  \"response\": \"ERROR_WRONG_KEY\"\n}\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Property\u003C\u002Fth>\n      \u003Cth>Value\u003C\u002Fth>\n    \u003C\u002Ftr>\n  \u003C\u002Fthead>\n  \u003Ctbody>\n    \u003Ctr>\n      \u003Ctd>Тип\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>oauth2\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Ch3>OAuth Flows\u003C\u002Fh3>\n\u003Ch4>implicit\u003C\u002Fh4>\n\u003Cul>\n  \u003Cli>\u003Cstrong>URL авторизации:\u003C\u002Fstrong> \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode>\u003C\u002Fli>\n  \u003Cli>\u003Cstrong>URL обновления:\u003C\u002Fstrong> \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode>\u003C\u002Fli>\n  \u003Cli>\n    \u003Cp>\u003Cstrong>Области:\u003C\u002Fstrong>\u003C\u002Fp>\n    \u003Cul>\n      \u003Cli>\u003Ccode>sms-scope\u003C\u002Fcode>: grants access to manage numbers for the SMS receiving service from Onlinesim\u003C\u002Fli>\n      \u003Cli>\u003Ccode>rent-scope\u003C\u002Fcode>: grants access to renting phone numbers from Onlinesim\u003C\u002Fli>\n      \u003Cli>\u003Ccode>free-scope\u003C\u002Fcode>: grants access to using Onlinesim free numbers\u003C\u002Fli>\n    \u003C\u002Ful>\n  \u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4>authorizationCode\u003C\u002Fh4>\n\u003Cul>\n  \u003Cli>\u003Cstrong>URL авторизации:\u003C\u002Fstrong> \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode>\u003C\u002Fli>\n  \u003Cli>\u003Cstrong>URL токена:\u003C\u002Fstrong> \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode>\u003C\u002Fli>\n  \u003Cli>\n    \u003Cp>\u003Cstrong>Области:\u003C\u002Fstrong>\u003C\u002Fp>\n    \u003Cul>\n      \u003Cli>\u003Ccode>sms-scope\u003C\u002Fcode>: grants access to manage numbers for the SMS receiving service from Onlinesim\u003C\u002Fli>\n      \u003Cli>\u003Ccode>rent-scope\u003C\u002Fcode>: grants access to renting phone numbers from Onlinesim\u003C\u002Fli>\n      \u003Cli>\u003Ccode>free-scope\u003C\u002Fcode>: grants access to using Onlinesim free numbers\u003C\u002Fli>\n    \u003C\u002Ful>\n  \u003C\u002Fli>\n\u003C\u002Ful>",null,1789647087403]