¿Qué es Fixando?
La API de Marketplace de Servicios de Fixando es una API REST protegida con OAuth 2.0 client credentials, con endpoints para crear solicitudes de servicio y validar duplicados. Es privada, y los recursos técnicos se comparten únicamente con partners aprobados.
Autenticación
Solicita un bearer token al endpoint OAuth mediante el grant client credentials, y envíalo en la cabecera Authorization de cada llamada. Los tokens tienen vida corta, así que gestiona su caché y renovación en el servidor.
- POST /oauth/token - grant client credentials
- POST /v1/request/create - crear solicitud de servicio
- POST /v1/request/validate - validar duplicados
- La documentación técnica y los recursos de integración se entregan a partners aprobados
Crear una solicitud
Envía parámetros form-encoded con la categoría, la ubicación y la descripción de la necesidad. Los partners aprobados también pueden enviar audio en base64 en lugar de texto. Valida primero si tu flujo puede generar envíos repetidos.
Buenas prácticas
Mantén las credenciales de partner en el servidor, nunca en el navegador ni en bundles móviles. Gestiona los límites de uso con backoff exponencial, registra los identificadores devueltos y trata la validación como parte del flujo normal, no como un extra opcional.
Preguntas frecuentes
- ¿Qué content type espera el endpoint de creación?
- application/x-www-form-urlencoded, con un bearer token en la cabecera Authorization.
- ¿Dónde está la documentación completa?
- La documentación técnica y los recursos de integración, incluida una especificación OpenAPI y una colección Postman, se entregan directamente a los partners aprobados durante el onboarding.
- ¿La especificación OpenAPI es pública?
- No. Forma parte de nuestros recursos privados para partners y se comparte con partners aprobados, junto con una colección Postman, para acelerar la integración.
Explorar más
Empieza tu integración
Contáctanos para iniciar una integración de partner. Nuestro equipo revisa cada integración de forma individual y hablará contigo de los detalles técnicos.
Solicitar acceso a la API
Cuéntanos cómo es tu producto y cómo te gustaría integrar Fixando. Nuestro equipo revisa cada integración de forma individual y se pondrá en contacto contigo para hablar de tu caso de uso y de los requisitos técnicos.
