[{"data":1,"prerenderedAt":551},["ShallowReactive",2],{"openapi-specs-catalog":3,"openapi-nav-de-Onlinesim-API-UN":38,"openapi-doc-\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-webhook-logs":173,"openapi-op-\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-webhook-logs":526},["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","This API will allow you to access all services provided by Onlinesim: SMS receiving from a single specific service on a virtual number; rent a number ","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","The API is intended for current and potential Onlinesim partners. It allows you to monetize your numbers by providing them to our customers for receiv","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","Alternative API is compatible with the sms-activate protocol: programs written for it work with Onlinesim after changing the address to https:\u002F\u002Fonline","Alternative-API-UN\u002F","\u002Fopenapi_docs\u002Fspecs\u002FAlternative-API-UN",{"en":19,"ru":20,"de":21},[5,36,37],"ru","de",[39,43,48,53,86,125,134,163],{"text":13,"link":40,"icon":41,"description":42},"\u002Fde\u002FOnlinesim-API-UN\u002Finfo","icons\u002Fdocs\u002Finfo","API-Übersicht und Einführung",{"text":44,"link":45,"icon":46,"description":47},"Autorisierung","\u002Fde\u002FOnlinesim-API-UN\u002Fauth","icons\u002Fdocs\u002Fauth","API-Schlüssel, OAuth und Sicherheitsschemata",{"text":49,"link":50,"icon":51,"description":52},"Komponenten","\u002Fde\u002FOnlinesim-API-UN\u002Fcomponents","icons\u002Fdocs\u002Fcomponents","Gemeinsame Query-Parameter",{"text":54,"collapsed":55,"items":56,"description":84,"icon":85},"profile",false,[57,63,68,74,79],{"text":58,"link":59,"method":60,"path":61,"description":62,"deprecated":55},"getBalance","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getbalance-php","GET","\u002Fapi\u002FgetBalance.php","Guthaben des Profils abrufen",{"text":64,"link":65,"method":60,"path":66,"description":67,"deprecated":55},"getProfile","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getprofile-php","\u002Fapi\u002FgetProfile.php","Profil abrufen",{"text":69,"link":70,"method":71,"path":72,"description":73,"deprecated":55},"setProfile","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-post-api-profile-php","POST","\u002Fapi\u002Fprofile.php","Profil ändern (Webhook-URL und Standardwerte)",{"text":75,"link":76,"method":60,"path":77,"description":78,"deprecated":55},"getPaymentHistory","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getpaymenthistory-php","\u002Fapi\u002FgetPaymentHistory.php","Aufladeverlauf abrufen",{"text":80,"link":81,"method":60,"path":82,"description":83,"deprecated":55},"getWebhookLogs","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-webhook-logs","\u002Fapi\u002Fwebhook-logs","Zustellprotokoll der Webhooks abrufen","ermöglicht den Zugriff auf API-Anfragen, die sich auf das Profil beziehen","icons\u002Fdocs\u002Ffolder",{"text":87,"collapsed":55,"items":88,"description":124,"icon":85},"single-service activations",[89,94,99,104,109,114,119],{"text":90,"link":91,"method":60,"path":92,"description":93,"deprecated":55},"setOperationRevise","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-setoperationrevise-php","\u002Fapi\u002FsetOperationRevise.php","Zur nächsten empfangenen SMS eines Vorgangs wechseln",{"text":95,"link":96,"method":60,"path":97,"description":98,"deprecated":55},"getTariffs","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-gettariffs-php","\u002Fapi\u002FgetTariffs.php","Tarife für Einzelaktivierungen",{"text":100,"link":101,"method":60,"path":102,"description":103,"deprecated":55},"getNumbersStats","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getnumbersstats-php","\u002Fapi\u002FgetNumbersStats.php","Länder mit Diensten, Preisen und Bestand",{"text":105,"link":106,"method":60,"path":107,"description":108,"deprecated":55},"getPrice","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getprice-php","\u002Fapi\u002FgetPrice.php","Preis einer Nummer für einen Dienst",{"text":110,"link":111,"method":60,"path":112,"description":113,"deprecated":55},"getNum","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getnum-php","\u002Fapi\u002FgetNum.php","Virtuelle Nummer für den ausgewählten Dienst kaufen",{"text":115,"link":116,"method":60,"path":117,"description":118,"deprecated":55},"getState","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getstate-php","\u002Fapi\u002FgetState.php","Informationen über Nummern mit aktiven Vorgängen erhalten",{"text":120,"link":121,"method":60,"path":122,"description":123,"deprecated":55},"setOperationOk","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-setoperationok-php","\u002Fapi\u002FsetOperationOk.php","Aktivierungsvorgang abschließen","ermöglicht den Zugriff auf die API für den Empfang von SMS von einzelnen Diensten",{"text":126,"collapsed":55,"items":127,"description":133,"icon":85},"free numbers",[128],{"text":129,"link":130,"method":60,"path":131,"description":132,"deprecated":55},"getFreeList","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getfreelist","\u002Fapi\u002FgetFreeList","Liste der kostenlosen Nummern abrufen","ermöglicht den Zugriff auf die API für kostenlose Nummern",{"text":135,"collapsed":55,"items":136,"description":162,"icon":85},"rent",[137,142,147,152,157],{"text":138,"link":139,"method":60,"path":140,"description":141,"deprecated":55},"tariffsRent","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-rent-tariffsrent-php","\u002Fapi\u002Frent\u002FtariffsRent.php","Informationen zu Tarifen für die Miete von Nummern erhalten",{"text":143,"link":144,"method":60,"path":145,"description":146,"deprecated":55},"getRentNum","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-rent-getrentnum-php","\u002Fapi\u002Frent\u002FgetRentNum.php","Virtuelle Telefonnummer für die Miete kaufen",{"text":148,"link":149,"method":60,"path":150,"description":151,"deprecated":55},"extendRentState","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-rent-extendrentstate-php","\u002Fapi\u002Frent\u002FextendRentState.php","Mietzeit einer virtuellen Nummer verlängern",{"text":153,"link":154,"method":60,"path":155,"description":156,"deprecated":55},"getRentState","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-rent-getrentstate-php","\u002Fapi\u002Frent\u002FgetRentState.php","Informationen zum Status der Mietoperation erhalten",{"text":158,"link":159,"method":60,"path":160,"description":161,"deprecated":55},"closeRentNum","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-rent-closerentnum-php","\u002Fapi\u002Frent\u002FcloseRentNum.php","Mietvorgang für virtuelle Nummer abschließen","ermöglicht den Zugriff auf die API für die Vermietung",{"text":164,"collapsed":55,"items":165,"icon":172},"Webhooks",[166],{"text":167,"link":168,"method":169,"path":170,"description":171,"deprecated":55},"newSmsWebhook","\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-post-newsms","WEBHOOK","\u002FnewSms","SMS über Webhook empfangen","icons\u002Fdocs\u002Fwebhook",{"title":83,"kind":174,"locale":37,"specName":8,"path":81,"operationKey":175,"method":176,"codeSamplesUrl":177,"description":83,"operation":178,"auth":402,"sections":430},"operation","Onlinesim-API-UN-get-api-webhook-logs","get","\u002Fopenapi_docs\u002Fapi\u002Fcode\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-webhook-logs.json",{"tags":179,"summary":180,"x-summary-ru":181,"x-summary-de":83,"description":182,"x-description-ru":183,"x-description-de":184,"operationId":80,"parameters":185,"responses":205,"security":395,"x-sidebar-title":80,"x-sidebar-title-ru":80,"x-sidebar-title-de":80},[54],"\u003Cp>Zustellprotokoll der Webhooks abrufen\u003C\u002Fp>","Получить журнал доставки вебхуков","\u003Cp>Gibt das Zustellprotokoll Ihrer \u003Ccode>newSms\u003C\u002Fcode>-Webhooks zurück, neueste zuerst, 10 pro Seite. Jeder Zustellversuch ist eine eigene Zeile.\u003C\u002Fp>\n\u003Cp>GET und POST werden akzeptiert.\u003C\u002Fp>","Возвращает журнал доставки Ваших вебхуков `newSms`, сначала новые, по 10 на странице. Каждая попытка доставки — отдельная строка.\n\nПринимаются GET и POST.\n","Gibt das Zustellprotokoll Ihrer `newSms`-Webhooks zurück, neueste zuerst, 10 pro Seite. Jeder Zustellversuch ist eine eigene Zeile.\n\nGET und POST werden akzeptiert.\n",[186,195],{"name":187,"in":188,"description":189,"x-description-ru":190,"x-description-de":191,"required":55,"schema":192,"example":194},"page","query","\u003Cp>Seite des Protokolls, 10 Zeilen pro Seite.\u003C\u002Fp>","Страница журнала, по 10 строк на странице.","Seite des Protokolls, 10 Zeilen pro Seite.",{"type":193,"default":194,"minimum":194},"integer",1,{"name":196,"in":188,"description":197,"x-description-ru":198,"x-description-de":199,"required":55,"schema":200},"lang","\u003Cp>Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): \u003Ccode>fr\u003C\u002Fcode>, \u003Ccode>de\u003C\u002Fcode>, \u003Ccode>ru\u003C\u002Fcode>, \u003Ccode>en\u003C\u002Fcode> oder \u003Ccode>zh\u003C\u002Fcode>. Jede Methode akzeptiert ihn; Methoden ohne solche Texte antworten in jeder Sprache gleich. Feldnamen, Fehlercodes und andere feste Werte bleiben auf Englisch. Ohne den Parameter: \u003Ccode>ru\u003C\u002Fcode> für getTariffs, getNumbersStats und getFreeList; sonst die Sprache des Profils bei Anfragen mit Schlüssel, Englisch bei Anfragen ohne. Ein nicht unterstützter Wert wird durch die Standardsprache ersetzt\u003C\u002Fp>","Язык текстов в ответе (названия стран и сервисов, тексты статусов): `fr`, `de`, `ru`, `en` или `zh`. Принимается любым методом; методы без таких текстов отвечают одинаково на любом языке. Названия полей, коды ошибок и другие фиксированные значения остаются на английском. Без параметра: `ru` для getTariffs, getNumbersStats и getFreeList; в остальных — язык профиля для запросов с ключом, английский для запросов без ключа. Неподдерживаемое значение заменяется языком по умолчанию","Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): `fr`, `de`, `ru`, `en` oder `zh`. Jede Methode akzeptiert ihn; Methoden ohne solche Texte antworten in jeder Sprache gleich. Feldnamen, Fehlercodes und andere feste Werte bleiben auf Englisch. Ohne den Parameter: `ru` für getTariffs, getNumbersStats und getFreeList; sonst die Sprache des Profils bei Anfragen mit Schlüssel, Englisch bei Anfragen ohne. Ein nicht unterstützter Wert wird durch die Standardsprache ersetzt",{"type":201,"enum":202,"example":5},"string",[203,37,36,5,204],"fr","zh",{"200":206,"429":361,"456":378},{"description":207,"x-description-ru":208,"x-description-de":209,"content":210},"\u003Cp>Protokollseite oder ein allgemeiner Fehler\u003C\u002Fp>","Страница журнала или общая ошибка","Protokollseite oder ein allgemeiner Fehler",{"application\u002Fjson":211},{"schema":212},{"oneOf":213},[214,353],{"required":215,"properties":218,"type":251},[216,217],"response","data",{"response":219,"data":222},{"type":201,"enum":220,"example":221},[221],"1",{"allOf":223},[224,252],{"description":225,"x-description-ru":226,"x-description-de":227,"properties":228,"type":251},"\u003Cp>Laravel-Paginator.\u003C\u002Fp>","Постраничный список Laravel.","Laravel-Paginator.",{"current_page":229,"data":230,"from":233,"to":236,"last_page":238,"per_page":239,"total":241,"first_page_url":242,"last_page_url":243,"next_page_url":244,"prev_page_url":246,"path":248,"links":249},{"type":193,"example":194},{"type":231,"items":232},"array",{},{"type":234},[193,235],"null",{"type":237},[193,235],{"type":193,"example":194},{"type":193,"example":240},10,{"type":193,"example":194},{"type":201},{"type":201},{"type":245},[201,235],{"type":247},[201,235],{"type":201},{"type":231,"items":250},{"type":251},"object",{"properties":253,"type":251},{"data":254},{"type":231,"items":255},{"required":256,"properties":263,"type":251},[257,258,259,260,261,262],"id","user_id","webhook_url","type","params","status",{"id":264,"user_id":265,"webhook_url":266,"type":267,"params":271,"status":336,"error":344,"created_at":349,"updated_at":351},{"type":193},{"type":193},{"type":201},{"type":201,"enum":268},[269,270],"receiving_sms","rent_sms",{"description":272,"x-description-ru":273,"x-description-de":274,"required":275,"properties":285,"type":251},"\u003Cp>Body des Webhooks \u003Ccode>newSms\u003C\u002Fcode> (dasselbe Objekt ist \u003Ccode>params\u003C\u002Fcode> in webhook-logs). Alle Felder sind immer vorhanden.\u003C\u002Fp>","Тело вебхука `newSms` (тот же объект — `params` в webhook-logs). Все поля присутствуют всегда.","Body des Webhooks `newSms` (dasselbe Objekt ist `params` in webhook-logs). Alle Felder sind immer vorhanden.",[276,277,258,278,279,280,281,282,283,284],"webhook_type","operation_id","country_code","number","sender","message","code","time_start","time_left",{"webhook_type":286,"operation_id":291,"user_id":296,"country_code":301,"number":306,"sender":311,"message":316,"code":321,"time_start":326,"time_left":331},{"description":287,"x-description-ru":288,"x-description-de":289,"type":201,"enum":290},"\u003Cp>\u003Ccode>receiving_sms\u003C\u002Fcode> — Einzeldienst-Aktivierung, \u003Ccode>rent_sms\u003C\u002Fcode> — Miete\u003C\u002Fp>","`receiving_sms` — приём SMS для одного сервиса, `rent_sms` — аренда","`receiving_sms` — Einzeldienst-Aktivierung, `rent_sms` — Miete",[269,270],{"description":292,"x-description-ru":293,"x-description-de":294,"type":193,"example":295},"\u003Cp>Vorgangs-ID (\u003Ccode>tzid\u003C\u002Fcode>)\u003C\u002Fp>","ID операции (`tzid`)","Vorgangs-ID (`tzid`)",91763432,{"description":297,"x-description-ru":298,"x-description-de":299,"type":193,"example":300},"\u003Cp>ID Ihres Profils\u003C\u002Fp>","ID Вашего профиля","ID Ihres Profils",100001,{"description":302,"x-description-ru":303,"x-description-de":304,"type":193,"example":305},"\u003Cp>Vorwahl des Landes der Nummer, siehe Spalte \u003Ccode>Code\u003C\u002Fcode> der \u003Ca href=\"\u002Fopenapi_docs\u002Fde\u002FReseller-API-UN\u002Fcustom\u002Fcountries\">Länderliste\u003C\u002Fa>. Bei Einzeldienst-Aktivierungen kann es ein interner Code eines speziellen Nummernpools sein (zum Beispiel \u003Ccode>1000\u003C\u002Fcode>).\u003C\u002Fp>","Телефонный код страны номера, см. столбец `Код` [списка стран](\u002Fru\u002FReseller-API-UN\u002Fcustom\u002Fcountries). Для приёма SMS это может быть внутренний код специального пула номеров (например, `1000`).","Vorwahl des Landes der Nummer, siehe Spalte `Code` der [Länderliste](\u002Fde\u002FReseller-API-UN\u002Fcustom\u002Fcountries). Bei Einzeldienst-Aktivierungen kann es ein interner Code eines speziellen Nummernpools sein (zum Beispiel `1000`).",7,{"description":307,"x-description-ru":308,"x-description-de":309,"type":201,"example":310},"\u003Cp>Einzeldienst-Aktivierung: \u003Ccode>+\u003C\u002Fcode> und die vollständige Nummer oder \u003Ccode>hidden\u003C\u002Fcode>, wenn die Nummer nicht angezeigt wird. Miete: die vollständige Nummer in Ziffern, ohne \u003Ccode>+\u003C\u002Fcode>.\u003C\u002Fp>","Приём SMS: `+` и полный номер или `hidden`, если номер не показывается. Аренда: полный номер цифрами, без `+`.","Einzeldienst-Aktivierung: `+` und die vollständige Nummer oder `hidden`, wenn die Nummer nicht angezeigt wird. Miete: die vollständige Nummer in Ziffern, ohne `+`.","+79001234567",{"description":312,"x-description-ru":313,"x-description-de":314,"type":201,"example":315},"\u003Cp>Name oder Nummer des Absenders. Bei Einzeldienst-Aktivierungen kann stattdessen der Dienstcode kommen (zum Beispiel \u003Ccode>vkcom\u003C\u002Fcode>).\u003C\u002Fp>","Имя или номер отправителя. Для приёма SMS вместо него может прийти код сервиса (например, `vkcom`).","Name oder Nummer des Absenders. Bei Einzeldienst-Aktivierungen kann stattdessen der Dienstcode kommen (zum Beispiel `vkcom`).","VK",{"description":317,"x-description-ru":318,"x-description-de":319,"type":201,"example":320},"\u003Cp>SMS-Text. Bei der Miete wird eine SMS von einem Absender, den der Dienst nicht annimmt, durch einen Hinweistext ersetzt.\u003C\u002Fp>","Текст SMS. В аренде SMS от отправителя, которого сервис не принимает, заменяется текстом уведомления.","SMS-Text. Bei der Miete wird eine SMS von einem Absender, den der Dienst nicht annimmt, durch einen Hinweistext ersetzt.","VK: 195895 is your code",{"description":322,"x-description-ru":323,"x-description-de":324,"type":201,"example":325},"\u003Cp>Im SMS-Text gefundener Bestätigungscode; leere Zeichenkette, wenn keiner gefunden wurde\u003C\u002Fp>","Код подтверждения, найденный в тексте SMS; пустая строка, если код не найден","Im SMS-Text gefundener Bestätigungscode; leere Zeichenkette, wenn keiner gefunden wurde","195895",{"description":327,"x-description-ru":328,"x-description-de":329,"type":201,"example":330},"\u003Cp>Einzeldienst-Aktivierung: Zeitpunkt der Bestellung des Vorgangs. Miete: Zeitpunkt des SMS-Empfangs. Format \u003Ccode>YYYY-MM-DD HH:MM:SS\u003C\u002Fcode>.\u003C\u002Fp>","Приём SMS: время заказа операции. Аренда: время получения SMS. Формат `YYYY-MM-DD HH:MM:SS`.","Einzeldienst-Aktivierung: Zeitpunkt der Bestellung des Vorgangs. Miete: Zeitpunkt des SMS-Empfangs. Format `YYYY-MM-DD HH:MM:SS`.","2026-04-26 12:37:55",{"description":332,"x-description-ru":333,"x-description-de":334,"type":193,"example":335},"\u003Cp>Verbleibende Vorgangszeit: in Sekunden bei Einzeldienst-Aktivierungen, in Minuten bei der Miete\u003C\u002Fp>","Оставшееся время операции: в секундах для приёма SMS, в минутах для аренды","Verbleibende Vorgangszeit: in Sekunden bei Einzeldienst-Aktivierungen, in Minuten bei der Miete",880,{"description":337,"x-description-ru":338,"x-description-de":339,"type":201,"enum":340},"\u003Cp>\u003Ccode>pending\u003C\u002Fcode> — wird gesendet, \u003Ccode>success\u003C\u002Fcode> — zugestellt, \u003Ccode>fail\u003C\u002Fcode> — nicht zugestellt (siehe \u003Ccode>error\u003C\u002Fcode>)\u003C\u002Fp>","`pending` — отправляется, `success` — доставлен, `fail` — не доставлен (см. `error`)","`pending` — wird gesendet, `success` — zugestellt, `fail` — nicht zugestellt (siehe `error`)",[341,342,343],"success","fail","pending",{"description":345,"x-description-ru":346,"x-description-de":347,"type":348},"\u003Cp>Text des Zustellfehlers\u003C\u002Fp>","Текст ошибки доставки","Text des Zustellfehlers",[201,235],{"type":201,"example":350},"2026-11-19 10:00:01",{"type":201,"example":352},"2026-11-19 10:00:02",{"required":354,"properties":355,"type":251,"additionalProperties":360},[216],{"response":356},{"description":357,"x-description-ru":358,"x-description-de":359,"type":201},"\u003Cp>Fehlercode. Die Codes, die jede Methode liefern kann, stehen in der Einleitung; jede Methode führt ihre eigenen auf. Die Liste ist nicht geschlossen: behandeln Sie einen unbekannten Code als allgemeinen Fehler und protokollieren Sie ihn.\u003C\u002Fp>","Код ошибки. Коды, которые может вернуть любой метод, перечислены во введении; у каждого метода — свои. Список не закрыт: неизвестный код обрабатывайте как общую ошибку и записывайте в лог.","Fehlercode. Die Codes, die jede Methode liefern kann, stehen in der Einleitung; jede Methode führt ihre eigenen auf. Die Liste ist nicht geschlossen: behandeln Sie einen unbekannten Code als allgemeinen Fehler und protokollieren Sie ihn.",true,{"description":362,"x-description-ru":363,"x-description-de":364,"content":365},"\u003Cp>HTTP 429: mehr als 400 Anfragen pro Minute von einem Profil (von einer IP bei Anfragen ohne Schlüssel) oder mehr als 200 Anfragen pro Minute von einem Profil an getNum, getPrice, getState und setOperationOk zusammen\u003C\u002Fp>","HTTP 429: больше 400 запросов в минуту с одного профиля (с одного IP для запросов без ключа) или больше 200 запросов в минуту с одного профиля к getNum, getPrice, getState и setOperationOk вместе","HTTP 429: mehr als 400 Anfragen pro Minute von einem Profil (von einer IP bei Anfragen ohne Schlüssel) oder mehr als 200 Anfragen pro Minute von einem Profil an getNum, getPrice, getState und setOperationOk zusammen",{"application\u002Fjson":366},{"schema":367,"examples":371},{"required":368,"properties":369,"type":251,"additionalProperties":360},[216],{"response":370},{"description":357,"x-description-ru":358,"x-description-de":359,"type":201},{"Rate limit":372},{"summary":373,"x-summary-ru":374,"x-summary-de":375,"value":376},"\u003Cp>Anfragelimit überschritten\u003C\u002Fp>","Превышен лимит запросов","Anfragelimit überschritten",{"response":377},"TRY_AGAIN_LATER",{"description":379,"x-description-ru":380,"x-description-de":381,"content":382},"\u003Cp>HTTP 456: Der API-Schlüssel ist ungültig oder das OAuth-Token ist abgelaufen. Öffentliche Methoden antworten genauso, wenn ein ungültiger Schlüssel übergeben wird\u003C\u002Fp>","HTTP 456: API-ключ неверный или OAuth-токен истёк. Публичные методы отвечают так же, если передан неверный ключ","HTTP 456: Der API-Schlüssel ist ungültig oder das OAuth-Token ist abgelaufen. Öffentliche Methoden antworten genauso, wenn ein ungültiger Schlüssel übergeben wird",{"application\u002Fjson":383},{"schema":384,"examples":388},{"required":385,"properties":386,"type":251,"additionalProperties":360},[216],{"response":387},{"description":357,"x-description-ru":358,"x-description-de":359,"type":201},{"Invalid key":389},{"summary":390,"x-summary-ru":391,"x-summary-de":392,"value":393},"\u003Cp>Ungültiger API-Schlüssel oder abgelaufenes Token\u003C\u002Fp>","Неверный API-ключ или истёкший токен","Ungültiger API-Schlüssel oder abgelaufenes Token",{"response":394},"ERROR_WRONG_KEY",[396,398,400],{"apikey":397},[],{"BearerAuth":399},[],{"OAuth2":401},[],{"apikey":403,"BearerAuth":409,"OAuth2":415},{"type":404,"description":405,"x-description-ru":406,"x-description-de":407,"name":408,"in":188},"apiKey","\u003Cp>Geheimer Schlüssel, der für die vereinfachte Autorisierung in der Onlinesim API verwendet wird.\u003C\u002Fp>\n\u003Chr>\n\u003Ch4>So erhalten Sie einen API-Schlüssel:\u003C\u002Fh4>\n\u003Col>\n  \u003Cli>Melden Sie sich im persönlichen Konto an, gehen Sie zu den \u003Ca href=\"\u002Fv2\u002Fprofile\u002F\">Profileinstellungen\u003C\u002Fa>, wählen Sie die Registerkarte \u003Cstrong>API\u003C\u002Fstrong>.\u003C\u002Fli>\n  \u003Cli>Der Schlüssel wird in der Zeile \u003Ccode>API key\u003C\u002Fcode> angezeigt. Er muss kopiert und zu Ihrer Anwendung\u002FProgramm hinzugefügt werden.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Chr>\n\u003Ch4>So verwenden Sie ihn:\u003C\u002Fh4>\n\u003Col>\n  \u003Cli>Alle Anfragen an die aktuelle Onlinesim API (außer den öffentlichen: \u003Ca href=\"\u002Fopenapi_docs\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-gettariffs-php\">getTariffs\u003C\u002Fa>, \u003Ca href=\"\u002Fopenapi_docs\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getnumbersstats-php\">getNumbersStats\u003C\u002Fa>, \u003Ca href=\"\u002Fopenapi_docs\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-rent-tariffsrent-php\">tariffsRent\u003C\u002Fa> und \u003Ca href=\"\u002Fopenapi_docs\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getfreelist\">getFreeList\u003C\u002Fa>) müssen einen API-Schlüssel enthalten. Eine öffentliche Methode prüft einen übergebenen Schlüssel trotzdem.\u003C\u002Fli>\n  \u003Cli>\n    \u003Cp>Der API-Schlüssel kann als Anfrageparameter angegeben werden, z. B.:\u003C\u002Fp>\n    \u003Cpre data-lang=\"text\">\u003Ccode class=\"code-hl code-ln\" style=\"--ln-digits:1\">\u003Cspan class=\"line\">   https:\u002F\u002Fonlinesim.io\u002Fapi\u002FgetBalance.php?apikey={apikey}\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\n    \u003Cp>Der Schlüssel wird auch im Header \u003Ccode>Authorization: Bearer\u003C\u002Fcode> (siehe BearerAuth), in einem Header \u003Ccode>apikey\u003C\u002Fcode>, als Feld \u003Ccode>apikey\u003C\u002Fcode> eines POST-Bodys und unter dem Namen \u003Ccode>key\u003C\u002Fcode> an jeder dieser Stellen akzeptiert.\u003C\u002Fp>\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 theme-dark:text-gray-800\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&amp;_p:last-child]:mb-0 [&amp;_p]:mb-2\">\u003Cp>Die Verwendung des API-Schlüssels ist eine Methode zur vereinfachten Autorisierung von Anfragen. Wir empfehlen die Verwendung von OAuth 2.0 für eine sicherere Arbeit mit Daten.\u003C\u002Fp>\n\u003Cp>Für weitere Informationen wenden Sie sich bitte an die \u003Ca href=\"https:\u002F\u002Foauth.net\u002F2\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">offizielle OAuth 2.0-Dokumentation\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Faside>","Секретный ключ, используемый для упрощенной авторизации в API Onlinesim.\n\n---\n\n#### Как получить API ключ:\n\n1. Авторизоваться в личном кабинете, перейти в [настройки профиля](https:\u002F\u002Fonlinesim.io\u002Fv2\u002Fprofile\u002F), выбрать вкладку **API**.\n2. Ключ будет указан в строке `API key`. Его необходимо скопировать и добавить в Ваше приложение\u002Fпрограмму.\n\n---\n\n#### Как использовать:\n\n1. Все запросы к текущемуAPI Onlinesim (кроме публичных: [getTariffs](\u002Fru\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-gettariffs-php), [getNumbersStats](\u002Fru\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getnumbersstats-php), [tariffsRent](\u002Fru\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-rent-tariffsrent-php) и [getFreeList](\u002Fru\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getfreelist)) должны содержать API ключ. Публичный метод всё равно проверяет ключ, если он передан.\n2. API ключ можно указать как параметр запроса, например:\n\n          https:\u002F\u002Fonlinesim.io\u002Fapi\u002FgetBalance.php?apikey={apikey}\n\n   Ключ также принимается в заголовке `Authorization: Bearer` (см. BearerAuth), в заголовке `apikey`, в поле `apikey` тела POST-запроса и под именем `key` в любом из этих мест.\n\n::: tip\nИспользование API ключа представляет собой способ для упрощенной авторизации запросов. Мы рекомендуем использовать OAuth 2.0 для более безопасной работы с данными.\n\nДля получения более подробной информации, пожалуйста, обратитесь к [официальной документации OAuth 2.0](https:\u002F\u002Foauth.net\u002F2\u002F).\n:::\n","Geheimer Schlüssel, der für die vereinfachte Autorisierung in der Onlinesim API verwendet wird.\n\n---\n\n#### So erhalten Sie einen API-Schlüssel:\n\n1. Melden Sie sich im persönlichen Konto an, gehen Sie zu den [Profileinstellungen](https:\u002F\u002Fonlinesim.io\u002Fv2\u002Fprofile\u002F), wählen Sie die Registerkarte **API**.\n2. Der Schlüssel wird in der Zeile `API key` angezeigt. Er muss kopiert und zu Ihrer Anwendung\u002FProgramm hinzugefügt werden.\n\n---\n\n#### So verwenden Sie ihn:\n\n1. Alle Anfragen an die aktuelle Onlinesim API (außer den öffentlichen: [getTariffs](\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-gettariffs-php), [getNumbersStats](\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getnumbersstats-php), [tariffsRent](\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-rent-tariffsrent-php) und [getFreeList](\u002Fde\u002FOnlinesim-API-UN\u002FOnlinesim-API-UN-get-api-getfreelist)) müssen einen API-Schlüssel enthalten. Eine öffentliche Methode prüft einen übergebenen Schlüssel trotzdem.\n2. Der API-Schlüssel kann als Anfrageparameter angegeben werden, z. B.:\n\n          https:\u002F\u002Fonlinesim.io\u002Fapi\u002FgetBalance.php?apikey={apikey}\n\n   Der Schlüssel wird auch im Header `Authorization: Bearer` (siehe BearerAuth), in einem Header `apikey`, als Feld `apikey` eines POST-Bodys und unter dem Namen `key` an jeder dieser Stellen akzeptiert.\n\n::: tip\nDie Verwendung des API-Schlüssels ist eine Methode zur vereinfachten Autorisierung von Anfragen. Wir empfehlen die Verwendung von OAuth 2.0 für eine sicherere Arbeit mit Daten.\n\nFür weitere Informationen wenden Sie sich bitte an die [offizielle OAuth 2.0-Dokumentation](https:\u002F\u002Foauth.net\u002F2\u002F).\n:::\n","apikey",{"type":410,"description":411,"x-description-ru":412,"x-description-de":413,"scheme":414},"http","\u003Cp>Der API-Schlüssel kann auch für die Autorisierung im Anfrageheader verwendet werden, indem das Schema \u003Ccode>Authorization: Bearer\u003C\u002Fcode> verwendet wird, z. B.:\u003C\u002Fp>\n\u003Cpre data-lang=\"bash\">\u003Ccode class=\"code-hl code-ln\" style=\"--ln-digits:1\">\u003Cspan class=\"line\">\u003Cspan class=\"tok-fn\">curl\u003C\u002Fspan> \u003Cspan class=\"tok-var\">-H\u003C\u002Fspan> \u003Cspan class=\"tok-string\">&quot;Authorization: Bearer {apikey}&quot;\u003C\u002Fspan> https:\u002F\u002Fonlinesim.io\u002Fapi\u002FgetBalance.php\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Derselbe Header überträgt ein OAuth 2.0 Access Token (siehe OAuth2).\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 theme-dark:text-gray-800\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&amp;_p:last-child]:mb-0 [&amp;_p]:mb-2\">\u003Cp>Die Verwendung des API-Schlüssels ist eine Methode zur vereinfachten Autorisierung von Anfragen. Wir empfehlen die Verwendung von OAuth 2.0 für eine sicherere Arbeit mit Daten.\u003C\u002Fp>\n\u003Cp>Für weitere Informationen wenden Sie sich bitte an die \u003Ca href=\"https:\u002F\u002Foauth.net\u002F2\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">offizielle OAuth 2.0-Dokumentation\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Faside>","API ключ также можно использовать для авторизации в заголовке запроса, используя схему `Authorization: Bearer`, например:\n\n```bash\ncurl -H \"Authorization: Bearer {apikey}\" https:\u002F\u002Fonlinesim.io\u002Fapi\u002FgetBalance.php\n```\n\nТот же заголовок передаёт access token OAuth 2.0 (см. OAuth2).\n\n::: tip\nИспользование API ключа представляет собой способ для упрощенной авторизации запросов. Мы рекомендуем использовать OAuth 2.0 для более безопасной работы с данными.\n\nДля получения более подробной информации, пожалуйста, обратитесь к [официальной документации OAuth 2.0](https:\u002F\u002Foauth.net\u002F2\u002F).\n:::\n","Der API-Schlüssel kann auch für die Autorisierung im Anfrageheader verwendet werden, indem das Schema `Authorization: Bearer` verwendet wird, z. B.:\n\n```bash\ncurl -H \"Authorization: Bearer {apikey}\" https:\u002F\u002Fonlinesim.io\u002Fapi\u002FgetBalance.php\n```\n\nDerselbe Header überträgt ein OAuth 2.0 Access Token (siehe OAuth2).\n\n::: tip\nDie Verwendung des API-Schlüssels ist eine Methode zur vereinfachten Autorisierung von Anfragen. Wir empfehlen die Verwendung von OAuth 2.0 für eine sicherere Arbeit mit Daten.\n\nFür weitere Informationen wenden Sie sich bitte an die [offizielle OAuth 2.0-Dokumentation](https:\u002F\u002Foauth.net\u002F2\u002F).\n:::\n","bearer",{"type":416,"description":417,"x-description-ru":418,"x-description-de":419,"flows":420},"oauth2","\u003Cp>\u003Cspan id=\"OAUTH\">\u003C\u002Fspan>\u003C\u002Fp>\n\u003Ch3>OAuth 2.0\u003C\u002Fh3>\n\u003Cp>Das OAuth 2.0-Protokoll unterstützt mehrere Autorisierungsszenarien. Für die Arbeit mit unserer API können Sie die Szenarien Authorization Code Flow oder Implicit Flow verwenden.\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 theme-dark:text-gray-800\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&amp;_p:last-child]:mb-0 [&amp;_p]:mb-2\">Für weitere Informationen wenden Sie sich bitte an die \u003Ca href=\"https:\u002F\u002Foauth.net\u002F2\u002F\" target=\"_blank\" rel=\"noopener noreferrer\">offizielle OAuth 2.0-Dokumentation\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> gewährt Zugriff auf die Verwaltung von Nummern für den Dienst \"SMS-Empfang\" von Onlinesim;\u003C\u002Fli>\n  \u003Cli>\u003Ccode>rent-scope\u003C\u002Fcode> gewährt Zugriff auf die Vermietung virtueller Telefonnummern von Onlinesim;\u003C\u002Fli>\n  \u003Cli>\u003Ccode>free-scope\u003C\u002Fcode> gewährt Zugriff auf die Verwendung kostenloser Nummern von Onlinesim.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Ein Scope wird nur dort geprüft, wo die Methode ihn braucht: \u003Ccode>sms-scope\u003C\u002Fcode> — getTariffs und getNumbersStats, \u003Ccode>rent-scope\u003C\u002Fcode> — die Mietmethoden, \u003Ccode>free-scope\u003C\u002Fcode> — getFreeList. Die übrigen Methoden akzeptieren jedes gültige Token. Ein ohne \u003Ccode>scope\u003C\u002Fcode> ausgestelltes Token erhält \u003Ccode>sms-scope\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>Ein Access Token gilt 2 Monate, ein Refresh Token 4 Monate (\u003Ccode>expires_in\u003C\u002Fcode> in der Token-Antwort ist in Sekunden).\u003C\u002Fp>\n\u003Ch3>\u003Cstrong>Registrierung Ihrer Anwendung auf unserem Autorisierungsdienst\u003C\u002Fstrong>\u003C\u002Fh3>\n\u003Col>\n  \u003Cli>Gehen Sie zur \u003Ca href=\"\u002Foauth\">OAuth-Seite\u003C\u002Fa>\u003C\u002Fli>\n  \u003Cli>\n    \u003Cp>Erstellen Sie einen neuen Client und geben Sie an:\u003C\u002Fp>\n    \u003Cul>\n      \u003Cli>\u003Ccode>Name\u003C\u002Fcode> - Name der Anwendung oder ein anderer Name, den Sie und Ihre Benutzer mit der Anwendung assoziieren werden;\u003C\u002Fli>\n      \u003Cli>\u003Ccode>Redirect URL\u003C\u002Fcode> - URL, an die der Client nach der Autorisierung weitergeleitet wird und wohin der Autorisierungscode der Anwendung gesendet wird;\u003C\u002Fli>\n      \u003Cli>\u003Ccode>Confidential\u003C\u002Fcode> - optional, markieren Sie den Client als \u003Cem>Confidential\u003C\u002Fem>, wenn Ihre Anwendung auf einem Server läuft und den \u003Cem>Client Secret\u003C\u002Fem> sicher speichern kann.\u003C\u002Fli>\n    \u003C\u002Ful>\n  \u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fopenapi_docs\u002Fdocs\u002FCreateOAuthClient.png\" alt=\"Client erstellen\">\u003C\u002Fp>\n\u003Col start=\"3\">\n  \u003Cli>Klicken Sie auf \"Create\". Ihre hinzugefügte Anwendung wird in der Liste der Clients angezeigt.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fopenapi_docs\u002Fdocs\u002FOAuthClient.png\" alt=\"Client-Liste\">\u003C\u002Fp>\n\u003Col start=\"4\">\n  \u003Cli>Speichern Sie \u003Ccode>Client ID\u003C\u002Fcode> und \u003Ccode>Secret\u003C\u002Fcode> an einem sicheren Ort, sie werden von Ihrer Anwendung für die Autorisierung verwendet.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cspan id=\"AUTHCODE\">\u003C\u002Fspan>\u003C\u002Fp>\n\u003Ch3>OAuth 2.0. Authorization Code Flow\u003C\u002Fh3>\n\u003Ch4>\u003Cstrong>Benutzerautorisierung und Token-Erhaltung\u003C\u002Fstrong>\u003C\u002Fh4>\n\u003Col>\n  \u003Cli>Autorisieren Sie den Client über eine GET-Anfrage an \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode> mit den Parametern \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>Parameterbeschreibung\u003C\u002Fh5>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Parametername\u003C\u002Fth>\n      \u003Cth style=\"text-align:center\">Datentyp\u003C\u002Fth>\n      \u003Cth>Beschreibung\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>, der nach der Registrierung der Anwendung erhalten wurde\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>redirect_uri\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Adresse, an die der Client nach erfolgreicher Autorisierung weitergeleitet wird, muss mit der \u003Ccode>Redirect URL\u003C\u002Fcode> übereinstimmen, die Sie bei der Registrierung der Anwendung angegeben haben.\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>response_type\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Geben Sie \u003Ccode>code\u003C\u002Fcode> an\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>scope\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Zugriffsrechte, deren Genehmigung Ihre Anwendung vom Benutzer anfordert. Mögliche Optionen: \u003Ccode>sms-scope\u003C\u002Fcode>, \u003Ccode>rent-scope\u003C\u002Fcode>, \u003Ccode>free-scope\u003C\u002Fcode>. Mehrere Werte können angegeben werden\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>state\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Zufällige Zeichenfolge zum Schutz vor CSRF (überprüfen Sie sie nach der Weiterleitung)\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>code_challenge\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Pflicht für einen nicht als Confidential markierten Client (PKCE): BASE64URL(SHA256(\u003Ccode>code_verifier\u003C\u002Fcode>))\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>code_challenge_method\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>\u003Ccode>S256\u003C\u002Fcode>\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Col start=\"2\">\n  \u003Cli>Nach der Anfrage an \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode> wird der Benutzer aus Ihrer Anwendung zur Autorisierungsseite weitergeleitet, wo er Benutzername und Passwort eingeben muss und bei Erfolg Ihre Anwendung für die Arbeit mit den Benutzerdaten im Onlinesim-Dienst autorisieren muss. Dazu muss er auf die Schaltfläche \u003Cem>\u003Ccode>Authorize\u003C\u002Fcode>\u003C\u002Fem> klicken:\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fopenapi_docs\u002Fdocs\u002FOAuthRequest.png\" alt=\"OAuth-Anfrage\">\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 theme-dark:text-gray-800\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&amp;_p:last-child]:mb-0 [&amp;_p]:mb-2\">Auf dieser Stufe können Sie den Parameter \u003Ccode>state\u003C\u002Fcode>\n überprüfen, um die sichere Interaktion mit dem Autorisierungsdienst zu bestätigen\u003C\u002Fdiv>\u003C\u002Faside>\u003Col start=\"3\">\n  \u003Cli>Bei erfolgreicher Autorisierung wird der Benutzer an die Adresse \u003Ccode>redirect_uri\u003C\u002Fcode> mit dem Parameter \u003Ccode>code\u003C\u002Fcode> weitergeleitet. Jetzt können Sie ein \u003Ccode>access token\u003C\u002Fcode> erhalten, dazu müssen Sie eine POST-Anfrage an \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode> stellen:\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch5>Parameterbeschreibung\u003C\u002Fh5>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Parametername\u003C\u002Fth>\n      \u003Cth style=\"text-align:center\">Datentyp\u003C\u002Fth>\n      \u003Cth>Beschreibung\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>Autorisierungsszenario, für das Szenario Authorization Code müssen Sie \u003Ccode>authorization_code\u003C\u002Fcode> angeben\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>, der nach der Registrierung der Anwendung erhalten wurde\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>, der nach der Registrierung der Anwendung erhalten wurde\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>redirect_uri\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Adresse, an die der Client nach erfolgreicher Autorisierung weitergeleitet wird, muss mit der \u003Ccode>Redirect URL\u003C\u002Fcode> übereinstimmen, die Sie bei der Registrierung der Anwendung angegeben haben\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>code\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Autorisierungscode, der in der vorherigen Stufe erhalten wurde\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>code_verifier\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Die Zufallszeichenfolge, aus der \u003Ccode>code_challenge\u003C\u002Fcode> erzeugt wurde (nicht als Confidential markierte Clients)\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 theme-dark:text-red-800\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&amp;_p:last-child]:mb-0 [&amp;_p]:mb-2\">Da \u003Ccode>client_secret\u003C\u002Fcode>\n ein privater Schlüssel ist, wird nicht empfohlen, ihn im Frontend des Clients zu speichern. Für mehr Sicherheit muss er im Backend Ihrer Anwendung gespeichert werden. Um das Szenario mit dem Autorisierungscode zu implementieren, muss der vom Frontend erhaltene Code an das Backend Ihres Dienstes übergeben werden, und dieses muss sich dann an den Autorisierungsdienst wenden, um das Token zu erhalten.\u003C\u002Fdiv>\u003C\u002Faside>\u003Col start=\"4\">\n  \u003Cli>Als Ergebnis einer erfolgreichen Anfrage an \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode> erhalten Sie eine JSON-Antwort, die die Felder \u003Ccode>access_token\u003C\u002Fcode>, \u003Ccode>refresh_token\u003C\u002Fcode> und \u003Ccode>expires_in\u003C\u002Fcode> enthält. Das Feld \u003Ccode>expires_in\u003C\u002Fcode> bestimmt die Anzahl der Sekunden bis zum Ablauf des Zugriffstokens, \u003Ccode>refresh_token\u003C\u002Fcode> wird verwendet, um das Zugriffstoken bei Ablauf zu aktualisieren.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Chr>\n\u003Ch4>\u003Cstrong>Autorisierung von Anfragen an die Onlinesim API und Token-Aktualisierung\u003C\u002Fstrong>\u003C\u002Fh4>\n\u003Cp>Zu allen Anfragen an die API muss der Header \u003Cstrong>Authorization: Bearer \u003Cem>\u003Ccode>access_token\u003C\u002Fcode>\u003C\u002Fem>\u003C\u002Fstrong> hinzugefügt werden.\nWenn als Antwort auf Ihre Anfrage \u003Ccode>ERROR_WRONG_KEY\u003C\u002Fcode> (HTTP 456) kam, müssen Sie das Token aktualisieren oder ein neues erhalten.\u003C\u002Fp>\n\u003Cpre data-lang=\"json\">\u003Ccode class=\"code-hl code-ln\" style=\"--ln-digits:1\">\u003Cspan class=\"line\">\u003Cspan class=\"tok-punct\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">  \u003Cspan class=\"tok-key\">&quot;response&quot;\u003C\u002Fspan>\u003Cspan class=\"tok-punct\">:\u003C\u002Fspan> \u003Cspan class=\"tok-string\">&quot;ERROR_WRONG_KEY&quot;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan class=\"tok-punct\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Um das Token zu aktualisieren, müssen Sie eine POST-Anfrage an \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken\u003C\u002Fcode> mit den Parametern \u003Ccode>grant_type\u003C\u002Fcode>, \u003Ccode>client_id\u003C\u002Fcode>, \u003Ccode>client_secret\u003C\u002Fcode> und \u003Ccode>refresh_token\u003C\u002Fcode> stellen. Für das Feld \u003Ccode>refresh_token\u003C\u002Fcode> muss der Wert verwendet werden, der in Schritt 4 erhalten wurde.\u003C\u002Fp>\n\u003Ch5>Parameterbeschreibung\u003C\u002Fh5>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Parametername\u003C\u002Fth>\n      \u003Cth style=\"text-align:center\">Datentyp\u003C\u002Fth>\n      \u003Cth>Beschreibung\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>Sie müssen \u003Ccode>refresh_token\u003C\u002Fcode> angeben\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>, den Sie bei der Registrierung der Anwendung erhalten haben\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>, der bei der Registrierung der Anwendung erhalten wurde\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> wurde zusammen mit \u003Ccode>access_token\u003C\u002Fcode> erhalten. Hat eine viel längere Lebensdauer und wird verwendet, um \u003Ccode>access_token\u003C\u002Fcode> zu aktualisieren\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>\u003Cspan id=\"IMPLICIT\">\u003C\u002Fspan>\u003C\u002Fp>\n\u003Ch3>OAuth 2.0. Implicit Flow\u003C\u002Fh3>\n\u003Ch4>\u003Cstrong>Benutzerautorisierung und Token-Erhaltung\u003C\u002Fstrong>\u003C\u002Fh4>\n\u003Col>\n  \u003Cli>Autorisieren Sie den Client über eine GET-Anfrage an \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode> mit den Parametern \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>Parameterbeschreibung\u003C\u002Fh5>\n\u003Ctable>\n  \u003Cthead>\n    \u003Ctr>\n      \u003Cth>Parametername\u003C\u002Fth>\n      \u003Cth style=\"text-align:center\">Datentyp\u003C\u002Fth>\n      \u003Cth>Beschreibung\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>, der bei der Registrierung der Anwendung erhalten wurde\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>redirect_uri\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Adresse, an die der Client nach erfolgreicher Autorisierung weitergeleitet wird, muss mit der \u003Ccode>Redirect URL\u003C\u002Fcode> übereinstimmen, die Sie beim Hinzufügen der Anwendung angegeben haben.\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>response_type\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Verwenden Sie \u003Ccode>token\u003C\u002Fcode> als Wert\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>scope\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Zugriffsrechte, deren Genehmigung Ihre Anwendung vom Benutzer anfordert. Mögliche Optionen: \u003Ccode>sms-scope\u003C\u002Fcode>, \u003Ccode>rent-scope\u003C\u002Fcode>, \u003Ccode>free-scope\u003C\u002Fcode>. Mehrere Werte können angegeben werden\u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd>state\u003C\u002Ftd>\n      \u003Ctd style=\"text-align:center\">STRING\u003C\u002Ftd>\n      \u003Ctd>Zufällige Zeichenfolge zum Schutz vor CSRF (überprüfen Sie sie nach der Weiterleitung)\u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Col start=\"2\">\n  \u003Cli>Nach der Anfrage an \u003Ccode>https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize\u003C\u002Fcode> wird der Benutzer aus Ihrer Anwendung zur Autorisierungsseite weitergeleitet, wo er Benutzername und Passwort eingeben muss und bei Erfolg Ihre Anwendung für die Arbeit mit den Benutzerdaten im Onlinesim-Dienst autorisieren muss. Dazu muss er auf die Schaltfläche \u003Cem>\u003Ccode>Authorize\u003C\u002Fcode>\u003C\u002Fem> klicken:\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fopenapi_docs\u002Fdocs\u002FOAuthRequest.png\" alt=\"OAuth-Anfrage\">\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 theme-dark:text-gray-800\" role=\"note\">\u003Cdiv class=\"openapi-callout-body [&amp;_p:last-child]:mb-0 [&amp;_p]:mb-2\">Auf dieser Stufe können Sie den Parameter \u003Ccode>state\u003C\u002Fcode>\n überprüfen, um die sichere Interaktion mit dem Autorisierungsdienst zu bestätigen\u003C\u002Fdiv>\u003C\u002Faside>\u003Col start=\"3\">\n  \u003Cli>Bei erfolgreicher Autorisierung wird der Benutzer an die Adresse \u003Ccode>redirect_uri\u003C\u002Fcode> mit dem Parameter \u003Ccode>access_token\u003C\u002Fcode> weitergeleitet. Dies ist das erforderliche Token für die Autorisierung in der Onlinesim API.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Chr>\n\u003Ch3>\u003Cstrong>Autorisierung von Anfragen an die Onlinesim API\u003C\u002Fstrong>\u003C\u002Fh3>\n\u003Cp>Zu allen Anfragen an die API muss der Header \u003Cstrong>Authorization: Bearer \u003Cem>\u003Ccode>access_token\u003C\u002Fcode>\u003C\u002Fem>\u003C\u002Fstrong> hinzugefügt werden.\nWenn als Antwort auf Ihre Anfrage \u003Ccode>ERROR_WRONG_KEY\u003C\u002Fcode> (HTTP 456) kam, müssen Sie ein neues Token erhalten: der Implicit Flow liefert kein Refresh Token.\u003C\u002Fp>\n\u003Cpre data-lang=\"json\">\u003Ccode class=\"code-hl code-ln\" style=\"--ln-digits:1\">\u003Cspan class=\"line\">\u003Cspan class=\"tok-punct\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">  \u003Cspan class=\"tok-key\">&quot;response&quot;\u003C\u002Fspan>\u003Cspan class=\"tok-punct\">:\u003C\u002Fspan> \u003Cspan class=\"tok-string\">&quot;ERROR_WRONG_KEY&quot;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan class=\"tok-punct\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cspan id=\"OAUTH\">\u003C\u002Fspan>\n### OAuth 2.0\nПротокол OAuth 2.0 поддерживает несколько сценариев авторизации, для работы с нашим API можно использовать сценарии Authorization Code Flow или Implicit Flow.\n\n::: info\nДля получения более подробной информации, пожалуйста, обратитесь к [официальной документации OAuth 2.0](https:\u002F\u002Foauth.net\u002F2\u002F).\n:::\n\n**Authorization URL**: `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize`\n\n**Token URL**: `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken`\n\n**Scopes**:\n\n  - `sms-scope` открывает доступ к управлению номерами для услуги \"Прием SMS\" от Onlinesim;\n  \n  - `rent-scope` открывает доступ к аренде виртуальных телефонных номеров Onlinesim;\n  \n  - `free-scope` открывает доступ к использованию бесплатных номеров Onlinesim.\n\nScope проверяется только там, где он нужен методу: `sms-scope` — getTariffs и getNumbersStats, `rent-scope` — методы аренды, `free-scope` — getFreeList. Остальные методы принимают любой действующий токен. Токен, выданный без `scope`, получает `sms-scope`.\n\nAccess token живёт 2 месяца, refresh token — 4 месяца (`expires_in` в ответе с токеном — в секундах).\n\n### **Регистрация вашего приложения на нашем сервисе авторизации**\n\n1. Перейдите на [страницу OAuth](https:\u002F\u002Fonlinesim.io\u002Foauth)\n2. Создайте новый клиент, указав:\n      * `Name` - название приложения или любое другое название, которое Вы и Ваши пользователи будут ассоциировать с приложением;\n      * `Redirect URL` - URL, на который будет перенаправлен клиент после авторизации и куда будет направлен код авторизации приложения;\n      * `Confidential` - необзятально, отметье клиент как *Confidential*, если ваше приложение работает на сервере и может безопасно хранить *Client Secret*.\n\n![Создание клиента](\u002Fdocs\u002FCreateOAuthClient.png)\n\n3. Нажмите \"Create\". Добавленное Вами приложение будет отображаться в списке клиентов.\n\n![Список клиентов](\u002Fdocs\u002FOAuthClient.png)\n\n4. Сохраните `Client ID` и `Secret` в безопасном месте, далее они будут использоваться Вашим приложении для авторизации.\n\n\u003Cspan id=\"AUTHCODE\">\u003C\u002Fspan>\n### OAuth 2.0. Authorization Сode Flow\n\n#### **Авторизация пользователя и получение токена**\n\n1. Авторизуйте клиент через GET запрос к `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize` с параметрами `client_id`, `redirect_uri`, `response_type`, `scope`, `state`:\n\n##### Описание параметров\n\n  Название параметра | Тип данных | Описание\n  -------------------|:----------:|---------\n  client_id | STRING | `Client ID`, который был получен после регистрации приложения\n  redirect_uri | STRING | Адрес на который будет перенаправлен клиент, после успешной авторизации, должен совпадать с `Redirect URL`, который Вы указали при регистрации приложения.\n  response_type | STRING | Указать `code`\n  scope | STRING | Права доступа, разрешение на которые запрашивает Ваше приложение у пользователя. Возможные варианты: `sms-scope`, `rent-scope`, `free-scope`. Можно указать несколько значений\n  state | STRING | Случайная строка для защиты от CSRF (проверьте её после редиректа)\n  code_challenge | STRING | Обязателен для клиента без отметки Confidential (PKCE): BASE64URL(SHA256(`code_verifier`))\n  code_challenge_method | STRING | `S256`\n\n2. После запроса к `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize` пользователь из Вашего приложения будет перенаправлен на страницу авторизации, где ему необходимо указать логин пароль и, в случае успеха, авторизовать Ваше приложение для работы с данными пользователя в сервисе Onlinesim. Для этого ему необходимо будет нажать кнопку *`Authorize`*:\n\n![OAuth запрос](\u002Fdocs\u002FOAuthRequest.png)\n\n::: info\nНа этом этапе Вы можете проверить параметр `state`, для подтверждения безопасного взаимодействия с сервисом авторизации\n:::\n\n3. В случае успешной авторизации пользователь будет перенаправлен по адресу `redirect_uri` с параметром `code`. Теперь Вы можете получить `access token`, для этого необходимо сделать POST запрос к `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken`:\n\n##### Описание параметров\n\n  Название параметра | Тип данных | Описание\n  ---------|:--------:|---------\n  grant_type | STRING | Сценарий авторизации, для сценария Authorization Сode необходимо указать `authorization_code`\n  client_id | STRING | `Client ID`, который был получен после регистрации приложения\n  client_secret | STRING |`Сlient_secret`, который был получен после регистрации приложения\n  redirect_uri | STRING | Адрес на который будет перенаправлен клиент, после успешной авторизации, должен совпадать с `Redirect URL`, который Вы указали при регистрации приложения\n  code | STRING | Код авторизации, который был получен на предыдущем этапе\n  code_verifier | STRING | Случайная строка, из которой сделан `code_challenge` (клиенты без отметки Confidential)\n\n\n::: danger\n  \nТак как `client_secret` -  это приватный ключ, его крайне не рекомендуется хранить на frontend клиента. Для большей безопасности необходимо хранить его в бэкенде Вашего приложения. Для реализации сценария с авторизационным кодом нужно передать полученный frontend'ем код в backend Вашего сервиса, а уже он должен обратится в авторизационный сервис для получения токена.\n:::\n\n4. В результате успешного выполнения запроса к `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken`, в ответ получите JSON, содержащий поля `access_token`, `refresh_token` и `expires_in`. Поле `expires_in` определяет количество секунд до истечения срока действия токена доступа, `refresh_token` используется для обновления токена доступа при истечении его срока действия.\n\n---\n\n#### **Авторизация запросов к API Onlinesim и обновление токена**\n\nВо все запросы к API нужно добавлять заголовок **Authorization: Bearer *`access_token`***.\nЕсли в ответ на ваш запрос пришел `ERROR_WRONG_KEY` (HTTP 456), Вам необходимо обновить токен или получить новый.\n\n  ```json\n  {\n    \"response\": \"ERROR_WRONG_KEY\"\n  }\n  ```\n\nДля обновления токена необходимо сделать POST запрос к `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken` с параметрами `grant_type`, `client_id`, `client_secret` и `refresh_token`. Для поля `refresh_token` необходимо использовать значение, которое было получено в шаге 4.\n\n##### Описание параметров\n\n  Название параметра | Тип данных | Описание\n  ---------|:--------:|---------\n  grant_type | STRING | Необходимо указать `refresh_token`\n  client_id | STRING | `client ID`, который Вы получили при регистрации приложения\n  client_secret | STRING | `client_secret`, который был получен при регистрации приложения\n  refresh_token | STRING | `refresh_token` был получен вместе с `access_token`. Имеет гораздо большее время жизни и используется для обновления `access_token`\n\n\n\u003Cspan id=\"IMPLICIT\">\u003C\u002Fspan>\n### OAuth 2.0. Implicit flow\n\n#### **Авторизация пользователя и получение токена**\n1. Авторизуйте клиент через GET запрос к `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize` с параметрами `client_id`, `redirect_uri`, `response_type`, `scope`, `state`:\n\n##### Описание параметров\n\n  Название параметра | Тип данных | Описание\n  ---------|:--------:|---------\n  client_id | STRING | `Client ID`, который был получен при регистрации приложения\n  redirect_uri | STRING | Адрес на который будет перенаправлен клиент, после успешной авторизации, должен совпадать с `Redirect URL`, который Вы указали при добавлении приложения.\n  response_type | STRING | Используйте `token` в качестве значения\n  scope | STRING | Права доступа, разрешение на которые запрашивает Ваше приложение у пользователя. Возможные варианты: `sms-scope`, `rent-scope`, `free-scope`. Можно указать несколько значений\n  state | STRING | Случайная строка для защиты от CSRF (проверьте её после редиректа)\n\n2. После запроса к `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize`, пользователь из Вашего приложения будет перенаправлен на страницу авторизации, где ему необходимо указать логин пароль и, в случае успеха, авторизовать Ваше приложение для работы с данными пользователя в сервисе Onlinesim. Для этого ему необходимо будет нажать кнопку *`Authorize`*:\n\n![OAuth запрос](\u002Fdocs\u002FOAuthRequest.png)\n\n::: info\nНа этом этапе Вы можете проверить параметр `state`, для подтверждения безопасного взаимодействия с сервисом авторизации\n:::\n\n3. В случае успешной авторизации пользователь будет перенаправлен по адрес `redirect_uri` с параметром `access_token`. Это и есть необходимый токен для авторизации в API Onlinesim.\n\n---\n\n### **Авторизация запросов к API Onlinesim**\n\nВо все запросы к API нужно добавлять заголовок **Authorization: Bearer *`access_token`***.\nЕсли в ответ на ваш запрос пришел `ERROR_WRONG_KEY` (HTTP 456), Вам необходимо получить новый токен: Implicit flow не выдаёт refresh token.\n\n  ```json\n  {\n    \"response\": \"ERROR_WRONG_KEY\"\n  }\n  ```\n","\u003Cspan id=\"OAUTH\">\u003C\u002Fspan>\n### OAuth 2.0\nDas OAuth 2.0-Protokoll unterstützt mehrere Autorisierungsszenarien. Für die Arbeit mit unserer API können Sie die Szenarien Authorization Code Flow oder Implicit Flow verwenden.\n\n::: info\nFür weitere Informationen wenden Sie sich bitte an die [offizielle OAuth 2.0-Dokumentation](https:\u002F\u002Foauth.net\u002F2\u002F).\n:::\n\n**Authorization URL**: `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize`\n\n**Token URL**: `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken`\n\n**Scopes**:\n\n  - `sms-scope` gewährt Zugriff auf die Verwaltung von Nummern für den Dienst \"SMS-Empfang\" von Onlinesim;\n  \n  - `rent-scope` gewährt Zugriff auf die Vermietung virtueller Telefonnummern von Onlinesim;\n  \n  - `free-scope` gewährt Zugriff auf die Verwendung kostenloser Nummern von Onlinesim.\n\nEin Scope wird nur dort geprüft, wo die Methode ihn braucht: `sms-scope` — getTariffs und getNumbersStats, `rent-scope` — die Mietmethoden, `free-scope` — getFreeList. Die übrigen Methoden akzeptieren jedes gültige Token. Ein ohne `scope` ausgestelltes Token erhält `sms-scope`.\n\nEin Access Token gilt 2 Monate, ein Refresh Token 4 Monate (`expires_in` in der Token-Antwort ist in Sekunden).\n\n### **Registrierung Ihrer Anwendung auf unserem Autorisierungsdienst**\n\n1. Gehen Sie zur [OAuth-Seite](https:\u002F\u002Fonlinesim.io\u002Foauth)\n2. Erstellen Sie einen neuen Client und geben Sie an:\n      * `Name` - Name der Anwendung oder ein anderer Name, den Sie und Ihre Benutzer mit der Anwendung assoziieren werden;\n      * `Redirect URL` - URL, an die der Client nach der Autorisierung weitergeleitet wird und wohin der Autorisierungscode der Anwendung gesendet wird;\n      * `Confidential` - optional, markieren Sie den Client als *Confidential*, wenn Ihre Anwendung auf einem Server läuft und den *Client Secret* sicher speichern kann.\n\n![Client erstellen](\u002Fdocs\u002FCreateOAuthClient.png)\n\n3. Klicken Sie auf \"Create\". Ihre hinzugefügte Anwendung wird in der Liste der Clients angezeigt.\n\n![Client-Liste](\u002Fdocs\u002FOAuthClient.png)\n\n4. Speichern Sie `Client ID` und `Secret` an einem sicheren Ort, sie werden von Ihrer Anwendung für die Autorisierung verwendet.\n\n\u003Cspan id=\"AUTHCODE\">\u003C\u002Fspan>\n### OAuth 2.0. Authorization Code Flow\n\n#### **Benutzerautorisierung und Token-Erhaltung**\n\n1. Autorisieren Sie den Client über eine GET-Anfrage an `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize` mit den Parametern `client_id`, `redirect_uri`, `response_type`, `scope`, `state`:\n\n##### Parameterbeschreibung\n\n  Parametername | Datentyp | Beschreibung\n  -------------------|:----------:|---------\n  client_id | STRING | `Client ID`, der nach der Registrierung der Anwendung erhalten wurde\n  redirect_uri | STRING | Adresse, an die der Client nach erfolgreicher Autorisierung weitergeleitet wird, muss mit der `Redirect URL` übereinstimmen, die Sie bei der Registrierung der Anwendung angegeben haben.\n  response_type | STRING | Geben Sie `code` an\n  scope | STRING | Zugriffsrechte, deren Genehmigung Ihre Anwendung vom Benutzer anfordert. Mögliche Optionen: `sms-scope`, `rent-scope`, `free-scope`. Mehrere Werte können angegeben werden\n  state | STRING | Zufällige Zeichenfolge zum Schutz vor CSRF (überprüfen Sie sie nach der Weiterleitung)\n  code_challenge | STRING | Pflicht für einen nicht als Confidential markierten Client (PKCE): BASE64URL(SHA256(`code_verifier`))\n  code_challenge_method | STRING | `S256`\n\n2. Nach der Anfrage an `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize` wird der Benutzer aus Ihrer Anwendung zur Autorisierungsseite weitergeleitet, wo er Benutzername und Passwort eingeben muss und bei Erfolg Ihre Anwendung für die Arbeit mit den Benutzerdaten im Onlinesim-Dienst autorisieren muss. Dazu muss er auf die Schaltfläche *`Authorize`* klicken:\n\n![OAuth-Anfrage](\u002Fdocs\u002FOAuthRequest.png)\n\n::: info\nAuf dieser Stufe können Sie den Parameter `state` überprüfen, um die sichere Interaktion mit dem Autorisierungsdienst zu bestätigen\n:::\n\n3. Bei erfolgreicher Autorisierung wird der Benutzer an die Adresse `redirect_uri` mit dem Parameter `code` weitergeleitet. Jetzt können Sie ein `access token` erhalten, dazu müssen Sie eine POST-Anfrage an `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken` stellen:\n\n##### Parameterbeschreibung\n\n  Parametername | Datentyp | Beschreibung\n  ---------|:--------:|---------\n  grant_type | STRING | Autorisierungsszenario, für das Szenario Authorization Code müssen Sie `authorization_code` angeben\n  client_id | STRING | `Client ID`, der nach der Registrierung der Anwendung erhalten wurde\n  client_secret | STRING |`Client_secret`, der nach der Registrierung der Anwendung erhalten wurde\n  redirect_uri | STRING | Adresse, an die der Client nach erfolgreicher Autorisierung weitergeleitet wird, muss mit der `Redirect URL` übereinstimmen, die Sie bei der Registrierung der Anwendung angegeben haben\n  code | STRING | Autorisierungscode, der in der vorherigen Stufe erhalten wurde\n  code_verifier | STRING | Die Zufallszeichenfolge, aus der `code_challenge` erzeugt wurde (nicht als Confidential markierte Clients)\n\n::: danger\n\nDa `client_secret` ein privater Schlüssel ist, wird nicht empfohlen, ihn im Frontend des Clients zu speichern. Für mehr Sicherheit muss er im Backend Ihrer Anwendung gespeichert werden. Um das Szenario mit dem Autorisierungscode zu implementieren, muss der vom Frontend erhaltene Code an das Backend Ihres Dienstes übergeben werden, und dieses muss sich dann an den Autorisierungsdienst wenden, um das Token zu erhalten.\n:::\n\n4. Als Ergebnis einer erfolgreichen Anfrage an `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken` erhalten Sie eine JSON-Antwort, die die Felder `access_token`, `refresh_token` und `expires_in` enthält. Das Feld `expires_in` bestimmt die Anzahl der Sekunden bis zum Ablauf des Zugriffstokens, `refresh_token` wird verwendet, um das Zugriffstoken bei Ablauf zu aktualisieren.\n\n---\n\n#### **Autorisierung von Anfragen an die Onlinesim API und Token-Aktualisierung**\n\nZu allen Anfragen an die API muss der Header **Authorization: Bearer *`access_token`*** hinzugefügt werden.\nWenn als Antwort auf Ihre Anfrage `ERROR_WRONG_KEY` (HTTP 456) kam, müssen Sie das Token aktualisieren oder ein neues erhalten.\n\n  ```json\n  {\n    \"response\": \"ERROR_WRONG_KEY\"\n  }\n  ```\n\nUm das Token zu aktualisieren, müssen Sie eine POST-Anfrage an `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken` mit den Parametern `grant_type`, `client_id`, `client_secret` und `refresh_token` stellen. Für das Feld `refresh_token` muss der Wert verwendet werden, der in Schritt 4 erhalten wurde.\n\n##### Parameterbeschreibung\n\n  Parametername | Datentyp | Beschreibung\n  ---------|:--------:|---------\n  grant_type | STRING | Sie müssen `refresh_token` angeben\n  client_id | STRING | `client ID`, den Sie bei der Registrierung der Anwendung erhalten haben\n  client_secret | STRING | `client_secret`, der bei der Registrierung der Anwendung erhalten wurde\n  refresh_token | STRING | `refresh_token` wurde zusammen mit `access_token` erhalten. Hat eine viel längere Lebensdauer und wird verwendet, um `access_token` zu aktualisieren\n\n\n\u003Cspan id=\"IMPLICIT\">\u003C\u002Fspan>\n### OAuth 2.0. Implicit Flow\n\n#### **Benutzerautorisierung und Token-Erhaltung**\n1. Autorisieren Sie den Client über eine GET-Anfrage an `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize` mit den Parametern `client_id`, `redirect_uri`, `response_type`, `scope`, `state`:\n\n##### Parameterbeschreibung\n\n  Parametername | Datentyp | Beschreibung\n  ---------|:--------:|---------\n  client_id | STRING | `Client ID`, der bei der Registrierung der Anwendung erhalten wurde\n  redirect_uri | STRING | Adresse, an die der Client nach erfolgreicher Autorisierung weitergeleitet wird, muss mit der `Redirect URL` übereinstimmen, die Sie beim Hinzufügen der Anwendung angegeben haben.\n  response_type | STRING | Verwenden Sie `token` als Wert\n  scope | STRING | Zugriffsrechte, deren Genehmigung Ihre Anwendung vom Benutzer anfordert. Mögliche Optionen: `sms-scope`, `rent-scope`, `free-scope`. Mehrere Werte können angegeben werden\n  state | STRING | Zufällige Zeichenfolge zum Schutz vor CSRF (überprüfen Sie sie nach der Weiterleitung)\n\n2. Nach der Anfrage an `https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize` wird der Benutzer aus Ihrer Anwendung zur Autorisierungsseite weitergeleitet, wo er Benutzername und Passwort eingeben muss und bei Erfolg Ihre Anwendung für die Arbeit mit den Benutzerdaten im Onlinesim-Dienst autorisieren muss. Dazu muss er auf die Schaltfläche *`Authorize`* klicken:\n\n![OAuth-Anfrage](\u002Fdocs\u002FOAuthRequest.png)\n\n::: info\nAuf dieser Stufe können Sie den Parameter `state` überprüfen, um die sichere Interaktion mit dem Autorisierungsdienst zu bestätigen\n:::\n\n3. Bei erfolgreicher Autorisierung wird der Benutzer an die Adresse `redirect_uri` mit dem Parameter `access_token` weitergeleitet. Dies ist das erforderliche Token für die Autorisierung in der Onlinesim API.\n\n---\n\n### **Autorisierung von Anfragen an die Onlinesim API**\n\nZu allen Anfragen an die API muss der Header **Authorization: Bearer *`access_token`*** hinzugefügt werden.\nWenn als Antwort auf Ihre Anfrage `ERROR_WRONG_KEY` (HTTP 456) kam, müssen Sie ein neues Token erhalten: der Implicit Flow liefert kein Refresh Token.\n\n  ```json\n  {\n    \"response\": \"ERROR_WRONG_KEY\"\n  }\n  ```\n",{"implicit":421,"authorizationCode":427},{"authorizationUrl":422,"scopes":423},"https:\u002F\u002Fonlinesim.io\u002Foauth\u002Fauthorize",{"sms-scope":424,"rent-scope":425,"free-scope":426},"grants access to manage numbers for the SMS receiving service from Onlinesim","grants access to renting phone numbers from Onlinesim","grants access to using Onlinesim free numbers",{"authorizationUrl":422,"tokenUrl":428,"refreshUrl":428,"scopes":429},"https:\u002F\u002Fonlinesim.io\u002Foauth\u002Ftoken",{"sms-scope":424,"rent-scope":425,"free-scope":426},{"parameters":431,"responses":437},[432,434],{"name":187,"in":188,"description":189,"x-description-ru":190,"x-description-de":191,"required":55,"schema":433,"example":194},{"type":193,"default":194,"minimum":194},{"name":196,"in":188,"description":197,"x-description-ru":198,"x-description-de":199,"required":55,"schema":435},{"type":201,"enum":436,"example":5},[203,37,36,5,204],{"200":438,"429":506,"456":516},{"description":207,"x-description-ru":208,"x-description-de":209,"content":439},{"application\u002Fjson":440},{"schema":441},{"oneOf":442},[443,502],{"required":444,"properties":445,"type":251},[216,217],{"response":446,"data":448},{"type":201,"enum":447,"example":221},[221],{"allOf":449},[450,471],{"description":225,"x-description-ru":226,"x-description-de":227,"properties":451,"type":251},{"current_page":452,"data":453,"from":455,"to":457,"last_page":459,"per_page":460,"total":461,"first_page_url":462,"last_page_url":463,"next_page_url":464,"prev_page_url":466,"path":468,"links":469},{"type":193,"example":194},{"type":231,"items":454},{},{"type":456},[193,235],{"type":458},[193,235],{"type":193,"example":194},{"type":193,"example":240},{"type":193,"example":194},{"type":201},{"type":201},{"type":465},[201,235],{"type":467},[201,235],{"type":201},{"type":231,"items":470},{"type":251},{"properties":472,"type":251},{"data":473},{"type":231,"items":474},{"required":475,"properties":476,"type":251},[257,258,259,260,261,262],{"id":477,"user_id":478,"webhook_url":479,"type":480,"params":482,"status":496,"error":498,"created_at":500,"updated_at":501},{"type":193},{"type":193},{"type":201},{"type":201,"enum":481},[269,270],{"description":272,"x-description-ru":273,"x-description-de":274,"required":483,"properties":484,"type":251},[276,277,258,278,279,280,281,282,283,284],{"webhook_type":485,"operation_id":487,"user_id":488,"country_code":489,"number":490,"sender":491,"message":492,"code":493,"time_start":494,"time_left":495},{"description":287,"x-description-ru":288,"x-description-de":289,"type":201,"enum":486},[269,270],{"description":292,"x-description-ru":293,"x-description-de":294,"type":193,"example":295},{"description":297,"x-description-ru":298,"x-description-de":299,"type":193,"example":300},{"description":302,"x-description-ru":303,"x-description-de":304,"type":193,"example":305},{"description":307,"x-description-ru":308,"x-description-de":309,"type":201,"example":310},{"description":312,"x-description-ru":313,"x-description-de":314,"type":201,"example":315},{"description":317,"x-description-ru":318,"x-description-de":319,"type":201,"example":320},{"description":322,"x-description-ru":323,"x-description-de":324,"type":201,"example":325},{"description":327,"x-description-ru":328,"x-description-de":329,"type":201,"example":330},{"description":332,"x-description-ru":333,"x-description-de":334,"type":193,"example":335},{"description":337,"x-description-ru":338,"x-description-de":339,"type":201,"enum":497},[341,342,343],{"description":345,"x-description-ru":346,"x-description-de":347,"type":499},[201,235],{"type":201,"example":350},{"type":201,"example":352},{"required":503,"properties":504,"type":251,"additionalProperties":360},[216],{"response":505},{"description":357,"x-description-ru":358,"x-description-de":359,"type":201},{"description":362,"x-description-ru":363,"x-description-de":364,"content":507},{"application\u002Fjson":508},{"schema":509,"examples":513},{"required":510,"properties":511,"type":251,"additionalProperties":360},[216],{"response":512},{"description":357,"x-description-ru":358,"x-description-de":359,"type":201},{"Rate limit":514},{"summary":373,"x-summary-ru":374,"x-summary-de":375,"value":515},{"response":377},{"description":379,"x-description-ru":380,"x-description-de":381,"content":517},{"application\u002Fjson":518},{"schema":519,"examples":523},{"required":520,"properties":521,"type":251,"additionalProperties":360},[216],{"response":522},{"description":357,"x-description-ru":358,"x-description-de":359,"type":201},{"Invalid key":524},{"summary":390,"x-summary-ru":391,"x-summary-de":392,"value":525},{"response":394},{"operationKey":175,"method":176,"urlPath":82,"isWebhook":55,"isInboundWebhook":55,"servers":527,"availableAuthMethods":531,"apiKeyAuth":532,"oauthConfigs":533,"prepared":545,"locale":37,"specName":8,"path":81},[528],{"url":529,"description":530},"https:\u002F\u002Fonlinesim.io","Onlinesim server",[408,414,416],{"in":188,"name":408},[534,540],{"schemeName":535,"flowType":536,"flow":537,"authorizationUrl":422,"tokenUrl":428,"refreshUrl":428,"scopes":539},"OAuth2","authorizationCode",{"authorizationUrl":422,"tokenUrl":428,"refreshUrl":428,"scopes":538},{"sms-scope":424,"rent-scope":425,"free-scope":426},{"sms-scope":424,"rent-scope":425,"free-scope":426},{"schemeName":535,"flowType":541,"flow":542,"authorizationUrl":422,"scopes":544},"implicit",{"authorizationUrl":422,"scopes":543},{"sms-scope":424,"rent-scope":425,"free-scope":426},{"sms-scope":424,"rent-scope":425,"free-scope":426},{"codeParams":546},{"method":176,"url":82,"baseUrl":529,"contentType":547,"params":548},"application\u002Fjson",[549,550],{"in":188,"name":187,"value":194,"type":193,"required":55},{"in":188,"name":196,"value":5,"type":201,"required":55},1795170434721]