Para developers

Leadit Reviews se integra en los dos sentidos:

Webhooks: te avisamos

Plus y Pro

Un POST firmado a tu endpoint cuando una solicitud está lista, cuando toca un recordatorio y cuando entra, se publica o se rechaza una reseña.

API: nos preguntas

Pro

Pide el enlace de un pedido, confirma que lo mandaste, crea y modera reseñas, sube fotos, lee métricas y cambia ajustes.

La pieza central: el enlace

Cada pedido tiene una solicitud (request_id) con un enlace único, https://reviews.leadit.tech/r/{token}. La app decide cuándo toca, y tu canal lo despacha.

Shopifyorders/paidShopify nos avisa. Creamos la solicitud y la agendamos.
Leadit Reviewsreview_request.dueLlega el día: POST firmado a tu endpoint con el enlace.
Tu sistemaMandas el mensajePor WhatsApp, SMS o lo que uses. Respondes 2xx.
Tu clientereview.createdDeja su reseña y te avisamos, por si quieres agradecerle.

Empieza en cinco minutos

Crea una llave. En la app: Canales → API keys → Crear llave. Elige los permisos mínimos que necesitas. Copia la llave (rvw_live_…) y el secreto de firma (rvwsig_…): solo se muestran una vez.
Firma tu primera petición. Cada petición lleva la llave y una firma HMAC. Ver Autenticación.

Prueba con algo de solo lectura:

GET https://reviews.leadit.tech/api/v1/stats?period=30

Conecta el webhook en Canales → Webhook saliente para recibir los eventos. Ver Webhooks.

Datos básicos


Base de la API	`https://reviews.leadit.tech/api/v1`
Formato	JSON en UTF-8. Fechas en ISO 8601, en UTC.
Ids de Shopify	Como gid (`gid://shopify/Order/456`) o el número suelto (`456`).
Límite	120 peticiones por minuto por llave.
Tamaño máximo	64 KB por petición (5 MB en la importación en lote).
Mensajes de error	En inglés, con un `code` estable para programar contra él.

Autenticación y firmaLa llave, la firma HMAC, los permisos y la idempotencia, con ejemplos en curl, Node, Python y PHP.