[{"data":1,"prerenderedAt":831},["ShallowReactive",2],{"navigation":3,"\u002Fwebhooks":43,"\u002Fwebhooks-surround":827},[4,8,13,18,23,28,33,38],{"title":5,"path":6,"stem":7},"Getting started","\u002F","index",{"title":9,"path":10,"stem":11,"order":12},"Numbers","\u002Fnumbers","numbers",1,{"title":14,"path":15,"stem":16,"order":17},"Rent","\u002Frent","rent",2,{"title":19,"path":20,"stem":21,"order":22},"User","\u002Fuser","user",3,{"title":24,"path":25,"stem":26,"order":27},"Free numbers","\u002Ffree","free",4,{"title":29,"path":30,"stem":31,"order":32},"Webhooks","\u002Fwebhooks","webhooks",5,{"title":34,"path":35,"stem":36,"order":37},"Testing","\u002Ftesting","testing",6,{"title":39,"path":40,"stem":41,"order":42},"Changelog","\u002Fchangelog","changelog",7,{"id":44,"title":29,"body":45,"description":821,"extension":822,"meta":823,"navigation":824,"path":30,"seo":825,"stem":31,"__hash__":826},"docs\u002Fwebhooks.md",{"type":46,"value":47,"toc":817},"minimark",[48,80,85,88,126,137,603,607,807,813],[49,50,51,52,60,61,64,65,68,69,72,73,79],"p",{},"Set a URL with ",[53,54,56],"a",{"href":55},"\u002Fuser#setwebhookurl",[57,58,59],"code",{},"client.user().setWebhookUrl",". For each SMS the server POSTs a JSON body to it: ",[57,62,63],{},"webhook_type"," ",[57,66,67],{},"receiving_sms"," for numbers, ",[57,70,71],{},"rent_sms"," for rents. Delivery attempts are listed by ",[53,74,76],{"href":75},"\u002Fuser#webhooklogs",[57,77,78],{},"client.user().webhookLogs",".",[81,82,84],"h2",{"id":83},"parsewebhook","parseWebhook",[49,86,87],{},"Parse an inbound webhook body. A static method: no client needed.",[89,90,95],"pre",{"className":91,"code":92,"language":93,"meta":94,"style":94},"language-java shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","static WebhookPayload parseWebhook(String json)\n","java","",[57,96,97],{"__ignoreMap":94},[98,99,101,105,108,112,116,119,123],"span",{"class":100,"line":12},"line",[98,102,104],{"class":103},"spNyl","static",[98,106,107],{"class":103}," WebhookPayload",[98,109,111],{"class":110},"s2Zo4"," parseWebhook",[98,113,115],{"class":114},"sMK4o","(",[98,117,118],{"class":103},"String",[98,120,122],{"class":121},"sTEyZ"," json",[98,124,125],{"class":114},")\n",[49,127,128,129,132,133,136],{},"Lenient: numeric fields may arrive as strings, missing or malformed fields become ",[57,130,131],{},"null",", unknown fields are dropped. It throws ",[57,134,135],{},"OnlineSimException"," only when the input is not a JSON object.",[89,138,140],{"className":91,"code":139,"language":93,"meta":94,"style":94},"import com.sun.net.httpserver.HttpServer;\nimport java.net.InetSocketAddress;\nimport java.nio.charset.StandardCharsets;\nimport ru.onlinesim.OnlineSim;\nimport ru.onlinesim.WebhookPayload;\n\npublic class WebhookServer {\n  public static void main(String[] args) throws Exception {\n    HttpServer server = HttpServer.create(new InetSocketAddress(8080), 0);\n    server.createContext(\"\u002Fonlinesim-hook\", exchange -> {\n      String body = new String(exchange.getRequestBody().readAllBytes(), StandardCharsets.UTF_8);\n      WebhookPayload hook = OnlineSim.parseWebhook(body);\n      if (\"receiving_sms\".equals(hook.webhookType())) System.out.println(hook.operationId() + \" \" + hook.code());\n      exchange.sendResponseHeaders(200, -1);\n      exchange.close();\n    });\n    server.start();\n  }\n}\n",[57,141,142,174,192,215,234,251,257,272,309,352,385,431,456,534,560,573,579,591,597],{"__ignoreMap":94},[98,143,144,148,151,153,156,158,161,163,166,168,171],{"class":100,"line":12},[98,145,147],{"class":146},"sbssI","import",[98,149,150],{"class":103}," com",[98,152,79],{"class":114},[98,154,155],{"class":103},"sun",[98,157,79],{"class":114},[98,159,160],{"class":103},"net",[98,162,79],{"class":114},[98,164,165],{"class":103},"httpserver",[98,167,79],{"class":114},[98,169,170],{"class":103},"HttpServer",[98,172,173],{"class":114},";\n",[98,175,176,178,181,183,185,187,190],{"class":100,"line":17},[98,177,147],{"class":146},[98,179,180],{"class":103}," java",[98,182,79],{"class":114},[98,184,160],{"class":103},[98,186,79],{"class":114},[98,188,189],{"class":103},"InetSocketAddress",[98,191,173],{"class":114},[98,193,194,196,198,200,203,205,208,210,213],{"class":100,"line":22},[98,195,147],{"class":146},[98,197,180],{"class":103},[98,199,79],{"class":114},[98,201,202],{"class":103},"nio",[98,204,79],{"class":114},[98,206,207],{"class":103},"charset",[98,209,79],{"class":114},[98,211,212],{"class":103},"StandardCharsets",[98,214,173],{"class":114},[98,216,217,219,222,224,227,229,232],{"class":100,"line":27},[98,218,147],{"class":146},[98,220,221],{"class":103}," ru",[98,223,79],{"class":114},[98,225,226],{"class":103},"onlinesim",[98,228,79],{"class":114},[98,230,231],{"class":103},"OnlineSim",[98,233,173],{"class":114},[98,235,236,238,240,242,244,246,249],{"class":100,"line":32},[98,237,147],{"class":146},[98,239,221],{"class":103},[98,241,79],{"class":114},[98,243,226],{"class":103},[98,245,79],{"class":114},[98,247,248],{"class":103},"WebhookPayload",[98,250,173],{"class":114},[98,252,253],{"class":100,"line":37},[98,254,256],{"emptyLinePlaceholder":255},true,"\n",[98,258,259,262,265,269],{"class":100,"line":42},[98,260,261],{"class":103},"public",[98,263,264],{"class":103}," class",[98,266,268],{"class":267},"sBMFI"," WebhookServer",[98,270,271],{"class":114}," {\n",[98,273,275,278,281,284,287,289,291,294,298,301,304,307],{"class":100,"line":274},8,[98,276,277],{"class":103},"  public",[98,279,280],{"class":103}," static",[98,282,283],{"class":103}," void",[98,285,286],{"class":110}," main",[98,288,115],{"class":114},[98,290,118],{"class":103},[98,292,293],{"class":114},"[]",[98,295,297],{"class":296},"sHdIc"," args",[98,299,300],{"class":114},")",[98,302,303],{"class":103}," throws",[98,305,306],{"class":103}," Exception",[98,308,271],{"class":114},[98,310,312,315,318,321,324,326,329,331,335,338,340,343,346,349],{"class":100,"line":311},9,[98,313,314],{"class":103},"    HttpServer",[98,316,317],{"class":121}," server ",[98,319,320],{"class":114},"=",[98,322,323],{"class":121}," HttpServer",[98,325,79],{"class":114},[98,327,328],{"class":110},"create",[98,330,115],{"class":114},[98,332,334],{"class":333},"s7zQu","new",[98,336,337],{"class":110}," InetSocketAddress",[98,339,115],{"class":114},[98,341,342],{"class":146},"8080",[98,344,345],{"class":114},"),",[98,347,348],{"class":146}," 0",[98,350,351],{"class":114},");\n",[98,353,355,358,360,363,365,368,372,374,377,380,383],{"class":100,"line":354},10,[98,356,357],{"class":121},"    server",[98,359,79],{"class":114},[98,361,362],{"class":110},"createContext",[98,364,115],{"class":114},[98,366,367],{"class":114},"\"",[98,369,371],{"class":370},"sfazB","\u002Fonlinesim-hook",[98,373,367],{"class":114},[98,375,376],{"class":114},",",[98,378,379],{"class":121}," exchange ",[98,381,382],{"class":103},"->",[98,384,271],{"class":114},[98,386,388,391,394,396,399,402,404,407,409,412,415,418,421,424,426,429],{"class":100,"line":387},11,[98,389,390],{"class":103},"      String",[98,392,393],{"class":121}," body ",[98,395,320],{"class":114},[98,397,398],{"class":333}," new",[98,400,401],{"class":110}," String",[98,403,115],{"class":114},[98,405,406],{"class":121},"exchange",[98,408,79],{"class":114},[98,410,411],{"class":110},"getRequestBody",[98,413,414],{"class":114},"().",[98,416,417],{"class":110},"readAllBytes",[98,419,420],{"class":114},"(),",[98,422,423],{"class":121}," StandardCharsets",[98,425,79],{"class":114},[98,427,428],{"class":121},"UTF_8",[98,430,351],{"class":114},[98,432,434,437,440,442,445,447,449,451,454],{"class":100,"line":433},12,[98,435,436],{"class":103},"      WebhookPayload",[98,438,439],{"class":121}," hook ",[98,441,320],{"class":114},[98,443,444],{"class":121}," OnlineSim",[98,446,79],{"class":114},[98,448,84],{"class":110},[98,450,115],{"class":114},[98,452,453],{"class":121},"body",[98,455,351],{"class":114},[98,457,459,462,465,467,469,471,473,476,478,481,483,486,489,492,494,497,499,502,504,506,508,511,514,517,520,522,524,527,529,531],{"class":100,"line":458},13,[98,460,461],{"class":333},"      if",[98,463,464],{"class":114}," (",[98,466,367],{"class":114},[98,468,67],{"class":370},[98,470,367],{"class":114},[98,472,79],{"class":114},[98,474,475],{"class":110},"equals",[98,477,115],{"class":114},[98,479,480],{"class":121},"hook",[98,482,79],{"class":114},[98,484,485],{"class":110},"webhookType",[98,487,488],{"class":114},"()))",[98,490,491],{"class":121}," System",[98,493,79],{"class":114},[98,495,496],{"class":121},"out",[98,498,79],{"class":114},[98,500,501],{"class":110},"println",[98,503,115],{"class":114},[98,505,480],{"class":121},[98,507,79],{"class":114},[98,509,510],{"class":110},"operationId",[98,512,513],{"class":114},"()",[98,515,516],{"class":114}," +",[98,518,519],{"class":114}," \"",[98,521,519],{"class":114},[98,523,516],{"class":114},[98,525,526],{"class":121}," hook",[98,528,79],{"class":114},[98,530,57],{"class":110},[98,532,533],{"class":114},"());\n",[98,535,537,540,542,545,547,550,552,555,558],{"class":100,"line":536},14,[98,538,539],{"class":121},"      exchange",[98,541,79],{"class":114},[98,543,544],{"class":110},"sendResponseHeaders",[98,546,115],{"class":114},[98,548,549],{"class":146},"200",[98,551,376],{"class":114},[98,553,554],{"class":114}," -",[98,556,557],{"class":146},"1",[98,559,351],{"class":114},[98,561,563,565,567,570],{"class":100,"line":562},15,[98,564,539],{"class":121},[98,566,79],{"class":114},[98,568,569],{"class":110},"close",[98,571,572],{"class":114},"();\n",[98,574,576],{"class":100,"line":575},16,[98,577,578],{"class":114},"    });\n",[98,580,582,584,586,589],{"class":100,"line":581},17,[98,583,357],{"class":121},[98,585,79],{"class":114},[98,587,588],{"class":110},"start",[98,590,572],{"class":114},[98,592,594],{"class":100,"line":593},18,[98,595,596],{"class":114},"  }\n",[98,598,600],{"class":100,"line":599},19,[98,601,602],{"class":114},"}\n",[81,604,606],{"id":605},"payload-fields","Payload fields",[608,609,610,626],"table",{},[611,612,613],"thead",{},[614,615,616,620,623],"tr",{},[617,618,619],"th",{},"Accessor",[617,621,622],{},"Type",[617,624,625],{},"Description",[627,628,629,652,670,684,699,731,748,762,776,793],"tbody",{},[614,630,631,637,641],{},[632,633,634],"td",{},[57,635,636],{},"webhookType()",[632,638,639],{},[57,640,118],{},[632,642,643,645,646,648,649,651],{},[57,644,67],{},", ",[57,647,71],{},", or ",[57,650,131],{}," for anything else.",[614,653,654,659,664],{},[632,655,656],{},[57,657,658],{},"operationId()",[632,660,661],{},[57,662,663],{},"Long",[632,665,666,669],{},[57,667,668],{},"tzid"," of the operation or rent.",[614,671,672,677,681],{},[632,673,674],{},[57,675,676],{},"userId()",[632,678,679],{},[57,680,663],{},[632,682,683],{},"Account id.",[614,685,686,691,696],{},[632,687,688],{},[57,689,690],{},"countryCode()",[632,692,693],{},[57,694,695],{},"Integer",[632,697,698],{},"Country code of the number.",[614,700,701,706,710],{},[632,702,703],{},[57,704,705],{},"number()",[632,707,708],{},[57,709,118],{},[632,711,712,713,716,717,720,721,724,725,464,727,730],{},"Numbers: ",[57,714,715],{},"+"," and the full number (",[57,718,719],{},"+79001234567","), or ",[57,722,723],{},"hidden",". Rent: the full number in digits without ",[57,726,715],{},[57,728,729],{},"79001234567",").",[614,732,733,738,742],{},[632,734,735],{},[57,736,737],{},"sender()",[632,739,740],{},[57,741,118],{},[632,743,744,745,79],{},"Sender of the SMS, e.g. ",[57,746,747],{},"VK",[614,749,750,755,759],{},[632,751,752],{},[57,753,754],{},"message()",[632,756,757],{},[57,758,118],{},[632,760,761],{},"Full SMS text.",[614,763,764,769,773],{},[632,765,766],{},[57,767,768],{},"code()",[632,770,771],{},[57,772,118],{},[632,774,775],{},"Code extracted from the SMS.",[614,777,778,783,787],{},[632,779,780],{},[57,781,782],{},"timeStart()",[632,784,785],{},[57,786,118],{},[632,788,789,790,79],{},"Numbers: when the operation was ordered. Rent: when the SMS arrived. ",[57,791,792],{},"YYYY-MM-DD HH:MM:SS",[614,794,795,800,804],{},[632,796,797],{},[57,798,799],{},"timeLeft()",[632,801,802],{},[57,803,663],{},[632,805,806],{},"Time left: seconds for numbers, minutes for rent.",[49,808,809,810,812],{},"Every accessor returns ",[57,811,131],{}," when the field is missing or malformed.",[814,815,816],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}",{"title":94,"searchDepth":17,"depth":17,"links":818},[819,820],{"id":83,"depth":17,"text":84},{"id":605,"depth":17,"text":606},"Receive SMS as HTTP callbacks and parse them with OnlineSim.parseWebhook.","md",{},{"order":32},{"title":29,"description":821},"VMTNJO8k87ywpPJYRDYOjx1l8xmLVW2_1hu3wakNg58",[828,830],{"title":19,"path":20,"stem":21,"description":829,"order":22},"Balance, profile, payments and the webhook URL — client.user().",null,1795164317215]