Dos llamadas alcanzan para integrar: pedir una recomendación y registrar señales. Son HTTP con JSON, y el SDK no hace nada que no puedas hacer con ellas.

Las cinco operaciones

El estado del proceso vive en la raíz del server, fuera de /v1 y de /salespilot.

El recorrido mínimo

Una recomendación (en la API, Decision: la lista de productos recomendados para ese momento) y la señal de que se mostró, atada a su decision_id. Con las dos, aparece en tu tienda y se mide.

Convenciones que valen para todo

  • La tienda sale de la clave, nunca del cuerpo: Qué decide CrossUp. Un producto de otra tienda da 404, como uno inexistente.
  • Los ids tienen prefijo. cn_, itm_, var_, dec_, sig_, vis_, ses_, spk_. Tratalos como opacos.
  • Los textos son por idioma: objetos { idioma: texto } con al menos una clave, sin idioma garantizado.
  • Lo ausente es desconocido, no cero ni falso.
  • Las fechas son RFC 3339 en UTC.
  • Los errores tienen forma fija: Errores.
  • Reintentar es seguro donde hay un id estable: el de la señal.

El contrato

La fuente de verdad es platform-api-v1.yaml, en OpenAPI 3.1. De ahí salen el SDK, esta referencia y los fixtures de los tests.

Cuota y caché

Sesenta por minuto, Retry-After, y qué cachear.

Versionado

Qué puede cambiar sin avisar y qué no.