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
| Entorno | Base URL |
|---|---|
| API de producción | https://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:
curl "https://api.revi.io/api/2026-04/ping" \
-H "Accept: application/json" \
-H "X-API-KEY: revi_test_xxxxxxxxx"Flujo de integración
- Llama a
GET /api/2026-04/pingpara verificar la API key. - Envía productos con
POST /api/2026-04/products. - Envía pedidos con
POST /api/2026-04/orders. - Relaciona productos con pedidos usando
POST /api/2026-04/orders/{id_order}/products. - Actualiza el estado del pedido con
PATCH /api/2026-04/orders/{id_order}/status. - Consulta reviews, valoraciones de producto y estadísticas de tienda.
Recursos soportados
| Recurso | Endpoints principales |
|---|---|
| Sistema | GET /api/2026-04/ping |
| Tienda | GET /api/2026-04/shop, GET /api/2026-04/shop/stats |
| Pedidos | GET /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 |
| Productos | GET /api/2026-04/products, POST /api/2026-04/products, GET /api/2026-04/products/{id_product}, GET /api/2026-04/products/{id_product}/reviews |
| Reviews | GET /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:
YYYY-MM-DD HH:MM:SSLos decimales deben enviarse con formato fijo:
30.50Primera 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:
{
"success": true,
"data": {
"message": "pong",
"business": "example.com"
},
"meta": {
"api_version": "2026-04"
}
}