Sandbox

Una clave de prueba funciona en el sandbox. Sus solicitudes pasan por la misma pasarela que con una clave real: la clave, los ámbitos, los límites, Idempotency-Key, la validación de la solicitud, los trabajos, los archivos y los webhooks funcionan como en producción. Solo se simula el trabajo en sí: ninguna herramienta se ejecuta, no se crea nada y no se cobra nada.

Obtener una clave de prueba

En el panel abra API → Claves, elija el tipo de clave Prueba y cree la clave. Una clave de prueba empieza por gsk_test. Úsela igual que una clave real.

Cada respuesta del sandbox lleva el encabezado Grem-Sandbox: true, para que un registro de prueba nunca se confunda con trabajo real, también las respuestas dadas antes de comprobar la clave (JSON mal formado, 413, ruta desconocida).

Qué ocurre

• La validación es real. Una solicitud que producción rechazaría, el sandbox la rechaza con el mismo estado y motivo: un campo que falta, menos de 4 fotos en un paquete de contenido, textos sin inmueble, descripción, ciudad ni superficie. También se comprueban los campos de formulario de las solicitudes multipart, los campos del informe de otra categoría y los valores de heatingType de una casa, y también los archivos subidos: tipo y tamaño. Lo que producción recorta o sustituye (un texto largo, una length de vídeo desconocida) el sandbox también lo acepta.
• Los resultados son muestras. Las herramientas síncronas responden al momento con valores de muestra fijos. Las asíncronas devuelven un jobId; el trabajo pasa pending → running → resultado en unos 5 segundos.
• La revisión de informe se detiene en action_required con datos de muestra en extracted, como en producción; confírmela con POST /valuation/review/jobs/{id}/confirm.
• Los archivos son marcadores. Los PDF y las imágenes son archivos reales que se pueden abrir; el vídeo, el docx y los textos son marcadores cortos rotulados con el tipo de contenido correcto. Un archivo existe solo para un trabajo del sandbox terminado, en la ruta de su herramienta y con un id de artefacto que devolvió el trabajo; si no, 404. Un vídeo de avatar se sirve con cualquier id de artefacto de un trabajo terminado, como en producción. Range funciona (206, 416).
• Los webhooks son reales. Una clave de prueba crea y gestiona solo direcciones de webhook del sandbox. Estas reciben solo eventos de trabajos del sandbox: entregas firmadas con reintentos, exactamente como en producción. Las direcciones reales nunca reciben eventos del sandbox, y una clave de prueba no puede verlas ni cambiarlas.

Elegir el resultado

El encabezado Grem-Simulate decide cómo termina la llamada o el trabajo:

El valor no distingue mayúsculas. Un valor desconocido responde 400, para que una errata nunca pase como éxito. Las claves reales ignoran el encabezado.

curl -X POST https://developers.grem.capital/api/v1/text/generate \
  -H "Authorization: Bearer gsk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "Grem-Simulate: failed" \
  -d '{"city":"Berlin","totalArea":64}'

Qué puede hacer una clave de prueba

Diferencias con producción

• Los resultados son muestras fijas, no una valoración ni textos reales. No los muestre a sus usuarios.
• El sandbox no comprueba que el inmueble de objectId exista y sea suyo; producción responde 403 o 404 en ese caso.
• Los trabajos y resultados se guardan un día.

Artículos relacionados

• Inicio rápido
• Trabajos y resultados
• Webhooks