Crate wasmcloud_actor_http_client

HTTP Client wasmCloud Actor Interface

This crate provides wasmCloud actors with an interface to the HTTP client capability provider. Actors using this interface must have the claim wasmcloud:httpclient in order to have permission to make outbound HTTP requests, and they must have an active, configured binding to an HTTP Client capability provider.

wasmCloud actors without this permission and capability binding will be unable to make outbound HTTP requests.

Example:

use wapc_guest::HandlerResult;
extern crate wasmcloud_actor_http_server as httpserver;
extern crate wasmcloud_actor_http_client as httpclient;
extern crate wasmcloud_actor_core as actor;

const API_URL: &str = "https://wasmcloudapi.cloud.io/proxy";

#[actor::init]
pub fn init() {
    httpserver::Handlers::register_handle_request(get_proxy);
}

/// This function proxys an inbound HTTP request to an external server
fn get_proxy(msg: httpserver::Request) -> HandlerResult<httpserver::Response> {
    // Form client request from server request
    if msg.method == "GET".to_string() {
        // Replace `request` with `httpclient::default().request`
        let res = request(msg.method, API_URL.to_string(), msg.header, vec![])?;
        // Form server response
        Ok(httpserver::Response {
            status_code: res.status_code,
            status: res.status,
            header: res.header,
            body: res.body,
        })
    } else {
        Ok(httpserver::Response::internal_server_error("Only GET requests can be proxied with this actor"))
    }
}

Structs

Host

RequestArgs

Response

Response object that is returned from an HTTP request

Constants

OP_REQUEST

Functions

default

Creates the default host binding

deserialize

The standard function for de-serializing codec structs from a format suitable for message exchange between actor and host. Use of any other function to deserialize could result in breaking incompatibilities.

host

Creates a named host binding

serialize

The standard function for serializing codec structs into a format that can be used for message exchange between actor and host. Use of any other function to serialize could result in breaking incompatibilities.