Lea el contrato antes de hablar con nosotros.

El contrato habla por sí mismo

Todo lo relativo a la solicitud y la respuesta — cada campo, su tipo, si es obligatorio, las estructuras anidadas, ejemplos completos, la política de obsolescencia y el límite de solicitudes — lo sirve la propia API:

curl https://cerrax-portal-api-zenqusyaia-nw.a.run.app/v1

Se genera a partir de los mismos modelos que validan su solicitud, así que no puede desfasarse de lo que el endpoint acepta. Por eso esta página es corta: todo lo que copiáramos aquí sería una segunda copia, y las segundas copias se quedan viejas.

Cotizar un trabajo

La solicitud más pequeña que devuelve un precio:

curl -X POST https://cerrax-portal-api-zenqusyaia-nw.a.run.app/v1/price \
  -H "X-Cerrax-Api-Key: <your key>" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "gb",
    "volumeM3": 32.0,
    "distanceMiles": 48.0
  }'

Envíe distanceMiles o los dos códigos postales. El acceso, los ajustes, el nivel de empaque, las fechas y su propia referencia son opcionales — y la guía de campos en /v1 los enumera todos con su significado.

Lo que prometemos, y lo que no

• El mismo trabajo devuelve el mismo precio. El motor es determinista y tiene versiones; una entrada y una versión dadas siempre producen la misma cifra, y cada cambio se publica con fecha en /kernel/changelog.
• Añadir un campo no rompe nada; quitar uno implica una versión nueva. La política de obsolescencia completa, con el plazo de aviso, está en el contrato.
• La clave identifica a la empresa. No hay un campo moverId que enviar — no puede cotizar en nombre de otro por accidente.
• Un campo que no aceptamos se rechaza, no se ignora. Un error de escritura devuelve un 422 que lo nombra, en lugar de un precio que ignoró en silencio lo que usted envió.
• Cuando no sabe, lo dice. Los datos de baja confianza pueden volver escalados a una persona en lugar de una cifra. Preferimos darle una negativa honesta que una suposición segura de sí misma.

Cómo obtener una clave

Las claves se emiten por empresa, en una conversación — estamos empezando y preferimos entender qué está integrando antes que repartir credenciales a gran escala. Cuéntenos qué está construyendo y le responderemos en un día hábil.

Nada de lo anterior requiere una. Si leer el contrato le basta para saber que esto no le sirve, es un buen resultado y le costó un curl.