Saltar al contenido

Primeros pasos ​

Usa la API de Revi para sincronizar datos de comercio, consultar estadísticas de reviews y recuperar reviews para reporting o sistemas externos.

Base URLs ​

EntornoBase URL
API de producciónhttps://api.revi.io

API actual ​

Todas las rutas de endpoints de esta documentación son relativas a https://api.revi.io.

Esta guía rápida usa /api/2026-04, que autentica con X-API-KEY. La versión 2026-10 usa credenciales Bearer y es el contrato recomendado para integraciones nuevas. Consulta Versionado y Autenticación antes de elegir versión para una integración nueva.

Usa https://api.revi.io/api/2026-04 para integraciones públicas:

bash
curl "https://api.revi.io/api/2026-04/ping" \
  -H "Accept: application/json" \
  -H "X-API-KEY: revi_test_xxxxxxxxx"

Flujo de integración ​

  1. Llama a GET /api/2026-04/ping para verificar la API key.
  2. Envía productos con POST /api/2026-04/products.
  3. Envía pedidos con POST /api/2026-04/orders.
  4. Relaciona productos con pedidos usando POST /api/2026-04/orders/{id_order}/products.
  5. Actualiza el estado del pedido con PATCH /api/2026-04/orders/{id_order}/status.
  6. Consulta reviews, valoraciones de producto y estadísticas de tienda.

Recursos soportados ​

RecursoEndpoints principales
SistemaGET /api/2026-04/ping
TiendaGET /api/2026-04/shop, GET /api/2026-04/shop/stats
PedidosGET /api/2026-04/orders, POST /api/2026-04/orders, GET /api/2026-04/orders/{id_order}, PATCH /api/2026-04/orders/{id_order}/status, POST /api/2026-04/orders/{id_order}/products
ProductosGET /api/2026-04/products, POST /api/2026-04/products, GET /api/2026-04/products/{id_product}, GET /api/2026-04/products/{id_product}/reviews
ReviewsGET /api/2026-04/reviews, GET /api/2026-04/reviews/{id}

Formatos de datos ​

Los endpoints usan bodies JSON y respuestas JSON.

Usa este formato de fecha y hora salvo que un endpoint indique otra cosa:

text
YYYY-MM-DD HH:MM:SS

Los decimales deben enviarse con formato fijo:

text
30.50

Primera comprobación ​

Llama a GET https://api.revi.io/api/2026-04/ping para confirmar que la API key resuelve correctamente el negocio asociado.

Las respuestas correctas incluyen el header Revi-Version y un envelope JSON:

json
{
  "success": true,
  "data": {
    "message": "pong",
    "business": "example.com"
  },
  "meta": {
    "api_version": "2026-04"
  }
}

Documentación pública de la API de Revi.