Consultar el coste de una revelación

Lo que costaría revelar esta empresa ahora mismo, y tu cuota restante. No se gasta nada.

GEThttps://findbytown.com/api/v1/businesses/{id}/revealSin cuota

Parámetros de ruta

Nombre	Tipo	Descripción
id(obligatorio)	integer	Id de la empresa, un entero.

Ejemplos

curl "https://findbytown.com/api/v1/businesses/1001/reveal" \
  -H "Authorization: Bearer fbt_EXAMPLE_not_a_real_key_0000"

const res = await fetch("https://findbytown.com/api/v1/businesses/1001/reveal", {
  headers: { Authorization: "Bearer fbt_EXAMPLE_not_a_real_key_0000" },
});
const body = await res.json();
if (!res.ok) throw new Error(body.error);
console.log(body);

import requests

res = requests.get(
    "https://findbytown.com/api/v1/businesses/1001/reveal",
    headers={"Authorization": "Bearer fbt_EXAMPLE_not_a_real_key_0000"},
)
body = res.json()
if not res.ok:
    raise RuntimeError(body["error"])
print(body)

Respuesta

Ejemplo con valores ficticios:

{
  "data": {
    "id": 1001,
    "cost": 1,
    "alreadyRevealed": false,
    "quota": {
      "used": 12,
      "allowance": 10000,
      "remaining": 9988,
      "resetAt": "2030-01-01T00:00:00.000Z"
    }
  }
}

Errores

Código	Estado HTTP	Significado
bad_id	400	El id de la empresa no es un entero positivo.
missing_api_key	401	No hay cabecera Authorization, o está vacía.
invalid_api_key	401	La clave no existe o ha sido revocada.
plan_without_api	403	El plan actual de la cuenta no incluye la API. Se aplica desde el momento en que termina un plan.
suspended	403	La cuenta está suspendida. Sus claves vuelven a funcionar si se levanta la suspensión.
not_found	404	Esa empresa no existe, o se retiró a petición de su propietario.
email_invalid	409	El email de esta empresa está marcado como no válido, así que no se puede revelar. No se ha gastado nada.
rate_limited	429	Demasiadas solicitudes este minuto. Espera los segundos que indica Retry-After.
blocked	429	El acceso a los datos de empresas está temporalmente en pausa por uso automatizado, como recorrer ids. Retry-After indica el tiempo restante. Escribe a soporte si es un error.
internal_error	500	Algo ha fallado por nuestra parte. Indica requestId al escribir a soporte.

Volver a findbytown