Crate wasmcloud_actor_http_client[−][src]
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. |