greentic-interfaces 1.1.1

Greentic ABI: WIT contracts, generated bindings, thin mappers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

// SPDX-License-Identifier: MIT

package greentic:http@1.1.0;

interface http-client {
  use greentic:interfaces-types/types@0.1.0.{tenant-ctx};

  /// Canonical host error payload.
  record host-error {
    code: string,
    message: string,
  }

  /// HTTP request issued by a component.
  record request {
    method: string,
    url: string,
    headers: list<tuple<string, string>>,
    body: option<list<u8>>,
  }

  /// HTTP response returned by the host.
  record response {
    status: u16,
    headers: list<tuple<string, string>>,
    body: option<list<u8>>,
  }

  /// Optional request tunables applied by the host.
  record request-options {
    /// Millisecond deadline applied by the host, if supported.
    timeout-ms: option<u32>,
    /// Whether TLS validation errors may be ignored.
    allow-insecure: option<bool>,
    /// Whether redirects should be followed automatically.
    follow-redirects: option<bool>,
  }

  /// Issues an HTTP request using the host's networking stack.
  send: func(
    req: request,
    opts: option<request-options>,
    ctx: option<tenant-ctx>
  ) -> result<response, host-error>;
}

world client {
  import http-client;
}