A API

# 1 · Uma decisão para a página de produto
curl -s -X POST "$CROSSUP_BASE_URL/v1/recommendations" \
  -H "Authorization: Bearer $CROSSUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "connection_id": "cn_…", "surface": "pdp", "placement_key": "pdp-related", "context_item_id": "itm_…" }'

# 2 · O sinal de que foi exibida, amarrado a essa decisão
curl -s -X POST "$CROSSUP_BASE_URL/v1/connections/cn_…/storefront-signals" \
  -H "Authorization: Bearer $CROSSUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "signals": [ { "signal_id": "sig_…", "type": "impression", "occurred_at": "2026-09-18T12:00:00Z", "decision_id": "dec_…" } ] }'

const res = await fetch(`${base}/v1/recommendations`, {
  method: "POST",
  headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
  body: JSON.stringify({ connection_id, surface: "pdp", placement_key: "pdp-related", context_item_id }),
});
const decision = await res.json(); // decision_id, results[], reason_codes[]

// O sinal, com um id estável caso você tente de novo.
await fetch(`${base}/v1/connections/${connection_id}/storefront-signals`, {
  method: "POST",
  headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
  body: JSON.stringify({ signals: [{ signal_id, type: "impression", occurred_at, decision_id: decision.decision_id }] }),
});

req, _ := http.NewRequest("POST", base+"/v1/recommendations", toJSON(map[string]any{
    "connection_id":   connectionID,
    "surface":         "pdp",           // o momento
    "placement_key":   "pdp-related",   // o nome do lugar
    "context_item_id": itemID,          // o produto que o comprador está vendo
}))
req.Header.Set("Authorization", "Bearer "+apiKey)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req) // 200 com a decisão; vazia também é válida

// O sinal de que foi exibida vai depois, ao mesmo host, amarrado a decision_id.