HTTP requests
You can use the http namespace of the Runnable API to make HTTP requests from your Runnable code. These methods are currently the only way to access the network from Runnable code. Arbitrary socket and network access is not currently possible.
For Rust, these methods are available under the http module, for example http::get(). For Swift, they are prefixed with Http, for example Suborbital.HttpGet() For TypeScript/AssemblyScript, they are prefixed with http, for example import { httpPost } from '@suborbital/suborbital'
The following namespace methods are available:
Performs an HTTP GET request
pub fn get(url: &str, headers: Option<BTreeMap<&str, &str>>) -> Result<Vec<u8>, RunErr>
function httpGet(url: string, headers: Map<string, string> | null): ArrayBuffer
public func HttpGet(url: String) -> String
Performs an HTTP POST request
pub fn post(url: &str, body: Option<Vec<u8>>, headers: Option<BTreeMap<&str, &str>>) -> Result<Vec<u8>, RunErr>
function httpPost(url: string, body: ArrayBuffer, headers: Map<string, string> | null): ArrayBuffer
public func HttpPost(url: String, body: String) -> String
Performs an HTTP PATCH request
pub fn patch(url: &str, body: Option<Vec<u8>>, headers: Option<BTreeMap<&str, &str>>) -> Result<Vec<u8>, RunErr>
function httpPatch(url: string, body: ArrayBuffer, headers: Map<string, string> | null): ArrayBuffer
public func HttpPatch(url: String, body: String) -> String
Performs an HTTP DELETE request
pub fn delete(url: &str, headers: Option<BTreeMap<&str, &str>>) -> Result<Vec<u8>, RunErr>
function httpDelete(url: string, headers: Map<string, string> | null): ArrayBuffer
public func HttpDelete(url: String) -> String
Swift does not yet support passing headers to a request.