Substituir o PDF de um flipbook e duplicá-lo

O que você pode fazer

Estes endpoints permitem trocar o PDF por trás de um flipbook que você já criou, ou gerar cópias dele — tudo no servidor, sem recriar nada do zero:

• Substituir o PDF a partir de um arquivo — envie um novo PDF via multipart form data.
• Substituir o PDF a partir de uma URL — informe uma URL ao servidor e ele baixa o novo PDF.
• Duplicar um flipbook — faça uma ou mais cópias, cada uma com seu próprio ID e URL de compartilhamento novos.

Os dois métodos de substituição mantêm o ID, as configurações e o link de compartilhamento do flipbook — só o PDF por trás dele muda.

Antes de começar

• Uma chave de API — enviada como cabeçalho X-Api-Key, ou como Authorization: Bearer YOUR_API_KEY, em toda requisição.
• URL base: https://go.fliplink.me.
• Os três endpoints recebem o parâmetro de caminho {flipbookId} — o ID numérico do flipbook, retornado por create-by-file / create-by-url (como ID) ou por list.
• Replace PDF (URL) e Duplicate enviam os corpos como form-urlencoded (não JSON). Replace PDF (arquivo) envia multipart form data.

Substitua o PDF a partir de um arquivo

Upload multipart. O servidor mescla automaticamente o novo PDF com qualquer página de frente/verso ainda anexada ao flipbook. O flipbook mantém o ID, as configurações e o link de compartilhamento.

curl -X PUT 'https://go.fliplink.me/api/replace-pdf/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@/path/to/file'

Resposta:

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

Substitua o PDF a partir de uma URL

Substitui o PDF de um flipbook existente por um que o servidor baixa de uma URL que você fornece. O flipbook mantém o ID, as configurações e o link de compartilhamento.

curl -X PUT 'https://go.fliplink.me/api/replace-pdf-by-url/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'File=https://example.com/new.pdf'

Resposta:

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

Duplique um flipbook

Cria uma ou mais cópias no servidor de um flipbook — cada cópia recebe seu próprio ID e URL de compartilhamento novos. Count aceita de 1 a 500 e é limitado no servidor.

curl -X POST 'https://go.fliplink.me/api/duplicate/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Count=3'

Resposta:

{
  "Result": "OK",
  "Count": 3,
  "Items": [
    {
      "ID": "93213",
      "URL": "https://go.fliplink.me/C73371B4-B041-4EBD-A518-1E5B5B56DA44"
    },
    {
      "ID": "93214",
      "URL": "https://go.fliplink.me/2F9A0C7D-6E51-4B22-A9F0-7D3C1E8B4A15"
    },
    {
      "ID": "93215",
      "URL": "https://go.fliplink.me/8B4E2A19-C037-45D6-9E1B-4A6F0D2C7E83"
    }
  ]
}

Erros possíveis

Replace PDF (arquivo) — PUT /api/replace-pdf/{flipbookId}:

• Chave de API ausente ou inválida → HTTP 401. Retorna uma página HTML 401 Unauthorized — não há corpo JSON.
• ID do item não encontrado ou não pertencente à sua chave → HTTP 200 com Message: "Item not found".
• O arquivo enviado não é um PDF legível → HTTP 200 com Message: "File is not a valid PDF.".
• O upload excede o tamanho máximo de arquivo do plano → HTTP 413 com Message: "File exceeds the maximum allowed upload size.".

Replace PDF (URL) — PUT /api/replace-pdf-by-url/{flipbookId}:

• Chave de API ausente ou inválida → HTTP 401. Retorna uma página HTML 401 Unauthorized — não há corpo JSON.
• 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: …".

Duplicate — POST /api/duplicate/{flipbookId}:

• Chave de API ausente ou inválida → HTTP 401. Retorna uma página HTML 401 Unauthorized — não há corpo JSON.
• 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: …".