Controles e canais de compartilhamento

O que você pode fazer

Dois endpoints controlam como os botões de compartilhamento de um flipbook aparecem no visualizador:

• Interruptor mestre — ative ou desative todo o conjunto de botões de compartilhamento em uma chamada.
• Toggles por canal — decida exatamente quais canais sociais (Facebook, X, LinkedIn, WhatsApp, e-mail e outros) aparecem no menu de compartilhamento do visualizador.

Os dois se aplicam a um único flipbook, identificado pelo seu {flipbookId}.

Antes de começar

Você vai precisar de:

• Uma chave de API — enviada como cabeçalho X-Api-Key, ou como Authorization: Bearer YOUR_API_KEY.
• O {flipbookId} — o ID numérico do flipbook, retornado por create-by-file / create-by-url (como ID) ou por list.
• Todas as requisições vão para a URL base https://go.fliplink.me.

Ambos os endpoints recebem um corpo form-urlencoded (não JSON). Cada valor de campo é um boolean enviado como texto (true / false).

Ative ou desative os botões de compartilhamento

PUT /api/set-share-master/{flipbookId} é o interruptor mestre de liga/desliga para os botões de compartilhamento no visualizador.

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

Resposta:

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

Ative canais de compartilhamento individuais

PUT /api/set-share-channels/{flipbookId} ativa cada canal social de compartilhamento (Facebook, X, LinkedIn, WhatsApp, e-mail, etc.) individualmente no menu de compartilhamento do visualizador. Envie true para mostrar um canal ou false para ocultá-lo.

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'

Resposta:

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

Erros possíveis

• Chave de API ausente ou inválida → HTTP 401. Isso retorna uma página HTML de Unauthorized simples — não há corpo JSON. Confira se o cabeçalho X-Api-Key (ou Authorization: Bearer) está presente e correto.
• ID do item não encontrado ou não pertencente à sua chave → HTTP 200 com Message = Item not found.
• Campo do corpo desconhecido ou digitado errado → HTTP 200 com Message = Unknown field(s) '…'. Expected: ….