Un lien de partage est un instantané public en lecture seule d'un résultat d'outil. La vérification SEO est le seul outil partageable aujourd'hui.

Créer un lien

curl -X POST https://api.ferrlens.com/v1/shares \
  -H 'content-type: application/json' \
  -d '{"kind":"seo","input":{"url":"https://example.com"},"result":{}}'

Champ	Type	Notes
kind	string	Doit valoir seo. Toute autre valeur renvoie INVALID_KIND.
input	JSON	Ce qui a été soumis. 16 Kio maximum sérialisé (INPUT_TOO_LARGE).
result	JSON	Le résultat publié. 128 Kio maximum sérialisé (RESULT_TOO_LARGE).

La réponse :

{
  "id": "7K2M9QXH4D1V",
  "url": "https://ferrlens.com/share/7K2M9QXH4D1V",
  "expires_at": "2027-01-18T10:00:00Z",
  "revoke_token": "..."
}

Créer un lien publie les données à cette URL. La page de l'outil demande une confirmation avant ; si vous appelez l'endpoint vous-même, cette décision vous revient.

L'identifiant fait 12 caractères aléatoires : un lien ne peut pas être deviné. L'instantané stocke l'entrée et le résultat, tous deux des données publiques. Il ne stocke ni votre adresse IP ni votre user agent.

Durée de vie

Les liens créés anonymement expirent après 90 jours. expires_at dans la réponse donne l'instant exact. Passé ce délai, le lien renvoie 404, comme un identifiant révoqué ou inconnu.

Récupérer un instantané

curl https://api.ferrlens.com/v1/shares/7K2M9QXH4D1V

Renvoie id, kind, input, result, created_at et expires_at.

Révoquer un lien

Le revoke_token n'est renvoyé qu'une fois, à la création. Gardez-le : c'est le seul moyen de retirer le lien, et il est stocké haché.

curl -X DELETE https://api.ferrlens.com/v1/shares/7K2M9QXH4D1V \
  -H 'x-revoke-token: <revoke_token>'

Statut	Signification
204	Révoqué. Le lien renvoie désormais 404.
403	Jeton absent ou incorrect (REVOKE_FORBIDDEN).
404	Partage inconnu ou déjà révoqué.

Avec un compte

Des partages sans expiration sont prévus pour les comptes mais pas encore livrés. Pour l'instant, chaque lien, connecté ou non, suit la règle des 90 jours.