links

POST /v1/content/external-sites/{siteId}/verify

Re-check the credential on one connected external site, now.

Tous les points de terminaison links

Toute la documentation pour développeurs

Authentification

Envoyez une clé d'API en tant que jeton du porteur (bearer token). Cet endpoint n'indique pas de permission spécifique dans la spécification, attribuez donc à votre clé le minimum requis et vérifiez la réponse plutôt que de faire des suppositions.

Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.

Essayer

Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.

curl -X POST https://api.zinndigital.com/v1/content/external-sites/{siteId}/verify \
  -H "Authorization: Bearer zdk_live_…"

Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API

Détails

Gated on links.edit. The same check runs daily on its own; this is the button for a customer who has just fixed something and does not want to wait.

Paramètres

NomTypeObligatoireQu'est-ce que c'est
siteId (path)stringOui

Réponse

NomTypeObligatoireQu'est-ce que c'est
site_idstringOui
primary_domainstringOui
namestringOui
is_externalbooleanOuiAlways true here. The same site appears in /v1/sites badged External.
base_urlstringOuiThe address we publish to, including any path (e.g. https://example.com/blog).
reachablebooleanNonWhat the last check found. null means we have not checked, which is not the same as "it does not work" — an unchecked site is never rendered as broken.
checked_atstringNon
detailstringNonWhat the site said last time, verbatim. Shown on the site's own screen.
detected_identitystringNon
backupobjectOuiWhether we can back this site up, and whether we can put it back. Served on the list so a screen showing a customer's whole external estate makes one request rather than one per…

Erreurs que cet point de terminaison peut renvoyer

401 · 403 · 404