Qué es la API de estimaciones

La API de estimaciones cotiza trabajos de servicios para el hogar. Envía lo que escribió un cliente, la conversación hasta ahora o fotos del trabajo. La API responde con el trabajo que reconoció y las horas de mano de obra. También da la tarifa por hora y un rango de precio en la moneda de la región.

Qué contiene una estimación

• task: el trabajo que Hometown reconoció, como instalar una cerca de madera.
• scope: la cantidad, el tamaño de la cuadrilla y qué tan segura es la estimación.
• labor: las horas de mano de obra, el tiempo en sitio con la cuadrilla, la tarifa por hora y de dónde salió la tarifa.
• price: el extremo bajo y el alto del rango, en centavos.
• steps: el cálculo, una línea por paso, en el idioma de la petición.

Cómo funciona una petición

1. Tu servidor envía POST /v1/estimates con una llave de prueba o live.
2. Hometown lee la descripción, encuentra el trabajo y lo mide.
3. La respuesta llega en la misma petición, casi siempre en pocos segundos.
4. Si falta una medida, el estado es needs_detail y question dice qué preguntar.

Por dónde empezar

• Sigue el inicio rápido para hacer la primera llamada con una llave de prueba.
• Lee sobre llaves y autenticación antes de pasar a live.
• Consulta la referencia de la API para ver cada campo.