heukkell / unreal-fetch

The Fetch API inspired HTTP client for Unreal Engine. Supports both Blueprints & C++.

Unreal Fetch

The Fetch API inspired HTTP Client for Unreal Engine. Works with both Blueprints & C++.

Watch the Demo

Features

With this plugin, you can talk to HTTP APIs very quickly from Blueprints. Here are some core features:

• No C++ or configurations needs when using with Blueprints
• Talk to HTTP Apis with a minimal amount of Blueprint nodes
• Allow to parse & make JSON values via Blueprints
• Works anywhere since this uses internal HTTP & JSON related modules.

Installation

🛍 Get the Plugin via the Unreal Marketplace.

For non-commercial projects, you can also get it from GitHub. Follow these instructions to install:

• Close your existing Unreal Engine app.
• Create a directory in your app root called Plugins.
• Download this GitHub repository.
• Copy UnrealFetchDevApp/Plugins/Fetch of the repository to above created Plugins directory.
• Start your app & it will ask to compile the plugin. Proceed with that.
• You might need to setup Visual Studio for Unreal Engine.

Usage with Blueprints

Watch this video for step by step instructions on how to use this plugin.

Once installed, you can use the Fetch static function inside Blueprints to talk to any HTTP API. Here's an example on invoking a HTTP POST request & extracting the email from the response JSON.

Refer to the following examples for more usage:
^{(You can copy blueprint nodes from the following examples & directly paste them inside your blueprints.)}

For Fetch

• Hello World - Making a POST Request
• Check Response Headers
• Check Status Code
• Handle Errors
• Use Custom Headers
• Using BasicAuth

For JSON

• Basic JSON Usage
• Working with Arrays
• Check for there's a key or not
• Runtime JSON Validation
• Get an item inside an Array
• Loop through a JSON Array
• Find a specific item in a JSON Array

Functional Test Suite

All the tests for this plugin written as Functional Tests & they are based on Blueprints. That's a good place to search for each & every functionality of this plugin.

Here's how to access & run them:

• Clone this repository & run the app UnrealFetchDevApp
• Check Content/Tests from the content browser for various blueprints with test cases.
• Open the test runner with Windows -> Test Automation.
• Open the Automation tab & search for Functional Tests.
• Select all those tests & run them all.

Bugs, Questions & Features

No software is free of bugs or comes with all of the features you would imagine. So, let's talk.