{"id":190812,"date":"2026-07-23T12:01:00","date_gmt":"2026-07-23T03:01:00","guid":{"rendered":"https:\/\/support.questetra.com\/?p=190812"},"modified":"2026-07-23T12:26:21","modified_gmt":"2026-07-23T03:26:21","slug":"script-task-http-request","status":"publish","type":"post","link":"https:\/\/support.questetra.com\/ja\/developer-blog\/script-task-http-request\/","title":{"rendered":"\u30b9\u30af\u30ea\u30d7\u30c8\u30bf\u30b9\u30af\u304b\u3089 HTTP \u30ea\u30af\u30a8\u30b9\u30c8\u3092\u9001\u308b"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

\u30b9\u30af\u30ea\u30d7\u30c8\u30bf\u30b9\u30af\u3067\u306f\u3001httpClient<\/code> \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3092\u4f7f\u3063\u3066\u5916\u90e8\u306e Web API \u306b HTTP \u30ea\u30af\u30a8\u30b9\u30c8\u3092\u9001\u308b\u3053\u3068\u304c\u3067\u304d\u307e\u3059\u3002\u3053\u306e\u8a18\u4e8b\u3067\u306f\u3001GET \u30ea\u30af\u30a8\u30b9\u30c8\u3068 POST \u30ea\u30af\u30a8\u30b9\u30c8\u306e\u57fa\u672c\u7684\u306a\u66f8\u304d\u65b9\u3092\u30b5\u30f3\u30d7\u30eb\u30b3\u30fc\u30c9\u3068\u3068\u3082\u306b\u89e3\u8aac\u3057\u307e\u3059\u3002<\/p>\n\n\n\n

\n\n\n\n

GET \u30ea\u30af\u30a8\u30b9\u30c8<\/h2>\n\n\n\n

httpClient.begin()<\/code> \u3067\u30ea\u30af\u30a8\u30b9\u30c8\u3092\u7d44\u307f\u7acb\u3066\u3001.get(url)<\/code> \u3067\u9001\u4fe1\u3057\u307e\u3059\u3002<\/p>\n\n\n\n

const url = "https:\/\/api.example.com\/items";\n\nconst response = httpClient.begin()\n  .get(url);\n\nconst statusCode = response.getStatusCode();\nconst body       = response.getResponseAsString();\n\nengine.log("\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9: " + statusCode);\nengine.log("\u30ec\u30b9\u30dd\u30f3\u30b9: " + body);<\/code><\/pre><\/div>\n\n\n\n
\u30af\u30a8\u30ea\u30d1\u30e9\u30e1\u30fc\u30bf\u3092\u4ed8\u3051\u308b<\/h3>\n\n\n\n
\u30af\u30a8\u30ea\u30d1\u30e9\u30e1\u30fc\u30bf\u306f URL \u6587\u5b57\u5217\u306b\u76f4\u63a5\u4ed8\u52a0\u3059\u308b\u304b\u3001.queryParam()<\/code> \u3067\u6307\u5b9a\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
\/\/ URL \u306b\u76f4\u63a5\u4ed8\u52a0\u3059\u308b\u5834\u5408\nconst url = "https:\/\/api.example.com\/items?category=book&limit=10";\n\n\/\/ queryParam() \u3067\u6307\u5b9a\u3059\u308b\u5834\u5408\nconst response = httpClient.begin()\n  .queryParam("category", "book")\n  .queryParam("limit",    "10")\n  .get("https:\/\/api.example.com\/items");<\/code><\/pre><\/div>\n\n\n\n
JSON \u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u89e3\u6790\u3059\u308b<\/h3>\n\n\n\n
\u30ec\u30b9\u30dd\u30f3\u30b9\u304c JSON \u306e\u5834\u5408\u3001JSON.parse()<\/code> \u3067\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u306b\u5909\u63db\u3067\u304d\u307e\u3059\u3002<\/p>\n\n\n\n
const response = httpClient.begin()\n  .get("https:\/\/api.example.com\/items");\n\nconst json  = JSON.parse(response.getResponseAsString());\nconst items = json.items || [];\n\nengine.log("\u4ef6\u6570: " + items.length);<\/code><\/pre><\/div>\n\n\n\n
\n\n\n\n
POST \u30ea\u30af\u30a8\u30b9\u30c8<\/h2>\n\n\n\n
.body()<\/code> \u3067\u30ea\u30af\u30a8\u30b9\u30c8\u30dc\u30c7\u30a3\u3092\u6307\u5b9a\u3057\u3001.post(url)<\/code> \u3067\u9001\u4fe1\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
const payload = JSON.stringify({\n  name:  "\u65b0\u3057\u3044\u30a2\u30a4\u30c6\u30e0",\n  value: 100\n});\n\nconst response = httpClient.begin()\n  .body(payload, "application\/json")\n  .post("https:\/\/api.example.com\/items");\n\nconst statusCode = response.getStatusCode();\nengine.log("\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9: " + statusCode);<\/code><\/pre><\/div>\n\n\n\n
\u30d5\u30a9\u30fc\u30e0\u5f62\u5f0f\u3067\u9001\u308b\u5834\u5408<\/h3>\n\n\n\n
application\/x-www-form-urlencoded<\/code> \u5f62\u5f0f\u3067\u9001\u308b\u5834\u5408\u306f\u3001.formParam()<\/code> \u3092\u4f7f\u3044\u307e\u3059\u3002<\/p>\n\n\n\n
const response = httpClient.begin()\n  .formParam("name",  "\u65b0\u3057\u3044\u30a2\u30a4\u30c6\u30e0")\n  .formParam("value", "100")\n  .post("https:\/\/api.example.com\/items");<\/code><\/pre><\/div>\n\n\n\n
\n\n\n\n
\u8a8d\u8a3c\u304c\u5fc5\u8981\u306a\u5834\u5408<\/h2>\n\n\n\n
OAuth \u306a\u3069\u306e\u8a8d\u8a3c\u304c\u5fc5\u8981\u306a API \u3092\u547c\u3073\u51fa\u3059\u5834\u5408\u306f\u3001\u307e\u305a httpClient.findAuthSetting()<\/code> \u3067 HTTP \u8a8d\u8a3c\u8a2d\u5b9a\u3092\u53d6\u5f97\u3057\u3001\u305d\u308c\u3092 .authSetting()<\/code> \u306b\u6e21\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
\/\/ \u7b2c 2 \u5f15\u6570\u306f\u5168\u30a2\u30d7\u30ea\u5171\u6709\u8a2d\u5b9a\u306e\u5834\u5408 true\u3001\u30a2\u30d7\u30ea\u500b\u5225\u8a2d\u5b9a\u306e\u5834\u5408 false\nconst setting = httpClient.findAuthSetting("\u8a2d\u5b9a\u540d", false);\n\nconst response = httpClient.begin()\n  .authSetting(setting)\n  .get("https:\/\/api.example.com\/items");<\/code><\/pre><\/div>\n\n\n\n
HTTP \u8a8d\u8a3c\u8a2d\u5b9a\u306e\u4f5c\u6210\u65b9\u6cd5\u306b\u3064\u3044\u3066\u306f\u300cHTTP \u8a8d\u8a3c\u8a2d\u5b9a\u306b\u3064\u3044\u3066\u7406\u89e3\u3059\u308b\u300d\u3092\u53c2\u7167\u3057\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n\n\n\n
\n\n\n\n
\u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u78ba\u8a8d\u3068\u30a8\u30e9\u30fc\u51e6\u7406<\/h2>\n\n\n\n
\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9\u3067\u6210\u529f\u30fb\u5931\u6557\u3092\u5224\u5b9a\u3057\u3001\u60f3\u5b9a\u5916\u306e\u5834\u5408\u306f\u4f8b\u5916\u3092\u30b9\u30ed\u30fc\u3059\u308b\u3053\u3068\u304c\u63a8\u5968\u3055\u308c\u307e\u3059\u3002200<\/code>\uff08OK\uff09\u4ee5\u5916\u306b\u3082 201<\/code>\uff08Created\uff09\u30fb204<\/code>\uff08No Content\uff09\u306a\u3069\u306e\u6210\u529f\u30ec\u30b9\u30dd\u30f3\u30b9\u304c\u3042\u308b\u305f\u3081\u3001200 \u756a\u53f0\u304b\u3069\u3046\u304b<\/strong>\u3067\u5224\u5b9a\u3059\u308b\u306e\u304c\u6c4e\u7528\u7684\u3067\u3059\u3002<\/p>\n\n\n\n
const response = httpClient.begin()\n  .get("https:\/\/api.example.com\/items");\n\nconst statusCode = response.getStatusCode();\n\nif (statusCode < 200 || statusCode >= 300) {\n  \/\/ \u5931\u6557\u6642\u306f\u672c\u6587\u3082\u30ed\u30b0\u306b\u6b8b\u3057\u3066\u304a\u304f\u3068\u30c7\u30d0\u30c3\u30b0\u3057\u3084\u3059\u3044\n  engine.log("\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9: " + response.getResponseAsString());\n  throw new Error("API \u30ea\u30af\u30a8\u30b9\u30c8\u304c\u5931\u6557\u3057\u307e\u3057\u305f\u3002\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9: " + statusCode);\n}\n\nconst body = response.getResponseAsString();<\/code><\/pre><\/div>\n\n\n\n
\n
\u6210\u529f\u6642\u306b\u8a31\u5bb9\u3059\u308b\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9\u306f API \u306e\u4ed5\u69d8\u306b\u5408\u308f\u305b\u3066\u8abf\u6574\u3057\u3066\u304f\u3060\u3055\u3044\u3002\u51aa\u7b49\u306a GET \u306a\u3089 200<\/code> \u306e\u307f\u3001\u30ea\u30bd\u30fc\u30b9\u4f5c\u6210\u7cfb\u306e POST \u306a\u3089 201<\/code> \u3082\u542b\u3081\u308b\u3001\u3068\u3044\u3063\u305f\u9078\u3073\u65b9\u3092\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
engine.log()<\/code> \u3092\u6d3b\u7528\u3057\u3066\u30ec\u30b9\u30dd\u30f3\u30b9\u5185\u5bb9\u3092\u30ed\u30b0\u306b\u51fa\u529b\u3057\u3066\u304a\u304f\u3068\u3001\u30c7\u30d0\u30c3\u30b0\u6642\u306b\u539f\u56e0\u3092\u7279\u5b9a\u3057\u3084\u3059\u304f\u306a\u308a\u307e\u3059\u3002\u30ed\u30b0\u306e\u4f7f\u3044\u65b9\u306b\u3064\u3044\u3066\u306f\u300c\u30ed\u30b0\u51fa\u529b\u3092\u4f7f\u7528\u3059\u308b\u300d\u3092\u53c2\u7167\u3057\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n<\/div>\n\n\n\n
\n\n\n\n
\u5b9f\u8df5\u4f8b\uff1a\u5916\u90e8 API \u304b\u3089\u30c7\u30fc\u30bf\u3092\u53d6\u5f97\u3057\u3066\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u66f8\u304d\u8fbc\u3080<\/h2>\n\n\n\n
\u5546\u54c1 ID\uff08\u6587\u5b57\u578b\uff09\u3092\u8aad\u307f\u53d6\u308a\u3001\u5916\u90e8 API \u304b\u3089\u5546\u54c1\u540d\u3068\u4fa1\u683c\u3092\u53d6\u5f97\u3057\u3066\u3001\u305d\u308c\u305e\u308c\u306e\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u66f8\u304d\u8fbc\u3080\u4f8b\u3067\u3059\u3002<\/p>\n\n\n\n
\/\/ \u5546\u54c1 ID \u3092\u53d6\u5f97\nconst productId = engine.findDataByVarName("q_product_id");\nif (productId === null) {\n  throw new Error("\u5546\u54c1 ID \u304c\u5165\u529b\u3055\u308c\u3066\u3044\u307e\u305b\u3093");\n}\n\n\/\/ \u5916\u90e8 API \u3092\u547c\u3073\u51fa\u3059\nconst url      = "https:\/\/api.example.com\/products\/" + encodeURIComponent(productId);\nconst response = httpClient.begin()\n  .get(url);\n\nconst statusCode = response.getStatusCode();\nif (statusCode < 200 || statusCode >= 300) {\n  engine.log("\u30a8\u30e9\u30fc\u30ec\u30b9\u30dd\u30f3\u30b9: " + response.getResponseAsString());\n  throw new Error("\u5546\u54c1\u60c5\u5831\u306e\u53d6\u5f97\u306b\u5931\u6557\u3057\u307e\u3057\u305f\u3002\u30b9\u30c6\u30fc\u30bf\u30b9\u30b3\u30fc\u30c9: " + statusCode);\n}\n\n\/\/ \u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u89e3\u6790\u3057\u3066\u30c7\u30fc\u30bf\u9805\u76ee\u306b\u66f8\u304d\u8fbc\u3080\nconst product = JSON.parse(response.getResponseAsString());\n\nengine.setDataByVarName("q_product_name",  product.name);\nengine.setDataByVarName("q_product_price", new java.math.BigDecimal(String(product.price)));<\/code><\/pre><\/div>\n\n\n\n
\n\n\n\n
\u8a2d\u8a08\u4e0a\u306e\u6ce8\u610f<\/h2>\n\n\n\n
\u30b9\u30af\u30ea\u30d7\u30c8\u30bf\u30b9\u30af\u306e\u5b9f\u884c\u6642\u9593\u306f \u6700\u5927 30 \u79d2<\/strong> \u3067\u3059\u3002\u5916\u90e8 API \u306e\u30ec\u30b9\u30dd\u30f3\u30b9\u304c\u9045\u3044\u5834\u5408\u3084\u3001\u30eb\u30fc\u30d7\u5185\u3067\u8907\u6570\u56de\u30ea\u30af\u30a8\u30b9\u30c8\u3092\u9001\u308b\u5834\u5408\u306f\u3001\u3053\u306e\u5236\u9650\u306b\u6ce8\u610f\u3057\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n\n\n\n
\u307e\u305f\u30011 \u56de\u306e\u5b9f\u884c\u306b\u3064\u304d HTTP \u30ea\u30af\u30a8\u30b9\u30c8\u306f \u6700\u5927 10 \u56de<\/strong> \u307e\u3067\u3068\u3044\u3046\u5236\u9650\u3082\u3042\u308a\u307e\u3059\u3002<\/p>\n\n\n\n
\n\n\n\n
\u95a2\u9023\u30ea\u30d5\u30a1\u30ec\u30f3\u30b9<\/h2>\n\n\n\n