Cuenta
- GET /v1/account - verificar autenticidad, ver nivel
- GET /v1/account/usage - uso del periodo actual
- PUT /v1/account/webhook - establecer URL webhook + eventos
DESARROLLADORES - COLECCIÓN CARTERO
Importa la colección. Golpea el API en cinco minutos.
Colección Postman preconstruida con ejemplos prácticos para cada punto final REST Fabrixa. Introduzca su clave API, haga clic en las solicitudes, vea las respuestas reales contra antes de escribir una sola línea de código de integración. Seguimiento de la colección se actualiza cuando lo hace API.
POSTMAN v10+ - SANDBOX + PRODUCTION ENVS - ACTUALIZADO CADA API RELEASE
QUÉ HAY EN LA COLECCIÓN
Cada punto final, con cargas útiles de ejemplo.
Organizado en carpetas por recurso: Cuenta, Productos, Pedidos, Webhooks, Editor SDK. Cada solicitud viene con un cuerpo de ejemplo trabajado, encabezados preestablecidos, y un ejemplo para que pueda previsualizar la forma de la respuesta antes de disparar.
Productos
- GET /v1/productos - listar / paginar / filtrar
- GET /v1/products/:id - detalle completo del producto
- GET /v1/products/:id/pricing - vista previa del nivel de volumen
Pedidos
- POST /v1/orders - crear (con clave de idempotencia)
- GET /v1/pedidos - listar / paginar
- GET /v1/orders/:id - estado, seguimiento, ciclo de vida
- DEL /v1/orders/:id - cancelar antes del bloqueo de producción
Webhooks y SDK
- POST /v1/webhooks/test - desencadenar evento de ejemplo
- GET /v1/webhooks/events - lista de tipos de eventos
- GET /v1/sdk/keys - claves SDK públicas + secretas
IMPORTAR EN 30 SEGUNDOS
Postman → Archivo → Importar → Enlace → pegar URL.
01
IMPORTAR LA COLECCIÓN
En Postman: Archivo → Importar → Enlace. Pega la URL JSON del botón de descarga anterior. Postman recupera y añade la colección a su espacio de trabajo.
02
IMPORTAR EL ENTORNO
Mismo flujo, entorno URL: .../fabrixa-api.postman_environment.json. Establece el andamiaje de variables (URL base, marcador de posición de clave API).
03
CONFIGURA TU CLAVE API
Abra el entorno importado, rellene FABRIXA_API_KEY con su clave sandbox. Cambie al entorno de producción cuando esté listo para enviar.
VARIABLES DE ENTORNO
Qué hay en el archivo env.
fabrixa.postman_environment.json
# Entorno de pruebas { "FABRIXA_BASE_URL": "https://sandbox.api.fabrixa.com/v1", "FABRIXA_API_KEY": "sk_sandbox_yourKeyHere", "FABRIXA_PUBLIC_KEY": "pk_sandbox_yourPublicKey", "FABRIXA_WEBHOOK_URL": "https://your-tunnel.ngrok.io/webhook" } # Entorno de producción (archivo independiente) { "FABRIXA_BASE_URL": "https://api.fabrixa.com/v1", "FABRIXA_API_KEY": "sk_live_yourKeyHere", "FABRIXA_PUBLIC_KEY": "pk_live_yourPublicKey", "FABRIXA_WEBHOOK_URL": "https://api.yourbrand.com/webhook" }
AUTH PRECONFIGURADO
Token de portador aplicado a nivel de colección.
La colección Autorización está configurada para heredar la clave API del entorno activo. Cada petición dentro de la colección la recoge automáticamente - sin configuración de cabecera por petición.
Pasar de sandbox a producción es un clic en el desplegable de entorno. Misma colección, diferentes claves, diferente URL base. No es necesario cambiar el código.
EJEMPLOS PRÁCTICOS
Cada solicitud se envía con un cuerpo de muestra y una respuesta guardada.
La colección no se compone sólo de extractos de URL. para que pueda pulsar Enviar y ver datos reales. Las respuestas de ejemplo guardadas en el panel Ejemplos para consultarlas fuera de línea.
CREAR ORDEN
POST /v1/pedidos
Cuerpo de ejemplo para un pedido de camisetas de 2 unidades con URL de ilustración personalizada, dirección del destinatario y clave de idempotencia. Pulse Enviar para ver una respuesta 201 Creado con order_id.
LISTA DE PRODUCTOS
GET /v1/productos
Consulta prefiltrada para la categoría de ropa. Devuelve el catálogo página por página con tallas, GSM, plazo de entrega y nivel de precios por SKU.
DESENCADENAR WEBHOOK
POST /v1/webhooks/prueba
Dispare manualmente un evento webhook de muestra a su URL registrada. Útil para depurar los controladores de webhook sin realizar un pedido real.
COMPROBAR EL USO
GET /v1/cuenta/uso
Uso actual del periodo de facturación, estado de progresión de niveles, volumen previsto al final del periodo. Útil para planificar la capacidad antes de una gran caída.
CANCELAR PEDIDO
DELETE /v1/pedidos/:id
Cancelar un pedido antes de que se bloquee la producción (normalmente en las 24 horas siguientes a su realización). Devuelve 409 si la producción ya ha comenzado - la clave de idempotencia gestiona los reintentos.
PRECIOS
GET /v1/productos/:id/precios
Previsualice el precio unitario en los niveles de volumen para un SKU determinado. Resulta útil para mostrar a los clientes el ahorro por unidad a medida que aumentan la cantidad del pedido.
VERSIONADO
La colección se actualiza cuando lo hace el API.
Cada versión Fabrixa API envía una colección Postman actualizada en la misma URL. Vuelva a importar para recoger nuevos puntos finales y cargas útiles de ejemplo. de la versión guardada seguirán funcionando hasta que el punto final quede obsoleto.
01
URL ESTABLE
La URL JSON de la colección es permanente. Al reimportar se obtiene la última versión. La URL nunca cambia entre versiones de API.
02
REFERENCIA DEL REGISTRO DE CAMBIOS
Véase Registro de cambios para obtener las notas de la versión API correspondientes: qué se ha movido, qué se ha añadido, qué está obsoleto.
03
POLÍTICA DE AMORTIZACIÓN
Los puntos finales tienen un plazo de 12 meses para quedar obsoletos. La colección señala las solicitudes obsoletas en la descripción para que sea difícil pasarlas por alto antes de que las cosas se rompan.
DESCARGAR Y EMPEZAR
Coge la colección. Lanza tu primera petición.
URL de importación: https://www.fabrixa.com/wp-content/themes/brighthub-fabrixa/assets/downloads/fabrixa-api.postman_collection.json