API

Dos endpoints, solo de lectura. Devuelven lo que el pipeline encontró para su cuenta: las empresas que leyó y las que superaron todas las etapas. Todo lo que el panel muestra en esas dos pantallas está disponible aquí, en JSON, para esa misma cuenta y ninguna otra.

Autenticación

Cree una clave en el panel, en Ajustes. Se muestra una sola vez, porque solo se guarda su hash, de modo que no hay ninguna pantalla capaz de revelarla más tarde. Envíela como token bearer.

curl https://knockwire.com/api/reads \
  -H "Authorization: Bearer kw_live_..."

Una solicitud sin clave, con una cabecera mal formada o con una clave revocada recibe un 401 con un cuerpo JSON que explica cuál de los tres. Una clave lee todas las empresas y todos los rechazos de su cuenta, así que merece el mismo cuidado que una contraseña. Revocar una en Ajustes surte efecto en la siguiente solicitud.

Endpoints

• GET /api/reads Todas las empresas que el pipeline examinó, las más recientes primero. Filtre con outcome=refuse o outcome=knock. Por defecto devuelve los rechazos, porque los rechazos son la parte que vale la pena leer. limit es 100 por defecto y se limita a 500.
• GET /api/prospects Las empresas que superaron las cuatro etapas, con su puntuación y el razonamiento que la sostiene.

No hay parámetro de cuenta. La clave decide de quién son los datos que vuelven, y una solicitud que lleve tenant= se rechaza con un 400 en lugar de ignorarse en silencio.

Lo que esta API todavía no hace

Escrito aquí para que nadie lo descubra a mitad de una integración.

• Sin escrituras. No hay ningún endpoint que acepte una lista de empresas. El descubrimiento lee sus propias fuentes.
• Sin envíos. Nada en esta API puede aprobar ni entregar un mensaje. La aprobación es una persona en el panel, y eso es una decisión de producto más que una función que falte.
• Sin prefijo de versión. Las rutas no llevan versión mientras la forma siga moviéndose. Cuando eso cambie se anunciará en el changelog.
• Sin límite de uso publicado. Hoy no hay ninguna restricción por clave. Sea razonable, y espere que aparezca una antes de que haga falta y no después.