Vérifier le coût d’une révélation

Ce que coûterait la révélation de cette entreprise à cet instant, et votre quota restant. Rien n’est consommé.

GEThttps://findbytown.com/api/v1/businesses/{id}/revealSans quota

Paramètres de chemin

Nom	Type	Description
id(requis)	integer	Identifiant de l’entreprise, un entier.

Exemples

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)

Réponse

Exemple avec des valeurs fictives :

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

Erreurs

Code	Statut HTTP	Signification
bad_id	400	L’identifiant de l’entreprise n’est pas un entier positif.
missing_api_key	401	En-tête Authorization absent ou vide.
invalid_api_key	401	La clé n’existe pas ou a été révoquée.
plan_without_api	403	L’offre actuelle du compte n’inclut pas l’API. S’applique dès la fin d’une offre.
suspended	403	Le compte est suspendu. Ses clés refonctionnent si la suspension est levée.
not_found	404	Cette entreprise n’existe pas, ou elle a été retirée à la demande de son propriétaire.
email_invalid	409	L’email de cette entreprise est marqué comme invalide, elle ne peut donc pas être révélée. Rien n’a été consommé.
rate_limited	429	Trop de requêtes cette minute. Attendez le nombre de secondes indiqué dans Retry-After.
blocked	429	L’accès aux données d’entreprises est temporairement suspendu en raison d’un usage automatisé, comme le parcours des identifiants. Retry-After indique le temps restant. Écrivez au support s’il s’agit d’une erreur.
internal_error	500	Une erreur s’est produite de notre côté. Indiquez requestId en écrivant au support.

Retour à findbytown