Ir al contenido
DESARROLLADORES

Integra la API de Marketplace de Servicios

Una API REST pequeña y predecible: obtener un token, crear una solicitud, validar duplicados. La documentación técnica y los recursos de integración se entregan a los partners aprobados.

¿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.

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.

Se admiten 22 mercados. La disponibilidad puede variar según la categoría de servicio y la ubicación.

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.