====================================================
Http Util
====================================================

**Create Util**

.. code-block:: lua

  http_util = util('http')

.. contents:: 目次
   :local:
   :depth: 2

Method
====================================================


----------------------------------------------------
get
----------------------------------------------------

.. code-block:: lua

  response = http_util:get(request)
  if response.isError then
    -- エラー処理 --
    print(response.statusCode)
    print(response.errorMessage)
  else
    -- 正常処理 --
    print(response.result)
  end


HTTP/HTTPS の GET リクエストを発行します。
2xx応答を成功とみなします。


Request
----------------------------------------------------

.. code-block:: lua

  {
    url=string,
    queryStrings=table,
    headers=table,
  }

* url
 - [string] GETリクエストを発行するURL

* queryStrings
 - [table] リクエストに付加するクエリストリング。URLエンコードは内部的に実行されるため、気にする必要はありません。

* headers
 - [string] リクエストに付加するリクエストヘッダ

Response
----------------------------------------------------

[string] レスポンスボディ


----------------------------------------------------
post
----------------------------------------------------

.. code-block:: lua

  response = http_util:post(request)
  if response.isError then
    -- エラー処理 --
    print(response.statusCode)
    print(response.errorMessage)
  else
    -- 正常処理 --
    print(response.result)
  end


HTTP/HTTPS の POST リクエストを発行します。
2xx応答を成功とみなします。


Request
----------------------------------------------------

.. code-block:: lua

  {
    url=string,
    body=string,
    json=table,
    headers=table,
  }

* url
 - [string] POSTリクエストを発行するURL

* body
 - [string] POSTボディ

* json
 - [table] POSTボディにJSONフォーマットのテキストを指定する場合にtableを指定できます。bodyを指定した場合はbodyが優先されます。

* headers
 - [string] リクエストに付加するリクエストヘッダ

Response
----------------------------------------------------

[string] レスポンスボディ

----------------------------------------------------
put
----------------------------------------------------

.. code-block:: lua

  response = http_util:put(request)
  if response.isError then
    -- エラー処理 --
    print(response.statusCode)
    print(response.errorMessage)
  else
    -- 正常処理 --
    print(response.result)
  end


HTTP/HTTPS の PUT リクエストを発行します。
2xx応答を成功とみなします。


Request
----------------------------------------------------

.. code-block:: lua

  {
    url=string,
    body=string,
    json=table,
    headers=table,
  }

* url
 - [string] PUTリクエストを発行するURL

* body
 - [string] PUTボディ

* json
 - [table] PUTボディにJSONフォーマットのテキストを指定する場合にtableを指定できます。bodyを指定した場合はbodyが優先されます。

* headers
 - [string] リクエストに付加するリクエストヘッダ

Response
----------------------------------------------------

[string] レスポンスボディ

----------------------------------------------------
delete
----------------------------------------------------

.. code-block:: lua

  response = http_util:delete(request)
  if response.isError then
    -- エラー処理 --
    print(response.statusCode)
    print(response.errorMessage)
  else
    -- 正常処理 --
    print(response.result)
  end


HTTP/HTTPS の DELETE リクエストを発行します。
2xx応答を成功とみなします。


Request
----------------------------------------------------

.. code-block:: lua

  {
    url=string,
    queryStrings=table,
    headers=table,
  }

* url
 - [string] DELETEリクエストを発行するURL

* queryStrings
 - [table] リクエストに付加するクエリストリング。URLエンコードは内部的に実行されるため、気にする必要はありません。

* headers
 - [string] リクエストに付加するリクエストヘッダ

Response
----------------------------------------------------

[string] レスポンスボディ