Haz tu primera estimación

Esta guía toma unos cinco minutos. Necesitas una cuenta con acceso a la API de estimaciones y una terminal con curl.

Crea una llave de prueba

1. Inicia sesión en wfskills.com/portal/developer.
2. Elige New key, ponle nombre y deja seleccionado Test.
3. Confirma tu contraseña cuando el panel la pida.
4. Copia la llave. El panel la muestra una sola vez.

Una llave de prueba nunca gasta créditos. Responde las entradas del sandbox con ejemplos fijos.

Envía la petición

Guarda la llave en una variable de entorno y envía una entrada del sandbox:

export HOMETOWN_API_KEY=hw_test_<your_key>

curl https://api.wfskills.com/v1/estimates \
  -H "Authorization: Bearer $HOMETOWN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"input": {"text": "sandbox:priced"}}'

Lee la respuesta

La respuesta es la estimación de 100 pies de cerca de madera en la región de la costa del golfo de Misisipi:

{
  "status": "priced",
  "region": "US-MS",
  "currency": "USD",
  "task": { "slug": "home-improvement.fence.install", "trade": "fence", "action": "install", "unit": "linear_foot" },
  "labor": { "hours": 18, "elapsed_hours": 9.45, "hourly_rate_cents": 7200, "rate_source": "typical" },
  "price": { "min_cents": 103680, "max_cents": 155520 },
  "steps": [
    { "text": "Scope: 100 linear feet of fence (install)" },
    { "text": "Hours: 4.00 setup + (100 x 0.1400 per linear foot) = 18.00 labor hours" },
    { "text": "Rate: $72.00/hr, going rate for fence work, no rate on file" },
    { "text": "Labor: 18.00 h x $72.00 = $1,296.00" },
    { "text": "Crew of 2: same 18.0 labor hours and the same cost, finished in about 9.4 hours on site" }
  ]
}

• labor.hours es la mano de obra total. elapsed_hours es el tiempo en sitio con la cuadrilla.
• price es un rango en centavos: de USD 1,036.80 a USD 1,555.20.
• steps muestra cómo llegó Hometown a las cifras.

Lo que costó

La respuesta trae X-Credits-Used: 0. Una llave de prueba no gasta créditos, y el panel solo cuenta las llamadas de producción.

Siguientes pasos

• Envía una descripción real con la misma llave: estimación desde texto.
• Consulta todas las entradas del sandbox: sandbox.