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 esplatform-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.