Crate use_api_request 

use-api-request

API request metadata primitives for RustUse.

Models request IDs, correlation IDs, trace IDs, timestamp labels, sources, contexts, and protocol-neutral request envelopes.

Example

use use_api_request::{RequestContextKind, RequestId};

let value = RequestId::new("req_123").expect("valid API primitive");

assert_eq!(value.as_str(), "req_123");
assert_eq!(RequestContextKind::User.to_string(), "user");

Scope

• Small validated types for API metadata.
• Stable display labels and conservative parsing helpers.
• Dependency-light primitives that can be reused by other RustUse crates.

Non-goals

• No HTTP parsing.
• No clock access.
• No tracing backend integration.

License

Licensed under either of the following, at your option:

• Apache License, Version 2.0
• MIT license

Structs

ApiRequest

Protocol-neutral request envelope.

CorrelationId

PrimitiveMetadata

Lightweight metadata tying this crate’s primary text and label together.

RequestId

RequestSource

RequestTimestampLabel

TraceId

Enums

ApiPrimitiveError

Error returned when API primitive text or labels are invalid.

RequestContextKind

Request context kind labels.