Indexering door zoekmachines regelen (noindex)

Wat je kunt doen

Elke gehoste flipbook heeft een pagina die zoekmachines kunnen crawlen. Met dit endpoint bepaal je of die pagina indexeerbaar is:

• Voeg een noindex-signaal toe zodat zoekmachines de flipbook uit hun resultaten houden.
• Verwijder het weer zodat de flipbook normaal kan worden geïndexeerd.

Voordat je begint

Je hebt nodig:

• Een API-sleutel — meegestuurd als de X-Api-Key-header op elk verzoek.
• De flipbookId — de numerieke id die je terugkrijgt wanneer je een flipbook aanmaakt (als ID) of via de list-endpoints.
• Verzoeken gaan naar de basis-URL https://go.fliplink.me.

De body is form-urlencoded (geen JSON).

Parameter

PUT /api/set-indexing/{flipbookId} neemt één urlencoded veld:

Een flipbook niet-indexeerbaar maken

Zet IsNoIndex=true. Zoekmachines die het robots-signaal respecteren, tonen de pagina van de flipbook niet.

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

Response:

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

Indexering weer toestaan

Zet IsNoIndex=false om het noindex-signaal te verwijderen zodat de flipbook in zoekresultaten kan verschijnen.

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

Response:

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

Mogelijke fouten

• Ontbrekende of ongeldige API-sleutel → HTTP 401. Dit geeft een kale Unauthorized-HTML-pagina terug — er is geen JSON-body. Controleer of de X-Api-Key-header aanwezig en correct is.
• Onbekende flipbookId (of een die niet bij je sleutel hoort) → HTTP 200 met { "Result": "ERROR", "Message": "Item not found" }.
• Verkeerd gespeld body-veld → HTTP 200 met { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }.

Opmerkingen

• noindex is een SEO-instelling, geen toegangsbeheer. Het vraagt zoekmachines de pagina niet te tonen — het weerhoudt niemand met de link ervan om de flipbook te openen. Om te beperken wie mag kijken, gebruik je wachtwoordbeveiliging of een e-mailtoegangslijst.
• Wijzigingen in indexering zijn niet direct. Zelfs nadat je noindex hebt ingesteld, moet een zoekmachine de pagina opnieuw crawlen voordat die uit de resultaten verdwijnt; de timing is aan de zoekmachine.