Skip to main content

parse_request

jmap_server

Function parse_request 

Source 
pub fn parse_request(
    body: Value,
    max_calls: usize,
) -> Result<JmapRequest, JmapError>
Expand description

Parse and validate a JMAP request from a raw JSON value.

Validates:

  • The body deserializes as a JmapRequest.
  • using is non-empty (RFC 8620 §3.3).
  • The number of method calls does not exceed max_calls (RFC 8620 §3.3).

Capability URI checking is NOT performed here — that is the caller’s responsibility.

§Caller responsibility: notJSON

This function takes a pre-parsed serde_json::Value, not raw bytes. The caller is responsible for the initial JSON parse of the HTTP request body. If that parse fails (the body is not valid JSON), the caller must produce the notJSON error response itself — crate::error_invocation and crate::request_error with JmapError::not_json() handle that case. parse_request only validates the JMAP structure of an already-parsed value.

§Errors

Returns JmapError::not_request() if the value does not match the JmapRequest schema or if using is empty. Returns JmapError::limit("maxCallsInRequest") if the method call count exceeds max_calls.