appcore-api 1.0.2-rc

HTTP API host and transport contracts for AppCore Runtime.
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

# Contrato minimo de query

[English](basic.en.md) | [Français](basic.fr.md) |
[Exemplo intermediario](intermediate.pt.md) | [Guia](../guide.pt.md)

Valide uma query estruturada e limitada e monte sua resposta controlada.

```rust
use appcore_api::{QueryRequest, QueryResponse};
use serde_json::json;

fn main() -> Result<(), String> {
    let request = QueryRequest {
        query_name: "document.get".to_string(),
        query_id: "query-42".to_string(),
        payload: json!({ "document_id": "42" }),
    };
    request
        .validate(16 * 1024)
        .map_err(|error| format!("{error:?}"))?;
    let response = QueryResponse::ok(json!({
        "document_id": "42",
        "revision": 7
    }));

    println!("query={} ok={}", request.query_name, response.ok);
    Ok(())
}
```

Handlers de query devem permanecer sem efeitos colaterais. Aplique autenticacao
e limite de payload antes do dispatch.