api-bones 4.0.0

Opinionated REST API types: errors (RFC 9457), pagination, health checks, and more
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

// SPDX-License-Identifier: MIT
//! Non-axum header parsing — for webhook verifiers and out-of-band tooling.
//!
//! Handlers served by axum routers must consume [`OrganizationContext`] (see
//! `examples/org_context.rs`). This example demonstrates the sanctioned path
//! for callers that have no `AuthLayer` and only need to parse a well-formed
//! `X-Org-Id` header.
//!
//! Run: `cargo run --example header_parser --features http`

use api_bones::{OrgId, OrgIdHeaderError};
use http::HeaderMap;

fn verify_webhook(headers: &HeaderMap) -> Result<OrgId, OrgIdHeaderError> {
    OrgId::try_from_headers(headers)
}

fn main() {
    let mut headers = HeaderMap::new();
    headers.insert(
        "x-org-id",
        "550e8400-e29b-41d4-a716-446655440000".parse().unwrap(),
    );

    match verify_webhook(&headers) {
        Ok(org_id) => println!("parsed org_id: {org_id}"),
        Err(e) => eprintln!("rejected: {e}"),
    }

    // Rejection path: missing header
    let empty = HeaderMap::new();
    match verify_webhook(&empty) {
        Ok(_) => unreachable!(),
        Err(e) => println!("missing-header rejection: {e}"),
    }
}