Die Indexierung durch Suchmaschinen steuern (noindex)

Was du tun kannst

Jedes gehostete Flipbook hat eine Seite, die Suchmaschinen crawlen können. Über diesen Endpunkt steuerst du, ob diese Seite indexierbar ist:

• Füge ein noindex-Signal hinzu, damit Suchmaschinen das Flipbook aus ihren Ergebnissen heraushalten.
• Entferne es wieder, damit das Flipbook normal indexiert werden kann.

Bevor du loslegst

Du brauchst:

• Einen API-Schlüssel – wird bei jeder Anfrage als X-Api-Key-Header gesendet.
• Die flipbookId – die numerische ID, die beim Erstellen eines Flipbooks zurückgegeben wird (als ID) oder über die Listen-Endpunkte.
• Anfragen gehen an die Basis-URL https://go.fliplink.me.

Der Body ist form-urlencoded (kein JSON).

Parameter

PUT /api/set-indexing/{flipbookId} nimmt ein einzelnes urlencodiertes Feld entgegen:

Ein Flipbook nicht indexierbar machen

Setze IsNoIndex=true. Suchmaschinen, die das robots-Signal beachten, listen die Seite des Flipbooks nicht.

curl -X PUT 'https://go.fliplink.me/api/set-indexing/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsNoIndex=true'

Antwort:

{ "Result": "OK", "Message": "Updated successfully" }

Die Indexierung wieder erlauben

Setze IsNoIndex=false, um das noindex-Signal zu entfernen, damit das Flipbook in Suchergebnissen erscheinen kann.

curl -X PUT 'https://go.fliplink.me/api/set-indexing/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsNoIndex=false'

Antwort:

{ "Result": "OK", "Message": "Updated successfully" }

Mögliche Fehler

• Fehlender oder ungültiger API-Schlüssel → HTTP 401. Das gibt eine reine Unauthorized-HTML-Seite zurück – es gibt keinen JSON-Body. Prüfe, ob der X-Api-Key-Header vorhanden und korrekt ist.
• Unbekannte flipbookId (oder eine, die nicht zu deinem Schlüssel gehört) → HTTP 200 mit { "Result": "ERROR", "Message": "Item not found" }.
• Falsch geschriebenes Body-Feld → HTTP 200 mit { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }.

Hinweise

• noindex ist eine SEO-Steuerung, keine Zugriffskontrolle. Es bittet Suchmaschinen, die Seite nicht zu listen – es hält niemanden, der den Link hat, davon ab, das Flipbook zu öffnen. Um zu beschränken, wer zusehen kann, nutze Passwortschutz oder eine E-Mail-Erlaubnisliste.
• Indexierungsänderungen greifen nicht sofort. Selbst nachdem du noindex gesetzt hast, muss eine Suchmaschine die Seite erst erneut crawlen, bevor sie aus den Ergebnissen fällt; das Timing bestimmt die Suchmaschine.