[{"data":1,"prerenderedAt":1721},["ShallowReactive",2],{"navigation_docs":3,"-guide-http-requests":172,"-guide-http-requests-surround":1716},[4,30,100,134],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":29},"Getting started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,14,18,21,25],{"title":11,"path":12,"stem":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":15,"path":16,"stem":17},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation",{"title":5,"path":19,"stem":20},"\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start",{"title":22,"path":23,"stem":24},"Build from source","\u002Fgetting-started\u002Fbuild-from-source","1.getting-started\u002F4.build-from-source",{"title":26,"path":27,"stem":28},"Troubleshooting","\u002Fgetting-started\u002Ftroubleshooting","1.getting-started\u002F5.troubleshooting",false,{"title":31,"icon":32,"path":33,"stem":34,"children":35,"page":29},"Guide","i-lucide-book-open","\u002Fguide","2.guide",[36,40,44,48,52,56,60,64,68,72,76,80,84,88,92,96],{"title":37,"path":38,"stem":39},"Interface","\u002Fguide\u002Finterface","2.guide\u002F01.interface",{"title":41,"path":42,"stem":43},"Workspace","\u002Fguide\u002Fworkspace","2.guide\u002F02.workspace",{"title":45,"path":46,"stem":47},"Collections","\u002Fguide\u002Fcollections","2.guide\u002F03.collections",{"title":49,"path":50,"stem":51},"HTTP requests","\u002Fguide\u002Fhttp-requests","2.guide\u002F04.http-requests",{"title":53,"path":54,"stem":55},"Variables","\u002Fguide\u002Fvariables","2.guide\u002F05.variables",{"title":57,"path":58,"stem":59},"Authorization","\u002Fguide\u002Fauthorization","2.guide\u002F06.authorization",{"title":61,"path":62,"stem":63},"Scripts and tests","\u002Fguide\u002Fscripts-and-tests","2.guide\u002F07.scripts-and-tests",{"title":65,"path":66,"stem":67},"Collection runner","\u002Fguide\u002Fcollection-runner","2.guide\u002F08.collection-runner",{"title":69,"path":70,"stem":71},"Import and export","\u002Fguide\u002Fimport-export","2.guide\u002F09.import-export",{"title":73,"path":74,"stem":75},"Code snippets","\u002Fguide\u002Fcode-snippets","2.guide\u002F10.code-snippets",{"title":77,"path":78,"stem":79},"gRPC","\u002Fguide\u002Fgrpc","2.guide\u002F11.grpc",{"title":81,"path":82,"stem":83},"WebSocket","\u002Fguide\u002Fwebsocket","2.guide\u002F12.websocket",{"title":85,"path":86,"stem":87},"Cookies, proxy and certificates","\u002Fguide\u002Fcookies-proxy-certificates","2.guide\u002F13.cookies-proxy-certificates",{"title":89,"path":90,"stem":91},"Settings","\u002Fguide\u002Fsettings","2.guide\u002F14.settings",{"title":93,"path":94,"stem":95},"Keyboard shortcuts","\u002Fguide\u002Fkeyboard-shortcuts","2.guide\u002F15.keyboard-shortcuts",{"title":97,"path":98,"stem":99},"Privacy and security","\u002Fguide\u002Fprivacy-and-security","2.guide\u002F16.privacy-and-security",{"title":101,"icon":102,"path":103,"stem":104,"children":105,"page":29},"Reference","i-lucide-square-terminal","\u002Freference","3.reference",[106,110,114,118,122,126,130],{"title":107,"path":108,"stem":109},"Command line","\u002Freference\u002Fcli","3.reference\u002F1.cli",{"title":111,"path":112,"stem":113},"Automation tools","\u002Freference\u002Fautomation-tools","3.reference\u002F2.automation-tools",{"title":115,"path":116,"stem":117},"Scripting API","\u002Freference\u002Fscripting-api","3.reference\u002F3.scripting-api",{"title":119,"path":120,"stem":121},"Dynamic variables","\u002Freference\u002Fdynamic-variables","3.reference\u002F4.dynamic-variables",{"title":123,"path":124,"stem":125},"UI control channel","\u002Freference\u002Fui-control-channel","3.reference\u002F5.ui-control-channel",{"title":127,"path":128,"stem":129},"Workspace format","\u002Freference\u002Fworkspace-format","3.reference\u002F6.workspace-format",{"title":131,"path":132,"stem":133},"Feature status","\u002Freference\u002Ffeature-status","3.reference\u002F7.feature-status",{"title":135,"icon":136,"path":137,"stem":138,"children":139,"page":29},"Contributing","i-lucide-git-pull-request","\u002Fcontributing","4.contributing",[140,144,148,152,156,160,164,168],{"title":141,"path":142,"stem":143},"Contributing overview","\u002Fcontributing\u002Foverview","4.contributing\u002F1.overview",{"title":145,"path":146,"stem":147},"Development","\u002Fcontributing\u002Fdevelopment","4.contributing\u002F2.development",{"title":149,"path":150,"stem":151},"Architecture","\u002Fcontributing\u002Farchitecture","4.contributing\u002F3.architecture",{"title":153,"path":154,"stem":155},"Known gaps","\u002Fcontributing\u002Fgaps","4.contributing\u002F4.gaps",{"title":157,"path":158,"stem":159},"Adding a feature","\u002Fcontributing\u002Fadding-a-feature","4.contributing\u002F5.adding-a-feature",{"title":161,"path":162,"stem":163},"Assets and clean-room","\u002Fcontributing\u002Fassets-and-clean-room","4.contributing\u002F6.assets-and-clean-room",{"title":165,"path":166,"stem":167},"Releasing","\u002Fcontributing\u002Freleasing","4.contributing\u002F7.releasing",{"title":169,"path":170,"stem":171},"Writing the documentation","\u002Fcontributing\u002Fdocumentation","4.contributing\u002F8.documentation",{"id":173,"title":49,"body":174,"description":1709,"extension":1710,"links":1711,"meta":1712,"navigation":1713,"path":50,"seo":1714,"stem":51,"__hash__":1715},"docs\u002F2.guide\u002F04.http-requests.md",{"type":175,"value":176,"toc":1691},"minimark",[177,181,184,213,228,233,240,343,348,352,356,362,385,395,398,426,436,446,449,454,483,488,491,494,626,633,638,641,651,761,764,834,840,850,855,882,899,904,907,926,937,941,946,1125,1130,1134,1140,1231,1236,1240,1243,1359,1366,1370,1387,1390,1401,1520,1523,1526,1542,1547,1551,1557,1608,1614],[178,179,180],"p",{},"An HTTP request is a method, a URL, optional query parameters, path variables, headers and a body. It also has authorization, scripts, tests and per-request settings.",[178,182,183],{},"This page covers the builder tab, what Postguy sends, and how the response is shown and recorded.",[178,185,186,187,191,192,191,194,191,197,191,200,191,203,191,206,208,209,212],{},"Request tabs: ",[188,189,190],"code",{},"Params",", ",[188,193,57],{},[188,195,196],{},"Headers",[188,198,199],{},"Body",[188,201,202],{},"Scripts",[188,204,205],{},"Tests",[188,207,89],{}," and ",[188,210,211],{},"Docs",".",[214,215,216,223],"ul",{},[217,218,219,220],"li",{},"Authorization: ",[221,222,57],"a",{"href":58},[217,224,225,226],{},"Scripts and tests: ",[221,227,61],{"href":62},[229,230,232],"h2",{"id":231},"send-a-request","Send a request",[178,234,235,236,239],{},"The top row has the method menu, the URL field and the ",[188,237,238],{},"Send"," button.",[214,241,242,271,297,310,324,334],{},[217,243,244,248,249,191,252,191,255,191,258,191,261,191,264,191,267,270],{},[245,246,247],"strong",{},"Methods:"," ",[188,250,251],{},"GET",[188,253,254],{},"POST",[188,256,257],{},"PUT",[188,259,260],{},"PATCH",[188,262,263],{},"DELETE",[188,265,266],{},"HEAD",[188,268,269],{},"OPTIONS",". Any other method is rejected when the request is built.",[217,272,273,276,277,279,280,283,284,287,288,291,292,296],{},[245,274,275],{},"Send:"," click ",[188,278,238],{},", press ",[188,281,282],{},"Enter"," in the URL field, or press ",[188,285,286],{},"Cmd\u002FCtrl+Enter",". The split button's menu has ",[188,289,290],{},"Send and Download",". It also saves the body when the response arrives (see ",[221,293,295],{"href":294},"#save-a-response","Save a response",").",[217,298,299,302,303,305,306,309],{},[245,300,301],{},"Cancel:"," while a request runs, ",[188,304,238],{}," becomes ",[188,307,308],{},"Cancel"," and a progress line runs over the URL bar. A cancel reports the phase it stopped in.",[217,311,312,315,316,319,320,323],{},[245,313,314],{},"Save:"," press ",[188,317,318],{},"Cmd\u002FCtrl+S",", or click ",[188,321,322],{},"Save",". A dot beside it marks unsaved changes. Sending uses the current draft, so you do not have to save first.",[217,325,326,329,330,333],{},[245,327,328],{},"cURL paste:"," paste a command that starts with ",[188,331,332],{},"curl "," into the URL field to import it into the request.",[217,335,336,339,340,212],{},[245,337,338],{},"No scheme:"," a URL without a scheme is sent as ",[188,341,342],{},"http:\u002F\u002F\u003Curl>",[178,344,345,346,212],{},"Sending uses the active environment from the selector at the end of the tab strip. See ",[221,347,53],{"href":54},[349,350,351],"note",{},"Not available yet: examples (saved responses under a request), a JSONPath\u002FXPath response filter and a visible resolved-URL preview.",[229,353,355],{"id":354},"url-query-params-and-path-variables","URL, query params and path variables",[178,357,358,359,361],{},"The URL and the ",[188,360,190],{}," tab stay in sync:",[214,363,364,371,374],{},[217,365,366,367,370],{},"Type ",[188,368,369],{},"?a=1"," in the URL to add a row.",[217,372,373],{},"Edit a row to update the URL.",[217,375,376,377,380,381,384],{},"The ",[188,378,379],{},"Path Variables"," table lists every ",[188,382,383],{},":name"," segment in the URL path.",[386,387,393],"pre",{"className":388,"code":390,"language":391,"meta":392},[389],"language-text","{{baseUrl}}\u002Fusers\u002F:userId\u002Forders?status=open\n","text","",[188,394,390],{"__ignoreMap":392},[178,396,397],{},"When you send the request, Postguy does this:",[399,400,401,408,420,423],"ol",{},[217,402,403,404,407],{},"Resolves ",[188,405,406],{},"{{variables}}"," in the URL. An unresolved variable in the host is an error. Elsewhere it stays literal.",[217,409,410,411,413,414,416,417,419],{},"Replaces ",[188,412,383],{}," segments with the value in the ",[188,415,379],{}," table. A row with an empty value leaves ",[188,418,383],{}," in place.",[217,421,422],{},"Merges enabled query rows into the URL. A row replaces a pair with the same key. Pairs that exist only in the URL are kept. Disabled rows are not sent.",[217,424,425],{},"Converts the host to ASCII (IDNA). Values of enabled query rows and path variables are percent-encoded.",[178,427,428,429,432,433,435],{},"Turn off ",[188,430,431],{},"Encode URL automatically"," in the request ",[188,434,89],{}," tab to skip percent-encoding of query and path values.",[178,437,438,441,442,445],{},[188,439,440],{},"Bulk Edit"," turns the table into ",[188,443,444],{},"key: value"," lines.",[229,447,196],{"id":448},"headers",[178,450,376,451,453],{},[188,452,196],{}," tab has:",[214,455,456,459,463],{},[217,457,458],{},"Editable rows. Disabled rows are not sent.",[217,460,461,212],{},[188,462,440],{},[217,464,465,466,469,470,191,473,191,476,208,479,482],{},"A ",[188,467,468],{},"Presets"," menu with four built-in sets: ",[188,471,472],{},"JSON",[188,474,475],{},"XML",[188,477,478],{},"Form URL Encoded",[188,480,481],{},"No cache",". Custom presets are not available yet.",[178,484,485,486,212],{},"Header names and values may contain ",[188,487,406],{},[178,489,490],{},"A name with a space, a colon or a control character is refused before sending. So is a value with a line break.",[178,492,493],{},"Rows you add go on the wire first, in table order. Then Postguy adds the automatic headers below. It skips any header whose name you already set (names are compared case-insensitively).",[495,496,497,510],"table",{},[498,499,500],"thead",{},[501,502,503,507],"tr",{},[504,505,506],"th",{},"Header",[504,508,509],{},"Value",[511,512,513,524,536,548,560,572,589,599,609],"tbody",{},[501,514,515,521],{},[516,517,518],"td",{},[188,519,520],{},"Host",[516,522,523],{},"Authority of the final URL",[501,525,526,531],{},[516,527,528],{},[188,529,530],{},"User-Agent",[516,532,533],{},[188,534,535],{},"Postguy\u002F\u003Cversion>",[501,537,538,543],{},[516,539,540],{},[188,541,542],{},"Accept",[516,544,545],{},[188,546,547],{},"*\u002F*",[501,549,550,555],{},[516,551,552],{},[188,553,554],{},"Accept-Encoding",[516,556,557],{},[188,558,559],{},"gzip, deflate, br",[501,561,562,567],{},[516,563,564],{},[188,565,566],{},"Connection",[516,568,569],{},[188,570,571],{},"keep-alive",[501,573,574,579],{},[516,575,576],{},[188,577,578],{},"Cache-Control",[516,580,581,584,585,588],{},[188,582,583],{},"no-cache",", only while Settings › General › ",[188,586,587],{},"Send no-cache header"," is on",[501,590,591,596],{},[516,592,593],{},[188,594,595],{},"Content-Type",[516,597,598],{},"From the body mode (see below), only when the body mode sets one",[501,600,601,606],{},[516,602,603],{},[188,604,605],{},"Content-Length",[516,607,608],{},"Body size in bytes, only when the body is not empty",[501,610,611,616],{},[516,612,613],{},[188,614,615],{},"Cookie",[516,617,618,619,622,623,625],{},"Added from the ",[221,620,621],{"href":86},"cookie jar",". A ",[188,624,615],{}," row you set is merged in",[178,627,628,629,632],{},"Tick ",[188,630,631],{},"Show auto-generated headers"," in the Headers tab to see the generated rows. They are never saved with the request.",[349,634,635,636,212],{},"Header names go out in lowercase on HTTP\u002F1, because the HTTP library does not keep the case you typed. The Console still lists them as they were built. This is a known gap. See ",[221,637,153],{"href":154},[229,639,199],{"id":640},"body",[178,642,643,644,647,648,650],{},"Pick the mode from the ",[188,645,646],{},"Body type"," menu on the ",[188,649,199],{}," tab. Switching mode keeps the other modes' content until you save. Only the active mode is stored.",[495,652,653,665],{},[498,654,655],{},[501,656,657,660,663],{},[504,658,659],{},"Mode",[504,661,662],{},"What is sent",[504,664,595],{},[511,666,667,680,695,717,730,743],{},[501,668,669,674,677],{},[516,670,671],{},[188,672,673],{},"None",[516,675,676],{},"No body",[516,678,679],{},"none",[501,681,682,687,690],{},[516,683,684],{},[188,685,686],{},"form-data",[516,688,689],{},"Multipart with a generated boundary. Rows are text or file.",[516,691,692],{},[188,693,694],{},"multipart\u002Fform-data; boundary=postguy-boundary-...",[501,696,697,702,712],{},[516,698,699],{},[188,700,701],{},"x-www-form-urlencoded",[516,703,704,707,708,711],{},[188,705,706],{},"key=value"," pairs joined with ",[188,709,710],{},"&",", percent-encoded. Rows with an empty key and value are skipped.",[516,713,714],{},[188,715,716],{},"application\u002Fx-www-form-urlencoded",[501,718,719,724,727],{},[516,720,721],{},[188,722,723],{},"Raw",[516,725,726],{},"The text as typed",[516,728,729],{},"By language (below)",[501,731,732,737,740],{},[516,733,734],{},[188,735,736],{},"Binary",[516,738,739],{},"The bytes of one file",[516,741,742],{},"none (set it yourself in Headers)",[501,744,745,750,756],{},[516,746,747],{},[188,748,749],{},"GraphQL",[516,751,752,753],{},"JSON ",[188,754,755],{},"{\"query\", \"variables\", \"operationName\"}",[516,757,758],{},[188,759,760],{},"application\u002Fjson",[178,762,763],{},"Raw languages set a Content-Type when you have not set one yourself:",[495,765,766,775],{},[498,767,768],{},[501,769,770,773],{},[504,771,772],{},"Language",[504,774,595],{},[511,776,777,789,799,811,823],{},[501,778,779,784],{},[516,780,781],{},[188,782,783],{},"Text",[516,785,786],{},[188,787,788],{},"text\u002Fplain",[501,790,791,795],{},[516,792,793],{},[188,794,472],{},[516,796,797],{},[188,798,760],{},[501,800,801,806],{},[516,802,803],{},[188,804,805],{},"JavaScript",[516,807,808],{},[188,809,810],{},"application\u002Fjavascript",[501,812,813,818],{},[516,814,815],{},[188,816,817],{},"HTML",[516,819,820],{},[188,821,822],{},"text\u002Fhtml",[501,824,825,829],{},[516,826,827],{},[188,828,475],{},[516,830,831],{},[188,832,833],{},"application\u002Fxml",[178,835,836,839],{},[188,837,838],{},"Beautify"," re-indents a JSON raw body.",[178,841,842,845,846,849],{},[245,843,844],{},"form-data rows."," A text row can have its own content type. A file row sends the file's name and ",[188,847,848],{},"application\u002Foctet-stream",", unless the row has a content type.",[178,851,852],{},[245,853,854],{},"GraphQL.",[214,856,857,870,876],{},[217,858,859,861,862,865,866,212],{},[188,860,53],{}," must be a JSON object. Empty or invalid text is sent as ",[188,863,864],{},"{}",", and a warning goes to the ",[221,867,869],{"href":868},"#history-and-console","Console",[217,871,872,875],{},[188,873,874],{},"Operation name"," is sent only when it is not empty.",[217,877,878,881],{},[188,879,880],{},"Refresh schema"," runs an introspection query against the URL and lists the types in the tab.",[178,883,884,248,887,889,890,894,895,898],{},[245,885,886],{},"Variables and shortcodes.",[188,888,406],{}," resolve in every body mode. ",[221,891,893],{"href":892},"\u002Fguide\u002Fvariables#shortcodes","Shortcodes"," such as ",[188,896,897],{},"{{% base64(file('lib\u002Fa.jpg')) %}}"," expand in raw, urlencoded, form-data text and GraphQL bodies.",[900,901,903],"h3",{"id":902},"files-and-the-working-directory","Files and the working directory",[178,905,906],{},"Binary bodies and form-data file rows read a file from disk.",[214,908,909,916,923],{},[217,910,911,912,915],{},"Relative paths resolve against the working directory. It is ",[188,913,914],{},"\u003Cworkspace>\u002Ffiles"," unless you set another in Settings › General.",[217,917,918,919,922],{},"Files outside the working directory are refused, unless ",[188,920,921],{},"Read files outside the working directory"," is on.",[217,924,925],{},"A file is capped at 100 MiB.",[178,927,928,929,932,933,936],{},"A file row or binary path that is exactly ",[188,930,931],{},"{{% file('name') %}}"," reads ",[188,934,935],{},"name"," from the collection's assets instead of the disk. Any other shortcode in a file path is an error.",[229,938,940],{"id":939},"per-request-settings","Per-request settings",[178,942,376,943,945],{},[188,944,89],{}," tab holds the values below. A new request gets the defaults.",[495,947,948,961],{},[498,949,950],{},[501,951,952,955,958],{},[504,953,954],{},"Setting",[504,956,957],{},"Default",[504,959,960],{},"Notes",[511,962,963,987,997,1006,1049,1061,1070,1078,1088,1099,1112],{},[501,964,965,968,973],{},[516,966,967],{},"HTTP version",[516,969,970],{},[188,971,972],{},"Auto",[516,974,975,191,977,191,980,983,984,986],{},[188,976,972],{},[188,978,979],{},"HTTP\u002F1.x",[188,981,982],{},"HTTP\u002F2",". ",[188,985,972],{}," follows the global setting.",[501,988,989,992,995],{},[516,990,991],{},"Enable SSL certificate verification",[516,993,994],{},"on",[516,996],{},[501,998,999,1002,1004],{},[516,1000,1001],{},"Automatically follow redirects",[516,1003,994],{},[516,1005],{},[501,1007,1008,1011,1014],{},[516,1009,1010],{},"Follow original HTTP method",[516,1012,1013],{},"off",[516,1015,1016,1017,208,1020,1023,1024,1026,1027,983,1029,1032,1033,1035,1036,1038,1039,1041,1042,208,1045,1048],{},"Off: ",[188,1018,1019],{},"301",[188,1021,1022],{},"302"," turn a ",[188,1025,254],{}," into a ",[188,1028,251],{},[188,1030,1031],{},"303"," always becomes a ",[188,1034,251],{}," (",[188,1037,266],{}," stays ",[188,1040,266],{},"). ",[188,1043,1044],{},"307",[188,1046,1047],{},"308"," keep the method.",[501,1050,1051,1054,1056],{},[516,1052,1053],{},"Follow Authorization header on cross-host redirects",[516,1055,1013],{},[516,1057,1016,1058,1060],{},[188,1059,57],{}," is dropped when the scheme, host or port changes.",[501,1062,1063,1066,1068],{},[516,1064,1065],{},"Remove referer header on redirect",[516,1067,1013],{},[516,1069],{},[501,1071,1072,1074,1076],{},[516,1073,431],{},[516,1075,994],{},[516,1077],{},[501,1079,1080,1083,1085],{},[516,1081,1082],{},"Disable cookie jar",[516,1084,1013],{},[516,1086,1087],{},"Stops both sending and storing cookies for this request.",[501,1089,1090,1093,1096],{},[516,1091,1092],{},"Maximum redirects",[516,1094,1095],{},"10",[516,1097,1098],{},"0 to 100 in the UI.",[501,1100,1101,1104,1107],{},[516,1102,1103],{},"Request timeout (ms)",[516,1105,1106],{},"0",[516,1108,1109,1111],{},[188,1110,1106],{}," = no timeout. Up to 3,600,000 in the UI.",[501,1113,1114,1117,1120],{},[516,1115,1116],{},"Max response size (MB)",[516,1118,1119],{},"50",[516,1121,1122,1124],{},[188,1123,1106],{}," = unlimited. Up to 1,024 in the UI.",[178,1126,1127,1128,212],{},"Redirect and cookie behaviour is described in ",[221,1129,85],{"href":86},[900,1131,1133],{"id":1132},"how-global-settings-combine","How global settings combine",[178,1135,1136,1137,1139],{},"Global values live in ",[221,1138,89],{"href":90},". For each send, Postguy combines them with the request's values:",[495,1141,1142,1151],{},[498,1143,1144],{},[501,1145,1146,1148],{},[504,1147,509],{},[504,1149,1150],{},"Rule",[511,1152,1153,1165,1173,1185,1199,1210,1219],{},[501,1154,1155,1158],{},[516,1156,1157],{},"SSL verification",[516,1159,1160,1161,1164],{},"On only if it is on globally ",[245,1162,1163],{},"and"," in the request. Off on either side wins.",[501,1166,1167,1170],{},[516,1168,1169],{},"Follow redirects",[516,1171,1172],{},"Followed only if it is on in both.",[501,1174,1175,1178],{},[516,1176,1177],{},"Disable cookies",[516,1179,1180,1181,1184],{},"Disabled if the request ",[245,1182,1183],{},"or"," the global setting disables them.",[501,1186,1187,1190],{},[516,1188,1189],{},"Timeout",[516,1191,1192,1193,1195,1196,212],{},"The request's value if it is not ",[188,1194,1106],{},". Otherwise the global ",[188,1197,1198],{},"Request timeout",[501,1200,1201,1204],{},[516,1202,1203],{},"Max response size",[516,1205,1206,1207,1209],{},"The request's value if it differs from ",[188,1208,1119],{},". Otherwise the global value.",[501,1211,1212,1214],{},[516,1213,967],{},[516,1215,1216,1217,212],{},"The request's value, or the global value when the request says ",[188,1218,972],{},[501,1220,1221,1228],{},[516,1222,1223,1224,191,1226],{},"Other redirect rules, ",[188,1225,431],{},[188,1227,1092],{},[516,1229,1230],{},"Request only.",[349,1232,1233,1235],{},[188,1234,1119],{}," means \"default\". So a request that wants exactly 50 MB while the global limit is different cannot say so.",[229,1237,1239],{"id":1238},"the-send-pipeline","The send pipeline",[178,1241,1242],{},"Every send runs the same twelve steps. This is true from the app, the runner or a tool.",[495,1244,1245,1255],{},[498,1246,1247],{},[501,1248,1249,1252],{},[504,1250,1251],{},"#",[504,1253,1254],{},"Step",[511,1256,1257,1265,1273,1281,1289,1297,1305,1316,1328,1336,1343,1351],{},[501,1258,1259,1262],{},[516,1260,1261],{},"1",[516,1263,1264],{},"Find the request and load the variable scopes: globals, collection, folders, active environment, data row, runtime.",[501,1266,1267,1270],{},[516,1268,1269],{},"2",[516,1271,1272],{},"Run pre-request scripts: collection, then folders outer to inner, then the request. A script can change the request or skip it.",[501,1274,1275,1278],{},[516,1276,1277],{},"3",[516,1279,1280],{},"Resolve inherited authorization and its variables. An expired OAuth 2.0 token with a refresh token is refreshed.",[501,1282,1283,1286],{},[516,1284,1285],{},"4",[516,1287,1288],{},"Build the URL: resolve variables, path variables, query rows, IDNA host, percent-encoding.",[501,1290,1291,1294],{},[516,1292,1293],{},"5",[516,1295,1296],{},"Resolve header rows. Authorization is applied after the body is built, because OAuth 1.0, AWS Signature v4 and Hawk sign the body.",[501,1298,1299,1302],{},[516,1300,1301],{},"6",[516,1303,1304],{},"Build the body and the automatic headers.",[501,1306,1307,1310],{},[516,1308,1309],{},"7",[516,1311,1312,1313,1315],{},"Cookies: the jar's cookies first, then a manual ",[188,1314,615],{}," row.",[501,1317,1318,1321],{},[516,1319,1320],{},"8",[516,1322,1323,1324,1327],{},"Send through the proxy-aware client. Redirects are followed by hand and cookies are captured on every hop. A Digest ",[188,1325,1326],{},"401"," challenge is answered once.",[501,1329,1330,1333],{},[516,1331,1332],{},"9",[516,1334,1335],{},"Save the cookie jar if a cookie was stored.",[501,1337,1338,1340],{},[516,1339,1095],{},[516,1341,1342],{},"Build the response model: status, headers, decoded body, sizes and timings.",[501,1344,1345,1348],{},[516,1346,1347],{},"11",[516,1349,1350],{},"Run post-response scripts and tests. A failing script or test never discards the response.",[501,1352,1353,1356],{},[516,1354,1355],{},"12",[516,1357,1358],{},"Record the History entry, the Console entries and, if enabled, the response body.",[178,1360,1361,1362,1365],{},"If ",[188,1363,1364],{},"Settings › Disable scripts"," is on, steps 2 and 11 are skipped and a warning is written to the Console.",[229,1367,1369],{"id":1368},"response-viewer","Response viewer",[178,1371,1372,1373,191,1375,191,1378,208,1380,1383,1384,212],{},"The response pane has the tabs ",[188,1374,199],{},[188,1376,1377],{},"Cookies",[188,1379,196],{},[188,1381,1382],{},"Test Results",". After a test has run, the last one shows as ",[188,1385,1386],{},"Test Results (passed\u002Ftotal)",[178,1388,1389],{},"The status badge, size and time sit on the right. Hover them to see:",[214,1391,1392,1395,1398],{},[217,1393,1394],{},"The HTTP version and redirect count.",[217,1396,1397],{},"The header and body sizes, and the wire size if the body was compressed.",[217,1399,1400],{},"The connect, wait (TTFB), download and total times.",[495,1402,1403,1412],{},[498,1404,1405],{},[501,1406,1407,1410],{},[504,1408,1409],{},"Feature",[504,1411,960],{},[511,1413,1414,1432,1440,1454,1462,1472,1490,1502,1509],{},[501,1415,1416,1419],{},[516,1417,1418],{},"Body views",[516,1420,1421,191,1424,191,1426,191,1429,212],{},[188,1422,1423],{},"Pretty",[188,1425,723],{},[188,1427,1428],{},"Preview",[188,1430,1431],{},"Hex",[501,1433,1434,1437],{},[516,1435,1436],{},"Syntax colouring",[516,1438,1439],{},"JSON, XML, HTML, JavaScript, YAML, chosen from the response.",[501,1441,1442,1445],{},[516,1443,1444],{},"Large bodies",[516,1446,1447,1448,1450,1451,1453],{},"Above 5 MB, ",[188,1449,1423],{}," is disabled and the body opens in ",[188,1452,723],{}," with a banner.",[501,1455,1456,1459],{},[516,1457,1458],{},"Search",[516,1460,1461],{},"A search box with a match count. Matches are tinted in the body.",[501,1463,1464,1467],{},[516,1465,1466],{},"Wrap",[516,1468,1469,1471],{},[188,1470,1466],{}," toggle.",[501,1473,1474,1477],{},[516,1475,1476],{},"Copy",[516,1478,1479,208,1482,1485,1486,1489],{},[188,1480,1481],{},"Copy body",[188,1483,1484],{},"Copy headers"," in the ",[188,1487,1488],{},"..."," menu.",[501,1491,1492,1495],{},[516,1493,1494],{},"Clear",[516,1496,1497,1485,1500,1489],{},[188,1498,1499],{},"Clear response",[188,1501,1488],{},[501,1503,1504,1506],{},[516,1505,196],{},[516,1507,1508],{},"A two-column table.",[501,1510,1511,1513],{},[516,1512,1377],{},[516,1514,1515,1516,1519],{},"The parsed ",[188,1517,1518],{},"Set-Cookie"," headers of this response.",[349,1521,1522],{},"Not available yet: image preview, a JSONPath\u002FXPath filter, a file picker for saving, examples and per-redirect timings.",[900,1524,295],{"id":1525},"save-a-response",[178,1527,1528,1531,1532,1485,1535,1537,1538,1541],{},[188,1529,1530],{},"Save Response"," (or ",[188,1533,1534],{},"Save body to file",[188,1536,1488],{}," menu) writes the decoded body to ",[188,1539,1540],{},"\u003Cworkspace>\u002Ffiles\u002Fresponse-\u003Ctab id>.bin",". The path shows in the status bar.",[178,1543,1544,1546],{},[188,1545,290],{}," does the same after the send completes.",[229,1548,1550],{"id":1549},"history-and-console","History and Console",[178,1552,1553,1554,212],{},"Each send is recorded, unless it comes from the ",[221,1555,1556],{"href":66},"collection runner",[214,1558,1559,1587],{},[217,1560,1561,1564,1565],{},[245,1562,1563],{},"History."," The sidebar's History section lists sends newest first, with method, URL and time.\n",[214,1566,1567,1570,1573,1576],{},[217,1568,1569],{},"An entry stores the request as sent (secret values masked), the status, duration and size.",[217,1571,1572],{},"The newest 5,000 entries are kept.",[217,1574,1575],{},"Open or delete an entry from its context menu.",[217,1577,1578,1579,1582,1583,1586],{},"Response bodies are stored under ",[188,1580,1581],{},".postguy\u002Fresponses\u002F"," only when ",[188,1584,1585],{},"Save response bodies in history"," is on in Settings › General.",[217,1588,1589,1592,1593,1596,1597],{},[245,1590,1591],{},"Console."," Open it from the bottom bar. It logs each request as ",[188,1594,1595],{},"METHOD URL -> status · ms · bytes",".\n",[214,1598,1599,1602,1605],{},[217,1600,1601],{},"It shows expandable request headers, response headers and body (a body is cut at 1 MiB), the effective proxy, and any warnings.",[217,1603,1604],{},"Secret values are masked.",[217,1606,1607],{},"It keeps up to 5,000 entries for 24 hours.",[178,1609,1610,1611,1613],{},"See ",[221,1612,41],{"href":42}," for where these files live.",[1615,1616,1618,1686],"tip",{"title":1617},"Headless",[214,1619,1620,1633,1647,1659,1674,1680],{},[217,1621,1622,1625,1626,1629,1630,212],{},[188,1623,1624],{},"request_create"," makes a request. ",[188,1627,1628],{},"request_update"," sets its ",[188,1631,1632],{},"definition",[217,1634,1635,1638,1639,1642,1643,1646],{},[188,1636,1637],{},"request_send"," runs the full pipeline above and takes an optional ",[188,1640,1641],{},"environment"," id. ",[188,1644,1645],{},"request_cancel"," stops it.",[217,1648,1649,1650,191,1653,208,1656,212],{},"Read the result with ",[188,1651,1652],{},"response_get",[188,1654,1655],{},"response_render_body",[188,1657,1658],{},"response_save",[217,1660,1661,1662,191,1665,191,1668,208,1671,212],{},"Read the record with ",[188,1663,1664],{},"history_list",[188,1666,1667],{},"history_open",[188,1669,1670],{},"console_get",[188,1672,1673],{},"cookies_list",[217,1675,1676,1679],{},[188,1677,1678],{},"snippet_generate"," produces code for a request.",[217,1681,1682,1685],{},[188,1683,1684],{},"variables_resolve"," previews a template.",[178,1687,1688,1689,212],{},"Tools take ids, not names. See ",[221,1690,111],{"href":112},{"title":392,"searchDepth":1692,"depth":1692,"links":1693},2,[1694,1695,1696,1697,1701,1704,1705,1708],{"id":231,"depth":1692,"text":232},{"id":354,"depth":1692,"text":355},{"id":448,"depth":1692,"text":196},{"id":640,"depth":1692,"text":199,"children":1698},[1699],{"id":902,"depth":1700,"text":903},3,{"id":939,"depth":1692,"text":940,"children":1702},[1703],{"id":1132,"depth":1700,"text":1133},{"id":1238,"depth":1692,"text":1239},{"id":1368,"depth":1692,"text":1369,"children":1706},[1707],{"id":1525,"depth":1700,"text":295},{"id":1549,"depth":1692,"text":1550},"Build and send HTTP requests: URL and params, headers, body, settings, the send pipeline and the response viewer.","md",null,{},true,{"title":49,"description":1709},"7uYyR67QSPaB1pmZ7R8_RmGS4NCc7jJJWKTY8qvPXKM",[1717,1719],{"title":45,"path":46,"stem":47,"description":1718,"children":-1},"Create and organise collections, folders and requests. Use the detail tabs and collection assets.",{"title":53,"path":54,"stem":55,"description":1720,"children":-1},"Use variables in requests. Scopes, precedence, environments, globals, secrets, dynamic variables and body shortcodes.",1793179613009]