Замена PDF флипбука и его дублирование

Что можно сделать

Эти эндпоинты позволяют менять PDF-файл в уже созданном флипбуке или создавать его копии — всё на стороне сервера, без пересоздания с нуля:

• Заменить PDF из файла — загрузите новый PDF через multipart form data.
• Заменить PDF из URL — передайте серверу URL, и он скачает новый PDF.
• Дублировать флипбук — сделайте одну или несколько копий, каждая со своим новым ID и URL для общего доступа.

Оба метода замены сохраняют ID флипбука, его настройки и ссылку для общего доступа — меняется только сам PDF-файл.

Перед началом

• API-ключ — передаётся в заголовке X-Api-Key или как Authorization: Bearer YOUR_API_KEY в каждом запросе.
• Базовый URL: https://go.fliplink.me.
• Все три эндпоинта принимают параметр пути {flipbookId} — числовой ID флипбука, возвращаемый из create-by-file / create-by-url (как ID) или из list.
• Replace PDF (URL) и Duplicate отправляют свои тела как form-urlencoded (не JSON). Replace PDF (file) отправляет multipart form data.

Заменить PDF из файла

Multipart-загрузка. Сервер автоматически заново объединяет новый PDF с любой существующей передней/задней страницей, всё ещё прикреплённой к флипбуку. Флипбук сохраняет свой ID, настройки и ссылку для общего доступа.

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

Ответ:

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

Заменить PDF из URL

Заменяет PDF существующего флипбука на тот, что сервер скачивает по указанному вами URL. Флипбук сохраняет свой ID, настройки и ссылку для общего доступа.

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'

Ответ:

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

Дублировать флипбук

Создаёт одну или несколько серверных копий флипбука — каждая копия получает свой новый ID и URL для общего доступа. Count принимает 1–500 и ограничивается на стороне сервера.

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

Ответ:

{
  "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"
    }
  ]
}

Возможные ошибки

Replace PDF (файл) — PUT /api/replace-pdf/{flipbookId}:

• Отсутствующий или неверный API-ключ → HTTP 401. Возвращается HTML-страница 401 Unauthorized — тела JSON нет.
• ID элемента не найден или не принадлежит вашему ключу → HTTP 200 с Message: "Item not found".
• Загруженный файл не читается как PDF → HTTP 200 с Message: "File is not a valid PDF.".
• Загрузка превышает максимальный размер файла тарифа → HTTP 413 с Message: "File exceeds the maximum allowed upload size.".

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

• Отсутствующий или неверный API-ключ → HTTP 401. Возвращается HTML-страница 401 Unauthorized — тела JSON нет.
• ID элемента не найден или не принадлежит вашему ключу → HTTP 200 с Message: "Item not found".
• Неизвестное поле тела запроса или опечатка в нём → HTTP 200 с Message: "Unknown field(s) '…'. Expected: …".

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

• Отсутствующий или неверный API-ключ → HTTP 401. Возвращается HTML-страница 401 Unauthorized — тела JSON нет.
• ID элемента не найден или не принадлежит вашему ключу → HTTP 200 с Message: "Item not found".
• Неизвестное поле тела запроса или опечатка в нём → HTTP 200 с Message: "Unknown field(s) '…'. Expected: …".