Making HTTP requests

    For the sake of this example, we will create a simple UI with a button, that when pressed will start the HTTP request to the specified URL.

    Warning

    When exporting to Android, make sure to enable the permission in the Android export preset before exporting the project or using one-click deploy. Otherwise, network communication of any kind will be blocked by Android.

    Create a new empty scene, add a CanvasLayer as the root node and add a script to it. Then add two child nodes to it: a Button and an HTTPRequest node. You will need to connect the following signals to the CanvasLayer script:

    • Button.pressed: When the button is pressed, we will start the request.

    Below is all the code we need to make it work. The URL points to an online API mocker; it returns a pre-defined JSON string, which we will then parse to get access to the data.

    GDScript   C#

    1. class HTTPRequestDemo : CanvasLayer
    2. {
    3.     public override void _Ready()
    4.     {
    5.         GetNode("HTTPRequest").Connect("request_completed", this, "OnRequestCompleted");
    6.     }
    8.     public void OnButtonPressed()
    9.     {
    11.         httpRequest.Request("http://www.mocky.io/v2/5185415ba171ea3a00704eed");
    12.     }
    14.     public void OnRequestCompleted(int result, int response_code, string[] headers, byte[] body)
    15.     {
    16.         GD.Print(json.Result);
    17.     }
    18. }

    With this, you should see (hello:world) printed on the console; hello being a key, and world being a value, both of them strings.

    For more information on parsing JSON, see the class references for JSON and .

    Of course, you can also set custom HTTP headers. These are given as a string array, with each string containing a header in the format "header: value". For example, to set a custom user agent (the HTTP user-agent header) you could use the following:

    GDScript   C#

    1. HTTPRequest httpRequest = GetNode<HTTPRequest>("HTTPRequest");
    2. httpRequest.Request("http://www.mocky.io/v2/5185415ba171ea3a00704eed", new string[] { "user-agent: YourCustomUserAgent" });

    Please note that, for SSL/TLS encryption and thus HTTPS URLs to work, you may need to take some steps as described here.

    Also, when calling APIs using authorization, be aware that someone might analyse and decompile your released application and thus may gain access to any embedded authorization information like tokens, usernames or passwords. That means it is usually not a good idea to embed things such as database access credentials inside your game. Avoid providing information useful to an attacker whenever possible.

    Until now, we have limited ourselves to requesting data from a server. But what if you need to send data to the server? Here is a common way of doing it:

    1. public void MakePostRequest(string url, object data_to_send, bool use_ssl)
    2. {
    3.     string query = JSON.Print(data_to_send);
    4.     HTTPRequest httpRequest = GetNode<HTTPRequest>("HTTPRequest");
    5.     string[] headers = new string[] { "Content-Type: application/json" };
    6. }

    Keep in mind that you have to wait for a request to finish before sending another one. Making multiple request at once requires you to have one node per request. A common strategy is to create and delete HTTPRequest nodes at runtime as necessary.