Controles y canales para compartir

Qué puedes hacer

Dos endpoints controlan cómo aparecen en el visor los botones para compartir de un flipbook:

• Interruptor maestro — activa o desactiva todo el conjunto de botones para compartir en una sola llamada.
• Interruptores por canal — decide exactamente qué canales sociales (Facebook, X, LinkedIn, WhatsApp, correo y otros) se muestran en el menú de compartir del visor.

Ambos se aplican a un solo flipbook, identificado por su {flipbookId}.

Antes de empezar

Vas a necesitar:

• Una clave de API — enviada como el encabezado X-Api-Key, o como Authorization: Bearer YOUR_API_KEY.
• El {flipbookId} — el ID numérico del flipbook, devuelto por create-by-file / create-by-url (como ID) o por list.
• Todas las solicitudes van a la URL base https://go.fliplink.me.

Ambos endpoints reciben un cuerpo form-urlencoded (no JSON). El valor de cada campo es un booleano enviado como texto (true / false).

Activa o desactiva los botones para compartir

PUT /api/set-share-master/{flipbookId} es el interruptor maestro de encendido/apagado de los botones para compartir en el visor.

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

Respuesta:

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

Alterna los canales de compartir individuales

PUT /api/set-share-channels/{flipbookId} alterna cada canal social para compartir (Facebook, X, LinkedIn, WhatsApp, correo, etc.) de forma individual en el menú de compartir del visor. Envía true para mostrar un canal o false para ocultarlo.

curl -X PUT 'https://go.fliplink.me/api/set-share-channels/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsShareFacebook=true' \
  --data-urlencode 'IsShareTwitter=true' \
  --data-urlencode 'IsShareWhatsApp=true' \
  --data-urlencode 'IsShareTelegram=false' \
  --data-urlencode 'IsShareLinkedIn=true' \
  --data-urlencode 'IsSharePinterest=false' \
  --data-urlencode 'IsShareReddit=false' \
  --data-urlencode 'IsShareTumblr=false' \
  --data-urlencode 'IsShareMessenger=false' \
  --data-urlencode 'IsShareEmail=true' \
  --data-urlencode 'IsShareLine=false' \
  --data-urlencode 'IsShareWeChat=false' \
  --data-urlencode 'IsShareInstagram=false' \
  --data-urlencode 'IsShareFlipboard=false' \
  --data-urlencode 'IsShareGeneral=true'

Respuesta:

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

Errores posibles

• Clave de API ausente o no válida → HTTP 401. Esto devuelve una página HTML de "Unauthorized" sin formato — no hay cuerpo JSON. Comprueba que el encabezado X-Api-Key (o Authorization: Bearer) esté presente y sea correcto.
• ID de elemento no encontrado o no perteneciente a tu clave → HTTP 200 con Message = Item not found.
• Campo del cuerpo desconocido o mal escrito → HTTP 200 con Message = Unknown field(s) '…'. Expected: ….