API développeur · REST

Référence de l'API FlipLink

Crée des flipbooks et des documents, configure le lecteur, capture des leads et gère des domaines personnalisés — le tout par programmation. Authentifie-toi avec ta clé d'API et teste chaque endpoint en direct, depuis cette page.

URL de base https://go.fliplink.me

Obtenir une clé →

Introduction

L'API REST de FlipLink te permet de créer et de gérer des flipbooks et des documents par programmation — envoyer des PDF, configurer le lecteur, capturer des leads, gérer des domaines personnalisés et plus encore. Chaque endpoint est accessible sous l'URL de base ci-dessous et authentifié avec ta clé d'API.

URL de base
https://go.fliplink.me

Authentification

Envoie ta clé d'API à chaque requête. Deux styles d'en-tête sont pris en charge — utilise celui que ton client HTTP préfère :

En-têtes d'authentification
X-Api-Key: YOUR_API_KEY
# — or —
Authorization: Bearer YOUR_API_KEY

Une clé manquante ou invalide est rejetée avec un HTTP 401 (une page HTML « Unauthorized » — il n'y a pas de corps JSON, alors n'essaie pas d'en analyser un sur un 401). Une fois la clé valide, toute autre erreur revient en HTTP 200 avec Result: ERROR (voir ci-dessous). Garde ta clé secrète — ne l'expose jamais dans du code côté client que tu livres aux utilisateurs finaux.

Format de réponse et types de résultat

Toutes les réponses sont en JSON et portent un champ Result de premier niveau — il n'existe que deux valeurs :

  • "Result": "OK" — succès. Les endpoints de lecture ajoutent leur charge utile ; les endpoints d'écriture ajoutent un Message lisible (par exemple "Updated successfully") et create/duplicate renvoient le nouvel ID et l<code>URL</code>.
  • "Result": "ERROR" — échec, avec un Message expliquant pourquoi.

Important : seuls les échecs d'authentification (401), les envois trop volumineux (413) et la limitation de débit (429) utilisent un statut HTTP non-200. Tout le reste — validation, « introuvable », règles métier — renvoie un HTTP 200 avec Result: ERROR, alors vérifie Result, pas seulement le statut.

Pagination

Les endpoints de liste acceptent les paramètres de requête PageNo, PageSize et Offset. Omets-les pour des valeurs par défaut raisonnables.

Limites de débit

Chaque clé d'API est limitée à 300 requêtes par minute. La fenêtre est fixe et se réinitialise à la minute pleine (et non sur 60 secondes glissantes). Chaque réponse porte le budget courant dans ses en-têtes :

En-têtes de limite de débit
X-RateLimit-Limit: 300          # requests allowed per minute
X-RateLimit-Remaining: 287      # requests left in the current window
X-RateLimit-Reset: 1781962140   # Unix epoch (seconds) when the window resets

Lorsque tu dépasses la limite, tu reçois un HTTP 429. Attends jusqu'à X-RateLimit-Reset (ou applique un back-off et réessaie), et garde un œil sur X-RateLimit-Remaining pour rester sous le plafond.

Limites et quotas du forfait

Ton quota de flipbooks est renvoyé sur les réponses create et sur get-subscription-details sous la forme Flipbooks_Count / Flipbooks_Max / Flipbooks_Left. La taille d'envoi maximale est exposée via MaxFileSizeMB.

Erreurs

Conditions courantes que tu devrais gérer (chaque endpoint liste aussi les siennes ci-dessous) :

  • 401 — clé d'API manquante ou invalide (page HTML, pas de JSON)
  • 413 — l'envoi dépasse la taille de fichier maximale du forfait
  • 429 — débit limité ; applique un back-off et réessaie
  • 200 + Result:ERROR — tout le reste : introuvable ("Item not found"), validation ("Unknown field(s) …") ou une règle métier ("This custom URL is already in use…", "File is not a valid PDF")

Profil

Qui suis-je

Renvoie le compte propriétaire de la clé d'API — identifiants user/vendor, nom, e-mail, marque, URL de l'application et la taille d'envoi maximale du forfait (MaxFileSizeMB).

GEThttps://go.fliplink.me/api/whoami

Prérequis — aucun. C'est l'appel racine : il authentifie ta clé d'API, le prérequis de tous les autres endpoints.

Aucun paramètre.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/whoami
curl -X GET 'https://go.fliplink.me/api/whoami' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "UserID": "10000",
  "VendorID": "20000",
  "Name": "Your Account",
  "Email": "you@example.com",
  "Brand": "Fliplink",
  "AppURL": "go.fliplink.me",
  "MaxFileSizeMB": 150
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Récupérer le profil

Renvoie le profil du compte associé à la clé d'API — nom affiché, téléphone et URL de l'image de profil.

GEThttps://go.fliplink.me/api/get-profile
PrérequisQui suis-je(une clé d'API valide)Récupérer le profil

Aucun paramètre.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/get-profile
curl -X GET 'https://go.fliplink.me/api/get-profile' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Name": "Your Account",
  "Phone": "",
  "ProfileImage": ""
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Définir le profil (partiel)

Mise à jour partielle — les champs omis conservent leur valeur actuelle. Au moins un champ est requis.

PUThttps://go.fliplink.me/api/set-profile
PrérequisQui suis-je(une clé d'API valide)Définir le profil (partiel)

Paramètres du corps

Namepar exemple Mark Stevens
Phonephonepar exemple +14155550142
ProfileImageURLpar exemple https://...

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-profile
curl -X PUT 'https://go.fliplink.me/api/set-profile' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Name=Mark Stevens' \
  --data-urlencode 'Phone=+14155550142' \
  --data-urlencode 'ProfileImage=https://...'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres du corps

Abonnement et paiements

Récupérer les détails de l'abonnement

Renvoie ton forfait et ton quota actuels — nom du forfait, statut, frais, date de la prochaine facture, taille de fichier maximale, nombre maximal d'éléments/de CNAME et indicateurs de fonctionnalités.

GEThttps://go.fliplink.me/api/get-subscription-details
PrérequisQui suis-je(une clé d'API valide)Récupérer les détails de l'abonnement

Aucun paramètre.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/get-subscription-details
curl -X GET 'https://go.fliplink.me/api/get-subscription-details' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Subscription": {
    "BrandName": "",
    "Name": "Your Account",
    "Mobile": "",
    "SubscriptionPlan": "LTD Individual",
    "SubscriptionFees": "USD 39.00",
    "Tax": "",
    "SubscriptionID": "#20000",
    "ActiveFrom": "12 Jun 2026",
    "Status": "Active",
    "NextInvoice": "01 Jan 2050",
    "Email": "you@example.com",
    "PhotoIMG": "/Content/assetsNew/media/avatars/blank.png",
    "MaxFileSizeBytes": 157286400,
    "MaxFileSize": "150",
    "MaxCNAME": "Unlimited",
    "AdvancedSharing": "Yes",
    "LeadEmailVerification": "Yes",
    "IsLTD": "Yes",
    "MaxItems": "200"
  }
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Lister les paiements

Renvoie ton historique de facturation — chaque achat/renouvellement de forfait avec l'identifiant de commande, le montant, le forfait, la date et le nombre d'éléments.

GEThttps://go.fliplink.me/api/list-payments
PrérequisQui suis-je(une clé d'API valide)Lister les paiements

Aucun paramètre.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-payments
curl -X GET 'https://go.fliplink.me/api/list-payments' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "OrderID": "#10001",
      "Amount": "USD 39.00",
      "Plan": "LTD Individual / 822bf1b6",
      "Date": "12 Jun 2026",
      "DateIso": "2026-06-12T00:00:00+05:30",
      "InvoiceURL": "",
      "ItemCount": 100
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Éléments — Création

Créer à partir d'un fichier

Crée un flipbook (ou un document) à partir d'un PDF envoyé en multipart/form-data. Le fichier est stocké, une miniature est générée et l'enregistrement est créé.

Remarques
- Que tu obtiennes un Flipbook ou un Document dépend de l'en-tête Host de la requête — go.fliplink.me (par défaut) renvoie des Flipbooks, go.doclink.me renvoie des Documents.
- *_Count / *_Max / *_Left reflètent le quota de ton forfait après cette création.
- Utilise l'ID renvoyé pour les appels suivants (set-meta, set-cta-primary, save-as-template, etc.).
- La taille de fichier maximale dépend du forfait (voir MaxFileSizeMB dans who-am-i).

POSThttps://go.fliplink.me/api/create-by-file
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier

Corps (multipart/form-data)

Filefile
Namepar exemple My Document
Titlepar exemple My Title
DocTypeenumFlipbook ou Document. Sur go.doclink.me, toujours traité comme un Document.L'une des valeurs : Flipbook, Document

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Uploaded file is not a readable PDF{ "Result": "ERROR", "Message": "File is not a valid PDF." }
413Upload exceeds the plan's max file size{ "Result": "ERROR", "Message": "File exceeds the maximum allowed upload size." }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

POST/api/create-by-file
curl -X POST 'https://go.fliplink.me/api/create-by-file' \  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@/path/to/file' \
  -F 'Name=My Document' \
  -F 'Title=My Title' \
  -F 'DocType=Flipbook'
Exemple de réponse200 OK
{
  "Result": "OK",
  "ID": "90001",
  "URL": "https://go.fliplink.me/view/<slug>",
  "Flipbooks_Count": 12,
  "Flipbooks_Max": 200,
  "Flipbooks_Left": 188
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Corps (form-data)

Créer à partir d'une URL

Crée un flipbook (ou un document) à partir de l'URL d'un PDF. Le serveur télécharge FileURL, l'envoie sur S3, génère une miniature et crée l'enregistrement.

Remarques
- Le préfixe du nom de champ Flipbooks_* ou Documents_* dépend de l'en-tête Host de la requête — go.fliplink.me (par défaut) renvoie des Flipbooks, go.doclink.me renvoie des Documents.
- *_Count / *_Max / *_Left reflètent le quota du forfait du compte après cette création.
- L'URL source doit répondre en moins de 60 s — une source lente ou injoignable échoue avec Source URL timed out after 60s. Pour les sources peu fiables, préfère /api/create-by-file.

POSThttps://go.fliplink.me/api/create-by-url
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'une URL

Paramètres du corps

FileURLURLpar exemple https://example.com/document.pdf
Namepar exemple My Document
Titlepar exemple My Title
DocTypeenumpar exemple FlipbookL'une des valeurs : Flipbook, Document

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200FileURL host is private / not allowed{ "Result": "ERROR", "Message": "FileURL host is not allowed." }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

POST/api/create-by-url
curl -X POST 'https://go.fliplink.me/api/create-by-url' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'FileURL=https://example.com/document.pdf' \
  --data-urlencode 'Name=My Document' \
  --data-urlencode 'Title=My Title' \
  --data-urlencode 'DocType=Flipbook'
Exemple de réponse200 OK
{
  "Result": "OK",
  "ID": "90001",
  "URL": "https://go.fliplink.me/view/<slug>",
  "Flipbooks_Count": 12,
  "Flipbooks_Max": 200,
  "Flipbooks_Left": 188
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres du corps

Éléments — Lecture

Récupérer un élément

Renvoie l'enregistrement complet d'un seul flipbook/document par son ID — chaque colonne stockée : titre, URL, nombres de vues/leads/ventes, dossier et indicateurs de statut. L'enregistrement complet est renvoyé encapsulé dans un objet `Item` comptant environ 190 colonnes ; l'exemple ci-dessous en est un sous-ensemble abrégé et représentatif.

GEThttps://go.fliplink.me/api/get/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Récupérer un élément

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/get/{flipbookId}
curl -X GET 'https://go.fliplink.me/api/get/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Item": {
    "ID": 96216,
    "Name": "My Document",
    "Title": "My Title",
    "DocType": "Flipbook",
    "IsPublished": true,
    "Pages": 8,
    "Folder": "Marketing",
    "SkinName": "Light Wood",
    "CustomURL": "my-document-96216",
    "ValidTillDate": "",
    "NoOfViews": 42,
    "NoOfLeads": 3,
    "NoOfSales": 0,
    "IsForSale": false,
    "IsLeadCapture": true,
    "IsPasswordProtected": false,
    "BookLayout": 1,
    "ScrollBehaviour": 1,
    "IsRightToLeft": false,
    "CoverType": "1",
    "PageDepth": "1",
    "FullURL": "https://go.fliplink.me/view/8BDB015E-1C2A-4625-8EF6-81263AB98172",
    "EmbedURL": "https://go.fliplink.me/view/8BDB015E-1C2A-4625-8EF6-81263AB98172"
  }
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Rechercher par URL

Recherche un flipbook par son URL publique/de partage et renvoie son enregistrement complet (même structure que get).

GEThttps://go.fliplink.me/api/find-by-url
PrérequisQui suis-je(une clé d'API valide)Rechercher par URL

Paramètres de requête

URLURLURL complète du lecteur, URL de CNAME ou simplement le slug CustomURL brut. Le serveur prend le dernier segment du chemin comme slug.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/find-by-url
curl -X GET 'https://go.fliplink.me/api/find-by-url?URL=https%3A%2F%2Fgo.fliplink.me%2Fview%2F%3Cslug%3E' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Item": {
    "ID": 96216,
    "VendorID": "20000",
    "FilePDF": "/docs/20001/894abc58~demo_multipage.pdf",
    "Name": " coverage 20-Jun",
    "CreatedOn": "/Date(1781945608053)/",
    "NoOfViews": 1,
    "IsActive": true,
    "CustomURL": "your-flipbook-slug",
    "Title": "",
    "Description": " desc",
    "SkinID": -1,
    "LogoIMG": "",
    "LogoURL": "https://fliplink.me",
    "BackgroundIMG": "",
    "BackgroundDisplayFit": "",
    "BackgroundFillDirection": "",
    "ColorPanel": "#5A5F63",
    "ColorBackground": "#F2F2F2",
    "ColorLink": "#75869C",
    "FaviconIMG": "",
    "IsShare": true,
    "IsPrint": true,
    "IsDownload": false,
    "IsTextSelection": true,
    "IsThumbnails": true,
    "IsSound": false,
    "IsFullscreen": false,
    "IsZoom": false,
    "IsSearch": true,
    "IsPinnedThumbnails": false,
    "IsCTAButton": false,
    "CTAButtonText": "Buy",
    "CTAButtonColor": "#3366FF",
    "CTAButtonTextColor": "       ",
    "CTAButtonURL": "https://fliplink.me",
    "IsPasswordProtected": false,
    "Password": "",
    "IsLeadCapture": true,
    "LeadCaptureTitle": "",
    "IsLeadEmail": true,
    "IsLeadEmailMandatory": true,
    "IsLeadName": true,
    "IsLeadNameMandatory": false,
    "IsLeadPhone": false,
    "IsLeadPhoneMandatory": false,
    "IsLeadCompany": false,
    "IsLeadCompanyMandatory": false,
    "IsLeadDate": false,
    "IsLeadDateMandatory": false,
    "IsLeadCustom1": false,
    "IsLeadCustom1Mandatory": false,
    "Custom1Label": "",
    "IsLeadCustom2": false,
    "IsLeadCustom2Mandatory": false,
    "Custom2Label": "",
    "IsLeadPrivacyPolicy": false,
    "PrivacyPolicyURL": "",
    "IsLeadAllowSkip": true,
    "PageTurnMode": "Flip",
    "BookLayout": 1,
    "Shadowdepth": 1,
    "IsFixedZoomMode": false,
    "IsHardCover": false,
    "IsBookThickness": true,
    "IsLinkHighlight": true,
    "IsRightToLeft": false,
    "IMGPdf": "/Content/assets/media/users/no-image.png",
    "Pages": 8,
    "FacebookAnalyticsCode": "",
    "GoogleAnalyticsCode": "",
    "GoogleTagManager": "",
    "Folder": "-Folder",
    "PabblyWebhookURL_NewLead": "https://example.com/webhook-apitest",
    "TitleColor": "#3366FF",
    "CNAME": "",
    "IsNoIndex": false,
    "BackgroundMusic": "",
    "BackgroundMusicCustom": "",
    "AutoFlipInSecs": 0,
    "PwdTitle": "This is a private flipbook.\r\nTo view it, please enter the password.",
    "PwdPlaceholder": "Password",
    "PwdButton": "Submit",
    "LeadEmail": "Email",
    "LeadName": "Name",
    "LeadPhone": "Phone",
    "LeadCompany": "Company",
    "LeadDate": "Date",
    "LeadButton": "Submit",
    "SkinName": "Light Wood",
    "DocType": "Flipbook",
    "IsSendEmailOnView": false,
    "LeadFormAfterPages": 0,
    "CustomLoadingText": " loading",
    "IsShareButtons": true,
    "IsNotes": false,
    "IsCTAButton2": false,
    "CTAButtonText2": "More",
    "CTAButtonColor2": "#3366FF",
    "CTAButtonTextColor2": "       ",
    "CTAButtonURL2": "",
    "IsVerifyEmail": false,
    "IsVerifyMobile": false,
    "TwillioAPIKey": "",
    "IsShowControls": true,
    "NotificationsEmail": "antifragiletech@gmail.com",
    "GoogleSheetURL": "",
    "GoogleSheetIDKey": "",
    "GoogleSheetName": "",
    "PrivacyPolicyText": "",
    "PageDepth": "1",
    "CoverType": "1",
    "IsPublished": true,
    "LeadPhoneCountry": "",
    "LeadAfterPages": 0,
    "EmailsAllowed": "",
    "EmailVerifyTitleText": "antifragiletech@gmail.com",
    "EmailVerifyButtonText": "antifragiletech@gmail.com",
    "LeadSkipText": "",
    "OrdPos": 1,
    "IsStarred": false,
    "IsShowLogoMobile": true,
    "PreviewPDF": "",
    "IsForSale": false,
    "SaleCurr": "USD",
    "SaleAmount": 10,
    "SalePageTitle": "",
    "SaleAccessPageTitle": "",
    "SalePurchaseButtonText": "",
    "SaleButtonText": "",
    "SaleAccessButtonText": "",
    "SaleButtonColor": "#3366FF",
    "SaleGatewayName": "",
    "SaleGatewayKey": "",
    "SaleGatewaySecret": "",
    "EmailLeadSubject": "",
    "EmailLeadBody": " body",
    "EmailViewSubject": "antifragiletech@gmail.com",
    "EmailViewBody": "antifragiletech@gmail.com",
    "EmailSaleSubject": "antifragiletech@gmail.com",
    "EmailSaleBody": "antifragiletech@gmail.com",
    "TopLeft": "",
    "TopRight": "",
    "BottomLeft": "",
    "BottomRight": "",
    "IsCTAHiddenInPreview": false,
    "IsApprovalButton": false,
    "ApprovalButtonText": "Approve Document",
    "ApprovalButtonColor": "#000000",
    "ApprovalButtonTextColor": "#FFFFFF",
    "EmailApproveRequestSubject": "Document Approval Request: ##DOCUMENT_TITLE##",
    "EmailApproveRequestBody": "<p dir=\"ltr\" style=\"line-height: 1.38; margin-top: 0pt; margin-bottom: 0pt;\"><span style=\"color: #222222; font-family...",
    "EmailApproveRemindSubject": "Pending Document Approval: ##DOCUMENT_TITLE##",
    "EmailApproveRemindBody": "<p dir=\"ltr\" style=\"line-height: 1.38; margin-top: 0pt; margin-bottom: 0pt;\"><span style=\"color: #222222; font-family...",
    "EmailApproveSubmitSubject": "Document Approved: ##DOCUMENT_TITLE##",
    "EmailApproveSubmitBody": "<p>Hi,</p>\n<p>We are pleased to inform you that the following document has been approved:</p>\n<p>Name: <strong>##DOCU...",
    "IsBackgroundMusicLoop": false,
    "IsNavFirstLast": true,
    "IsShareFacebook": true,
    "IsShareTwitter": true,
    "IsShareWhatsApp": true,
    "IsShareTelegram": false,
    "IsShareLinkedIn": false,
    "IsSharePinterest": false,
    "IsShareReddit": false,
    "IsShareTumblr": false,
    "IsShareMessenger": false,
    "IsShareEmail": false,
    "IsShareLine": false,
    "IsShareWeChat": false,
    "IsShareInstagram": false,
    "IsShareFlipboard": false,
    "IsShareGeneral": false,
    "ScrollBehaviour": 1,
    "AIProvider": "",
    "AIKey": "",
    "IsVA": false,
    "VAButtonText": "",
    "VAButtonColor": "#3366FF",
    "VAButtonTextColor": "#3366FF",
    "VAText": "",
    "VAEmbeddings": "",
    "VAButtonStatus1": "0",
    "VAButtonStatus2": "0",
    "VAButtonStatus3": "0",
    "VAButtonStatus4": "0",
    "FrontPDF": "/docs/20001/f9496e75~dummy.pdf",
    "MiddlePDF": "/docs/20001/0b14ad4d~demo_multipage.pdf",
    "BackPDF": "/docs/20001/68504e6d~dummy.pdf",
    "URLPrefix": "https://go.fliplink.me/view/",
    "NoOfSales": 0,
    "WebhookURL_NewLead": "https://example.com/webhook-apitest",
    "CreatedOnIso": "2026-06-20T14:23:28+05:30"
  }
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Lister

Liste tes flipbooks/documents avec pagination (PageNo/PageSize). Chaque élément contient les identifiants, le titre, les URL, les nombres de vues/leads/ventes, le dossier et les indicateurs de statut.

GEThttps://go.fliplink.me/api/list
PrérequisQui suis-je(une clé d'API valide)Lister

Paramètres de requête

Folder
SearchText
PageNonumberpar exemple 1
PageSizenumberpar exemple 25
Offsetnumberpar exemple 0
SortByenumFacultatif. L'une des valeurs : `Name`, `DocType`, `CreatedOn`, `NoOfViews`, `NoOfLeads`. Vide = tri par défaut ; les valeurs inconnues reviennent au tri par défaut.L'une des valeurs : Name, DocType, CreatedOn, NoOfViews, NoOfLeads
SortOrderenumFacultatif. `ASC` ou `DESC`. Ignoré si SortBy est vide. Les valeurs inconnues reviennent silencieusement au tri par défaut.L'une des valeurs : ASC, DESC

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list
curl -X GET 'https://go.fliplink.me/api/list?Folder=%3CFolder%3E&SearchText=%3CSearchText%3E&PageNo=1&PageSize=25&Offset=0&SortBy=%3CSortBy%3E&SortOrder=%3CSortOrder%3E' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "ID": 93286,
      "Name": "INSPECT matrix Document - Copy 000",
      "Title": "MX Title",
      "CreatedOn": "Jun 12 2026  4:48PM",
      "CreatedOnIso": "2026-06-12T22:18:49.723+05:30",
      "CreatedDate": "Jun 12, 2026",
      "CreatedTime": " 4:48PM",
      "ValidTillDate": "",
      "NoOfViews": 0,
      "CustomURL": "0DF318DC-1CDB-4851-9620-76D3CB8F43C7",
      "Password": "",
      "FilePDF": "/docs/20001/0DF318DC~dummy.pdf",
      "NoOfLeads": 0,
      "NoOfSales": 0,
      "FullURL": "https://go.fliplink.me/view/0DF318DC-1CDB-4851-9620-76D3CB8F43C7",
      "EmbedURL": "https://go.fliplink.me/view/0DF318DC-1CDB-4851-9620-76D3CB8F43C7",
      "IMGPdf": "/Content/assets/media/users/no-image.png",
      "Pages": 0,
      "IsUnpublished": "",
      "Folder": "",
      "IsTemplate": false,
      "CNAMEMessage": "",
      "DocType": "Document",
      "DocTypeColor": "danger",
      "SSL": "No",
      "CompressDataKey": "",
      "Optimised": "",
      "IsPinnedThumbnails": true,
      "IsApprovalButton": true,
      "NoOfApprovals": 0,
      "FrontPDF": "/docs/20001/730d7569~dummy.pdf",
      "MiddlePDF": "/docs/20001/4b34cbea~dummy.pdf",
      "BackPDF": "/docs/20001/e4454ad1~dummy.pdf"
    }
  ],
  "TotalRecordCount": 14,
  "TotalItems": 14,
  "UserItems": 14,
  "PageSize": 10,
  "Capped": false
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Récupérer l'URL du PDF

Renvoie l'URL S3 publique du PDF principal de l'élément (version fusionnée si une couverture avant/arrière est ajoutée).

GEThttps://go.fliplink.me/api/get-pdf/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Récupérer l'URL du PDF

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/get-pdf/{flipbookId}
curl -X GET 'https://go.fliplink.me/api/get-pdf/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "URL": "https://<bucket>.s3.us-east-1.amazonaws.com/docs/<vendor>/<hash>~main.pdf"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Éléments — Modification

Dupliquer

Crée une ou plusieurs copies côté serveur d'un flipbook — chaque copie reçoit son propre nouvel ID et son URL de partage. Tu peux en dupliquer jusqu'à 20 à la fois (Count).

POSThttps://go.fliplink.me/api/duplicate/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Dupliquer

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

Countnumber1–500 (borné côté serveur)

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

POST/api/duplicate/{flipbookId}
curl -X POST 'https://go.fliplink.me/api/duplicate/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Count=3'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Count": 1,
  "Items": [
    {
      "ID": "93213",
      "URL": "https://go.fliplink.me/C73371B4-B041-4EBD-A518-1E5B5B56DA44"
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Remplacer le PDF (fichier)

Envoi en multipart. Refusionne automatiquement avec la couverture avant/arrière existante si elle est attachée.

PUThttps://go.fliplink.me/api/replace-pdf/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Remplacer le PDF (fichier)

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Corps (multipart/form-data)

Filefile

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Uploaded file is not a readable PDF{ "Result": "ERROR", "Message": "File is not a valid PDF." }
413Upload exceeds the plan's max file size{ "Result": "ERROR", "Message": "File exceeds the maximum allowed upload size." }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/replace-pdf/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/replace-pdf/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@/path/to/file'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Corps (form-data)

Remplacer le PDF (URL)

Remplace le PDF d'un flipbook existant par un PDF que le serveur télécharge depuis une URL que tu fournis. Le flipbook conserve son ID, ses réglages et son lien de partage.

PUThttps://go.fliplink.me/api/replace-pdf-by-url/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Remplacer le PDF (URL)

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

FileURLpar exemple https://example.com/new.pdf

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/replace-pdf-by-url/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/replace-pdf-by-url/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'File=https://example.com/new.pdf'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Enregistrer comme modèle (bascule)

Marque le flipbook comme modèle réutilisable (Status=true) ou le retire des modèles (Status=false). Les modèles apparaissent dans list-templates et peuvent servir de base à de nouveaux flipbooks.

PUThttps://go.fliplink.me/api/save-as-template/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Enregistrer comme modèle (bascule)

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

Statustrue | falsetrue/false. true par défaut si omis.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/save-as-template/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/save-as-template/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Status=true'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Saved as template"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Affecter à un dossier

Déplace le flipbook dans un dossier pour l'organiser. Les dossiers sont créés à la demande — affecte le flipbook à un nom de dossier qui n'existe pas encore et il est créé automatiquement (il n'y a pas d'appel « create folder » distinct). Envoie un champ Folder vide pour retirer le flipbook de son dossier. Un dossier n'existe que tant qu'au moins un flipbook s'y trouve : déplacer le dernier flipbook hors d'un dossier le fait disparaître de list-folders. Les noms de dossier peuvent contenir / (par exemple Marketing/Q2).

PUThttps://go.fliplink.me/api/assign-to-folder/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Affecter à un dossier

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

FolderNom du dossier où déplacer le flipbook — créé s'il n'existe pas (ou réutilise un nom de list-folders). Envoie une valeur vide pour annuler l'affectation.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/assign-to-folder/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/assign-to-folder/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Folder=Marketing/Q2'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Folder updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir la page de couverture/dos (fichier)

L'un des deux ou les deux (couverture/dos) sont facultatifs — au moins un est requis. Refusionne avec le PDF principal existant.

PUThttps://go.fliplink.me/api/set-front-back-page/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la page de couverture/dos (fichier)

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Corps (multipart/form-data)

Frontfile
Backfile

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Uploaded file is not a readable PDF{ "Result": "ERROR", "Message": "File is not a valid PDF." }
413Upload exceeds the plan's max file size{ "Result": "ERROR", "Message": "File exceeds the maximum allowed upload size." }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-front-back-page/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-front-back-page/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'Front=@/path/to/file' \
  -F 'Back=@/path/to/file'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Pages attached successfully",
  "URL": "https://<bucket>.s3.us-east-1.amazonaws.com/docs/<vendor>/<hash>~main.pdf"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Corps (form-data)

Définir la page de couverture/dos (URL)

Variante par URL de set-front-back-page — attache les pages de couverture/dos depuis l'URL d'un PDF distant au lieu d'un fichier envoyé.

PUThttps://go.fliplink.me/api/set-front-back-page-by-url/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la page de couverture/dos (URL)

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

FrontURLpar exemple https://example.com/front.pdf
BackURLpar exemple https://example.com/back.pdf

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-front-back-page-by-url/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-front-back-page-by-url/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Front=https://example.com/front.pdf' \
  --data-urlencode 'Back=https://example.com/back.pdf'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Pages attached successfully",
  "URL": "https://<bucket>.s3.us-east-1.amazonaws.com/docs/<vendor>/<hash>~main.pdf"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Supprimer la page de couverture/dos

Supprime l'habillage couverture/dos et restaure FilePDF au PDF principal sans habillage (MiddlePDF). Idempotent — un flipbook sans habillage renvoie OK sans rien modifier. Renvoie { Result, Message, URL (URL S3 du PDF principal) }. Les anciens objets S3 fusionnés/de couverture/de dos ne sont pas supprimés.

PUThttps://go.fliplink.me/api/clear-front-back-page/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Supprimer la page de couverture/dos

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/clear-front-back-page/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/clear-front-back-page/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Pages updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Définir/supprimer l'expiration

Définit ou supprime l'expiration automatique d'un flipbook. Envoie Days + Hours sous forme d'entiers ; Days=-1, Hours=0 supprime entièrement l'expiration.

PUThttps://go.fliplink.me/api/set-expiry/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir/supprimer l'expiration

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

DaysnumberUtilise -1 pour supprimer l'expiration
HoursnumberFacultatif, 0 par défaut

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-expiry/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-expiry/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Days=7' \
  --data-urlencode 'Hours=12'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir l'épinglage (bascule)

Épingle ou désépingle le flipbook (l'état favori) pour qu'il remonte en haut de ton tableau de bord.

PUThttps://go.fliplink.me/api/set-pin/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'épinglage (bascule)

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

AssociésLister
PUT/api/set-pin/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-pin/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Éléments — Suppression

Supprimer

Supprime définitivement l'enregistrement du flipbook en base de données. Remarque : les fichiers S3 sous-jacents ne sont PAS supprimés automatiquement.

DELETEhttps://go.fliplink.me/api/delete/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Supprimer

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

DELETE/api/delete/{flipbookId}
curl -X DELETE 'https://go.fliplink.me/api/delete/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Item has been deleted successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

CNAME (domaines personnalisés)

Ajouter un CNAME

Associe un domaine personnalisé (CNAME) déjà activé à un flipbook. Le domaine doit d'abord être ajouté et vérifié via le tableau de bord web (qui provisionne le DNS + le SSL) ; cet endpoint ne fait qu'enregistrer l'association — il ne vérifie pas le DNS et n'émet pas de certificat.

Conditions préalables :
- Le CNAME doit déjà exister sur ton compte (ajouté via le tableau de bord). Sinon : Please add CNAME <domain> to your account using the web dashboard. Only activated CNAMEs are allowed to be created via API.
- Il doit respecter la limite de CNAME de ton forfait.

Paramètres :
- CNAME (requis) — nom d'hôte complet, par exemple docs.example.com
- IsCloudflare (facultatif, 0 par défaut).

POSThttps://go.fliplink.me/api/add-cname/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Ajouter un CNAME

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

CNAMEpar exemple docs.example.com
IsCloudflaretrue | falseFacultatif. 0 (par défaut) ou 1. Indique 1 si ton DNS passe par le proxy de Cloudflare.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

POST/api/add-cname/{flipbookId}
curl -X POST 'https://go.fliplink.me/api/add-cname/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'CNAME=docs.example.com' \
  --data-urlencode 'IsCloudflare=0'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Lister les CNAME

Tous les CNAME personnalisés de l'appelant. Chaque élément : { CNAME, Documents (nombre de flipbooks actifs), FlipbookIDs ([...] des ID des flipbooks actifs liés à ce CNAME) }.

GEThttps://go.fliplink.me/api/list-cnames
PrérequisQui suis-je(une clé d'API valide)Lister les CNAME

Aucun paramètre.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-cnames
curl -X GET 'https://go.fliplink.me/api/list-cnames' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "CNAME": "ttr.antifragile.ae",
      "Documents": 1,
      "FlipbookIDs": [
        93270
      ]
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Supprimer un CNAME

Retire l'association d'un domaine personnalisé (CNAME) de l'un ou de tous tes flipbooks. Deux modes :

  • En masse (par défaut) : passe CNAME=<host> et laisse FlipbookID vide — retire ce CNAME de tous les flipbooks que tu possèdes.
  • Par flipbook : passe FlipbookID=<id> — le CNAME est récupéré depuis ce flipbook. À utiliser pour une action « Supprimer le CNAME » par ligne.

Réponse (par flipbook) : { "Result": "OK", "Message": "CNAME removed from flipbook successfully" }
Réponse (en masse) : { "Result": "OK", "Message": "CNAME removed successfully" }
Les deux manquants : { "Result": "ERROR", "Message": "CNAME or FlipbookID is required" }

Remarque : passe le CNAME en paramètre de requête (et non en segment d'URL) pour éviter les problèmes liés aux points dans le nom d'hôte.

DELETEhttps://go.fliplink.me/api/delete-cname
PrérequisQui suis-je(une clé d'API valide)Lister les CNAME(trouve le CNAME / FlipbookID)Supprimer un CNAME

Paramètres de requête

CNAMERequis en mode EN MASSE (retire le CNAME de tous les flipbooks que tu possèdes). Ignoré lorsque FlipbookID > 0 — le CNAME est alors pris dans ce flipbook.
FlipbookIDnumberFacultatif. Passe un ID de flipbook > 0 pour retirer le CNAME de CE flipbook uniquement (mode par flipbook). Laisse vide/omets/0 pour le mode en masse (retrait sur tous).

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

DELETE/api/delete-cname
curl -X DELETE 'https://go.fliplink.me/api/delete-cname?CNAME=docs.example.com&FlipbookID=%3CFlipbookID%3E' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Deleted successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Dossiers

Lister les dossiers

Liste tes dossiers, chacun sous la forme { Folder (nom), URL (un GUID de dossier) }. Les dossiers sont dérivés des affectations de flipbooks (créées via assign-to-folder), donc un dossier vide n'est pas listé. Les noms de dossier alimentent assign-to-folder (pour placer un flipbook) et set-team-member (pour restreindre l'accès d'un membre d'équipe).

GEThttps://go.fliplink.me/api/list-folders
PrérequisQui suis-je(une clé d'API valide)Lister les dossiers

Aucun paramètre.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-folders
curl -X GET 'https://go.fliplink.me/api/list-folders' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "Folder": "Marketing",
      "URL": "00000000-0000-0000-0000-000000000001"
    },
    {
      "Folder": "Marketing/Q2",
      "URL": "00000000-0000-0000-0000-000000000002"
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Membres de l'équipe

Lister les membres de l'équipe

Liste les membres de l'équipe (utilisateurs vendor) de ton compte avec leurs détails d'accès, y compris les dossiers affectés à chaque membre. Les mots de passe ne sont jamais renvoyés. Filtre avec IsActive.

GEThttps://go.fliplink.me/api/list-team-members
PrérequisQui suis-je(une clé d'API valide)Lister les membres de l'équipe

Paramètres de requête

IsActivetrue | false1=actifs (par défaut), 0=inactifs

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-team-members
curl -X GET 'https://go.fliplink.me/api/list-team-members?IsActive=1' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "ID": 45452,
      "Name": "Jane Doe",
      "Email": "member@example.com",
      "IsActive": "True",
      "PhotoIMG": "",
      "Total": 0
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Récupérer un membre de l'équipe

Renvoie un seul membre de l'équipe par son ID de membre (l'ID de list-team-members) — nom, e-mail, statut actif et les dossiers auxquels le membre est affecté. Un membre de l'équipe est limité aux dossiers définis via set-team-member (le champ Folders), donc il ne peut accéder qu'aux flipbooks situés dans ces dossiers. Les mots de passe ne sont jamais renvoyés. Le memberId est l'ID du membre de l'équipe (de List Team Members) — et non un ID de flipbook ; passer un ID de flipbook renvoie « Team member not found ». Le membre est renvoyé encapsulé dans un objet Item ; Folders est une liste, séparée par des virgules, des dossiers auxquels il peut accéder (vide = aucune restriction de dossier).

GEThttps://go.fliplink.me/api/get-team-member/{memberId}
PrérequisQui suis-je(une clé d'API valide)Définir un membre de l'équipe (créer ou mettre à jour)(crée d'abord un membre)Récupérer un membre de l'équipe

Paramètres de chemin

memberIdnumberID du membre de l'équipe (de list-team-members). PAS un ID de flipbook.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200No team member with that ID (e.g. you passed a flipbook ID){ "Result": "ERROR", "Message": "Team member not found" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/get-team-member/{memberId}
curl -X GET 'https://go.fliplink.me/api/get-team-member/{memberId}' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Item": {
    "ID": 45452,
    "Email": "member@example.com",
    "Name": "Jane Doe",
    "Phone": "",
    "PhotoIMG": "",
    "IsEmailVerified": false,
    "Folders": "Marketing,Sales"
  }
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Définir un membre de l'équipe (créer ou mettre à jour)

Crée un nouveau membre de l'équipe (utilisateur vendor) ou met à jour un membre existant — pour contrôler qui peut accéder à ton compte et, via le champ Folders, les dossiers auxquels il est limité (un membre ne voit que les flipbooks situés dans ses dossiers affectés). Une entrée de journal d'audit est écrite en cas de succès.

Erreurs courantes : le nom du membre est un unique champ Name — il n'y a pas de FirstName/LastName. Folders est une liste séparée par des virgules de noms de dossiers issus de List Folders (par exemple Marketing,Sales) ; laisse-la vide pour aucune restriction de dossier. La création d'un membre renvoie { Result:"OK", Message:"Team member created" } (le chemin de mise à jour — lorsque ID est fourni — renvoie « Updated successfully »). L'e-mail du membre ne doit pas déjà appartenir à un utilisateur FlipLink, et les e-mails avec alias + sont refusés.

POSThttps://go.fliplink.me/api/set-team-member
PrérequisQui suis-je(une clé d'API valide)Lister les dossiers(noms pour la portée Folders)Définir un membre de l'équipe (créer ou mettre à jour)

Paramètres du corps

Namepar exemple Jane
Emailemailpar exemple jane@example.com
IDnumberOmets ou -1 pour créer. >0 pour mettre à jour.
PasswordEn clair ; chiffré côté serveur. Vide lors d'une mise à jour conserve la valeur existante.
ProfileImageURL
FoldersDossiers auxquels ce membre est limité — une liste délimitée de noms de dossiers (de list-folders). Le membre ne peut accéder qu'aux flipbooks situés dans ces dossiers.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

POST/api/set-team-member
curl -X POST 'https://go.fliplink.me/api/set-team-member' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Name=Jane' \
  --data-urlencode 'Email=jane@example.com' \
  --data-urlencode 'ID=-1' \
  --data-urlencode 'Password=<Password>' \
  --data-urlencode 'ProfileImage=<ProfileImage>' \
  --data-urlencode 'Folders=<Folders>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Team member created"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres du corps

Définir un membre de l'équipe comme actif

Active ou désactive un membre de l'équipe, déterminant s'il peut se connecter et accéder au compte.

PUThttps://go.fliplink.me/api/set-team-member-active/{memberId}
PrérequisQui suis-je(une clé d'API valide)Définir un membre de l'équipe (créer ou mettre à jour)(crée d'abord un membre)Définir un membre de l'équipe comme actif

Paramètres de chemin

memberIdnumberID du membre de l'équipe (de list-team-members). PAS un ID de flipbook.

Paramètres du corps

IsActivetrue | falsepar exemple true

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-team-member-active/{memberId}
curl -X PUT 'https://go.fliplink.me/api/set-team-member-active/{memberId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsActive=true'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Supprimer un membre de l'équipe

Suppression logique (désactivation). Les membres de l'équipe ne sont jamais supprimés physiquement — cela désactive le membre (un alias REST de set-team-member-active avec IsActive=false). Leur historique de paiement et leurs références d'audit restent intacts, et ils peuvent être réactivés plus tard via PUT /api/set-team-member-active (IsActive=true).

Réponse : { "Result": "OK", "Message": "Team member deactivated" }.

DELETEhttps://go.fliplink.me/api/delete-team-member/{memberId}
PrérequisQui suis-je(une clé d'API valide)Définir un membre de l'équipe (créer ou mettre à jour)(crée d'abord un membre)Supprimer un membre de l'équipe

Paramètres de chemin

memberIdnumberID du membre de l'équipe (de list-team-members). PAS un ID de flipbook.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

DELETE/api/delete-team-member/{memberId}
curl -X DELETE 'https://go.fliplink.me/api/delete-team-member/{memberId}' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Team member deactivated"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Leads et ventes

Lister les leads

Liste les soumissions de capture de leads collectées par tes flipbooks. Renvoie Items[] plus un schéma dynamique Columns[] (pour afficher un tableau) et TotalRecordCount. Prend en charge la pagination et l'export CSV via IsDownload.

GEThttps://go.fliplink.me/api/list-leads
PrérequisQui suis-je(une clé d'API valide)Lister les leads

Paramètres de requête

ItemIDsID de flipbooks séparés par des virgules OU des barres verticales (vide = tous)
SearchText
PageNonumberpar exemple 1
Offsetnumberpar exemple 0
IsDownloadtrue | falsepar exemple true

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-leads
curl -X GET 'https://go.fliplink.me/api/list-leads?ItemIDs=%3CItemIDs%3E&SearchText=%3CSearchText%3E&PageNo=1&Offset=0&IsDownload=true' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [],
  "Columns": [
    {
      "ID": 1,
      "data": "ID",
      "title": "ID",
      "type": "numeric",
      "hidden": true,
      "readOnly": true,
      "defaultValue": "",
      "source": "",
      "width": 0,
      "backgroundColor": "",
      "align": "left"
    }
  ],
  "TotalRecordCount": 0
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Lister les ventes

Liste les enregistrements de vente/achat de tes flipbooks (e-mail de l'acheteur, flipbook, montant, date) plus les définitions de colonnes du tableau des ventes. Prend en charge la pagination et l'export CSV via IsDownload.

GEThttps://go.fliplink.me/api/list-sales
PrérequisQui suis-je(une clé d'API valide)Lister les ventes

Paramètres de requête

ItemIDs
SearchText
PageNonumberpar exemple 1
Offsetnumberpar exemple 0
IsDownloadtrue | falsepar exemple true
IsAbandonedtrue | falsetrue → renvoie les ventes de panier abandonné au lieu des ventes finalisées

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-sales
curl -X GET 'https://go.fliplink.me/api/list-sales?ItemIDs=%3CItemIDs%3E&SearchText=%3CSearchText%3E&PageNo=1&Offset=0&IsDownload=true&IsAbandoned=false' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [],
  "Columns": [
    {
      "ID": 1,
      "data": "ID",
      "title": "ID",
      "type": "numeric",
      "hidden": true,
      "readOnly": true,
      "defaultValue": "",
      "source": "",
      "width": 0,
      "backgroundColor": "",
      "align": "left"
    }
  ],
  "TotalRecordCount": 0
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Supprimer un lead

Supprime un seul lead capturé par son ID. Le segment de chemin est le leadId ; passe aussi l'Email du lead et son FlipbookID en paramètres de requête.

DELETEhttps://go.fliplink.me/api/delete-lead/{leadId}
PrérequisQui suis-je(une clé d'API valide)Lister les leads(récupère un ID de lead)Supprimer un lead

Paramètres de chemin

leadIdnumberL'ID du lead (le LeadID de list-leads).

Paramètres de requête

Emailemailpar exemple foo@example.com
FlipbookIDnumberpar exemple {{flipbookId}}

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

DELETE/api/delete-lead/{leadId}
curl -X DELETE 'https://go.fliplink.me/api/delete-lead/{leadId}?Email=foo%40example.com&FlipbookID=%7B%7BflipbookId%7D%7D' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Deleted successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres de requête

Supprimer des leads (en masse)

Supprime des leads en masse selon un filtre. Au moins UN des paramètres FlipbookID/Email/DateFrom/DateTo est REQUIS — un appel sans filtre est refusé (il n'y a pas de « tout supprimer »). Toujours limité au vendor. Renvoie { Result, Deleted (nombre) }. Nettoie aussi les lignes enfants (journal des vues / clics sur CTA / journal d'export de feuille).

DELETEhttps://go.fliplink.me/api/delete-leads
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(restreins par FlipbookID)Supprimer des leads (en masse)

Paramètres de requête

FlipbookIDnumberFacultatif. Supprime uniquement les leads de ce flipbook.
EmailemailFacultatif. Correspondance EXACTE de l'e-mail.
DateFromFacultatif. Supprime les leads capturés à partir de cette date (correspond à Lead.CreatedOn). Toute date analysable, par exemple 2026-01-01 ou 2026-01-01T00:00:00Z.
DateToFacultatif. Supprime les leads capturés jusqu'à cette date incluse.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

DELETE/api/delete-leads
curl -X DELETE 'https://go.fliplink.me/api/delete-leads?FlipbookID=%7B%7BflipbookId%7D%7D&Email=%3CEmail%3E&DateFrom=%3CDateFrom%3E&DateTo=%3CDateTo%3E' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Deleted": 12,
  "Message": "12 lead(s) deleted."
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Définir l'achat d'un flipbook

Enregistre une vente (un achat) finalisée d'un flipbook — utilise-le pour consigner des achats effectués via ton propre flux de paiement, sans passer par le paiement Stripe de FlipLink.

Paramètre de chemin : {flipbookId} — le flipbook marqué comme acheté.

Corps (urlencoded) :
- Email — e-mail de l'acheteur (requis)
- PaymentRef — la référence de ta passerelle de paiement, par exemple un identifiant Stripe PaymentIntent (requis)

Réponse (succès) : { "Result": "OK", "Message": "Purchase recorded successfully" }
Réponse (erreur) : { "Result": "ERROR", "Message": "Email is required." } / "PaymentRef is required."

Erreurs courantes : envoie PaymentRef ; n'envoie PAS Amount/Currency — ces valeurs sont dérivées côté serveur à partir de ta référence de paiement.

POSThttps://go.fliplink.me/api/set-flipbook-purchase/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'achat d'un flipbook

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

EmailemailAdresse e-mail de l'acheteur (requis).
PaymentRefRéférence du payment-intent de la passerelle (requis). Pour Stripe, il s'agit de l'identifiant PaymentIntent (`pi_...`).

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

POST/api/set-flipbook-purchase/{flipbookId}
curl -X POST 'https://go.fliplink.me/api/set-flipbook-purchase/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Email=customer@example.com' \
  --data-urlencode 'PaymentRef=pi_3O1234567890abcdef'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Purchase recorded successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Recherches

Lister les modèles

Liste les modèles de flipbook réutilisables enregistrés sur ton compte. Filtre par DocType (0 = tous). Utilise l'ID d'un modèle avec save-as-template / les flux de création.

GEThttps://go.fliplink.me/api/list-templates
PrérequisQui suis-je(une clé d'API valide)Lister les modèles

Paramètres de requête

DocTypenumber0 = Flipbook (par défaut), 1 = Document

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-templates
curl -X GET 'https://go.fliplink.me/api/list-templates?DocType=0' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "ID": -1,
      "Name": "- Blank Template - "
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Lister les habillages

Liste les habillages/thèmes de lecteur disponibles ; chaque ligne porte l'URL de l'arrière-plan fourni avec l'habillage. Utilise le nom d'un habillage avec set-skin.

GEThttps://go.fliplink.me/api/list-skins
PrérequisQui suis-je(une clé d'API valide)Lister les habillages

Paramètres de requête

Typetrue | false0=habillages de Flipbook, 1=habillages de Document

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-skins
curl -X GET 'https://go.fliplink.me/api/list-skins?Type=false' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "ID": -1,
      "Name": "Light Wood",
      "ImageURL": "https://af203091.s3.us-east-1.amazonaws.com/docs/background/1.webp",
      "ThumbURL": "https://af203091.s3.us-east-1.amazonaws.com/docs/background/thumb/1.webp"
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de requête

Lister les devises

Liste les devises disponibles pour vendre un flipbook (pour les réglages de vente/de paiement).

GEThttps://go.fliplink.me/api/list-currencies
PrérequisQui suis-je(une clé d'API valide)Lister les devises

Aucun paramètre.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-currencies
curl -X GET 'https://go.fliplink.me/api/list-currencies' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "Name": "AED"
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Lister les musiques de fond

Liste les pistes de musique de fond intégrées que tu peux attacher au lecteur d'un flipbook.

GEThttps://go.fliplink.me/api/list-background-music
PrérequisQui suis-je(une clé d'API valide)Lister les musiques de fond

Aucun paramètre.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

GET/api/list-background-music
curl -X GET 'https://go.fliplink.me/api/list-background-music' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Items": [
    {
      "Name": "None",
      "FileURL": ""
    }
  ]
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Sections — Image de marque et contenu

Définir les métadonnées

Définit le titre et les métadonnées SEO du flipbook — Title, Description, TitleColor et l'indicateur IsPublished.

Remarque : cela écrase Title/Description/TitleColor. Pour ne changer que l'état de publication, utilise set-published.

PUThttps://go.fliplink.me/api/set-meta/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir les métadonnées

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

Title
Description
TitleColor
IsPublishedtrue | falsepar exemple false

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-meta/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-meta/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Title=<Title>' \
  --data-urlencode 'Description=<Description>' \
  --data-urlencode 'TitleColor=<TitleColor>' \
  --data-urlencode 'IsPublished=false'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir la publication (publier / dépublier)

Publie ou dépublie le flipbook — bascule UNIQUEMENT l'indicateur de publication, en laissant Title/Description/TitleColor intacts (contrairement à set-meta). Utilise-le pour (re)publier un flipbook, par exemple un flipbook revenu dépublié de create-by-file.

PUThttps://go.fliplink.me/api/set-published/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la publication (publier / dépublier)

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsPublishedtrue | falsetrue/1 = publier, false/0 = dépublier (requis).

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-published/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-published/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPublished=true'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir l'habillage

Applique un habillage/thème de lecteur au flipbook ; le serveur résout le nom de l'habillage vers son ID.

Erreurs courantes : le champ est SkinName (la chaîne issue de list-skins), pas un ID numérique.

PUThttps://go.fliplink.me/api/set-skin/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Lister les habillages(choisis un SkinName)Définir l'habillage

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

SkinNameDe /api/list-skins → colonne Name

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-skin/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-skin/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'SkinName=<SkinName>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir l'image d'arrière-plan

Définit l'image d'arrière-plan du lecteur à partir d'une URL que tu fournis (il n'y a pas de galerie intégrée).

PUThttps://go.fliplink.me/api/set-background-image/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'image d'arrière-plan

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

BackgroundIMGURLURL de l'image OU URL d'espace réservé comme https://plchldr.co/i/100x100?text=&bg=HEX

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-background-image/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-background-image/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'BackgroundIMG=<BackgroundIMG>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le favicon

Définit le favicon (l'icône de l'onglet du navigateur) utilisé par la page du lecteur hébergé du flipbook.

PUThttps://go.fliplink.me/api/set-favicon/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le favicon

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

FaviconIMGURL

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-favicon/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-favicon/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'FaviconIMG=<FaviconIMG>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir l'apparence des pages

Configure l'apparence des pages du lecteur — arrière-plan, ombre de page, espacement et autres options de présentation. Les valeurs sont stockées telles quelles ; les éléments plus anciens peuvent renvoyer d'autres valeurs (par exemple regular, ou le nombre 1) à la relecture via Get one.

PUThttps://go.fliplink.me/api/set-page-appearance/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'apparence des pages

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

PageDepthenumflat | thin | thickL'une des valeurs : flat, thin, thick
CoverTypeenumsoft | hardL'une des valeurs : soft, hard

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-page-appearance/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-page-appearance/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'PageDepth=thin' \
  --data-urlencode 'CoverType=soft'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le texte de chargement

Définit le texte personnalisé affiché sur l'écran de chargement du lecteur.

Erreurs courantes : le champ est CustomLoadingText, pas LoadingText.

PUThttps://go.fliplink.me/api/set-loading-text/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le texte de chargement

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

CustomLoadingText

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-loading-text/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-loading-text/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'CustomLoadingText=<CustomLoadingText>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir l'URL personnalisée

Définit le slug personnalisé (vanity) de l'URL de partage du flipbook. Il doit être unique ; un slug déjà utilisé renvoie Result:ERROR.

PUThttps://go.fliplink.me/api/set-custom-url/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'URL personnalisée

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

CustomURL

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Custom URL already taken{ "Result": "ERROR", "Message": "This custom URL is already in use. Please choose another." }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-custom-url/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-custom-url/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'CustomURL=<CustomURL>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le PDF d'aperçu

Définit le PDF d'aperçu montré aux lecteurs avant la capture de lead / le paiement. Effacé automatiquement si la capture de leads et le mode vente sont tous deux désactivés.

PUThttps://go.fliplink.me/api/set-preview-pdf/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le PDF d'aperçu

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

PreviewPDFURL

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-preview-pdf/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-preview-pdf/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'PreviewPDF=<PreviewPDF>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le PDF d'image

Définit le PDF d'image uniquement/d'aperçu utilisé pour les miniatures et les aperçus. Envoie une valeur vide pour conserver le PDF d'image existant.

PUThttps://go.fliplink.me/api/set-image-pdf/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le PDF d'image

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IMGPdfURL

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-image-pdf/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-image-pdf/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IMGPdf=<IMGPdf>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — Lecteur et lecture

Définir les contrôles du lecteur

Affiche ou masque chaque bouton de la barre d'outils du lecteur (téléchargement, impression, partage, plein écran, zoom, miniatures, etc.).

PUThttps://go.fliplink.me/api/set-viewer-controls/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir les contrôles du lecteur

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsShowControlstrue | falsepar exemple true
IsPrinttrue | falsepar exemple false
IsDownloadtrue | falsepar exemple false
IsThumbnailstrue | falsepar exemple true
IsSearchtrue | falsepar exemple true
IsSoundtrue | falsepar exemple true
IsFullscreentrue | falsepar exemple true
IsZoomtrue | falsepar exemple true
IsNotestrue | falsepar exemple false

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-viewer-controls/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-viewer-controls/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsShowControls=true' \
  --data-urlencode 'IsPrint=false' \
  --data-urlencode 'IsDownload=false' \
  --data-urlencode 'IsThumbnails=true' \
  --data-urlencode 'IsSearch=true' \
  --data-urlencode 'IsSound=true' \
  --data-urlencode 'IsFullscreen=true' \
  --data-urlencode 'IsZoom=true' \
  --data-urlencode 'IsNotes=false'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir la navigation de lecture

Configure la navigation dans le lecteur — miniatures de pages, table des matières et la façon dont les lecteurs passent d'une page à l'autre.

PUThttps://go.fliplink.me/api/set-reader-navigation/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la navigation de lecture

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsNavFirstLasttrue | falsepar exemple true
BookLayoutenum1=simple, 2=doubleL'une des valeurs : 1, 2
IsRightToLefttrue | falsepar exemple false
ScrollBehaviournumberMode de défilement (code numérique)

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-reader-navigation/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-reader-navigation/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsNavFirstLast=true' \
  --data-urlencode 'BookLayout=1' \
  --data-urlencode 'IsRightToLeft=false' \
  --data-urlencode 'ScrollBehaviour=1'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le tournage automatique

Active ou désactive le tournage automatique des pages dans le lecteur ainsi que son intervalle.

PUThttps://go.fliplink.me/api/set-auto-flip/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le tournage automatique

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

AutoFlipInSecsnumberEn MILLISECONDES malgré le nom. 0 = désactivé, 3000 = 3 s, 5000 = 5 s, etc.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-auto-flip/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-auto-flip/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'AutoFlipInSecs=0'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir la musique de fond

Définit ou efface la piste de musique de fond qui se joue dans le lecteur. Voir list-background-music pour les pistes disponibles.

PUThttps://go.fliplink.me/api/set-background-music/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Lister les musiques de fond(choisis une piste)Définir la musique de fond

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

BackgroundMusicNom de fichier d'une piste prédéfinie (de /api/list-background-music)
BackgroundMusicCustomURLURL d'une musique personnalisée envoyée
IsBackgroundMusicLooptrue | falsepar exemple false

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-background-music/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-background-music/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'BackgroundMusic=<BackgroundMusic>' \
  --data-urlencode 'BackgroundMusicCustom=<BackgroundMusicCustom>' \
  --data-urlencode 'IsBackgroundMusicLoop=false'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — CTA

Définir le CTA principal

Configure le bouton d'appel à l'action principal du lecteur (libellé, URL, position, couleur).

Erreurs courantes : les champs sont IsCTAButton, CTAButtonText, CTAButtonURL (plus la position/couleur) — pas Text/URL/Position.

PUThttps://go.fliplink.me/api/set-cta-primary/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le CTA principal

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsCTAButtontrue | falsepar exemple false
CTAButtonText
CTAButtonColor
CTAButtonURLURLLes préfixes mailto: / tel: sont normalisés automatiquement côté serveur
CTAButtonTextColor

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-cta-primary/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-cta-primary/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsCTAButton=false' \
  --data-urlencode 'CTAButtonText=<CTAButtonText>' \
  --data-urlencode 'CTAButtonColor=<CTAButtonColor>' \
  --data-urlencode 'CTAButtonURL=<CTAButtonURL>' \
  --data-urlencode 'CTAButtonTextColor=<CTAButtonTextColor>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le CTA secondaire

Configure le bouton d'appel à l'action secondaire du lecteur.

Erreurs courantes : le bouton secondaire utilise les champs suffixés par 2IsCTAButton2, CTAButtonText2, CTAButtonURL2.

PUThttps://go.fliplink.me/api/set-cta-secondary/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le CTA secondaire

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsCTAButton2true | falsepar exemple false
CTAButtonText2
CTAButtonColor2
CTAButtonTextColor2
CTAButtonURL2URL

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-cta-secondary/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-cta-secondary/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsCTAButton2=false' \
  --data-urlencode 'CTAButtonText2=<CTAButtonText2>' \
  --data-urlencode 'CTAButtonColor2=<CTAButtonColor2>' \
  --data-urlencode 'CTAButtonTextColor2=<CTAButtonTextColor2>' \
  --data-urlencode 'CTAButtonURL2=<CTAButtonURL2>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir les règles d'aperçu du CTA

Configure le moment où l'appel à l'action est montré aux lecteurs — par exemple après N pages ou N secondes (les règles de la barrière d'aperçu).

PUThttps://go.fliplink.me/api/set-cta-preview-rules/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir les règles d'aperçu du CTA

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsCTAHiddenInPreviewtrue | falsepar exemple false

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-cta-preview-rules/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-cta-preview-rules/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsCTAHiddenInPreview=false'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — Contrôle d'accès

Définir l'accès par mot de passe

Active/désactive la protection par mot de passe du flipbook et définit le mot de passe d'accès.

PUThttps://go.fliplink.me/api/set-password-access/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'accès par mot de passe

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsPasswordProtectedtrue | falsepar exemple false
Password
PwdTitle
PwdPlaceholder
PwdButton

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-password-access/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-password-access/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPasswordProtected=false' \
  --data-urlencode 'Password=<Password>' \
  --data-urlencode 'PwdTitle=<PwdTitle>' \
  --data-urlencode 'PwdPlaceholder=<PwdPlaceholder>' \
  --data-urlencode 'PwdButton=<PwdButton>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir l'indexation

Contrôle l'indexation par les moteurs de recherche du flipbook hébergé. IsNoIndex=true ajoute un noindex robots pour que la page ne soit pas indexée.

PUThttps://go.fliplink.me/api/set-indexing/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'indexation

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsNoIndextrue | falsepar exemple false

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-indexing/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-indexing/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsNoIndex=false'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir la liste d'e-mails autorisés

Restreint l'accès au lecteur à une liste d'adresses e-mail autorisées (lecture restreinte).

PUThttps://go.fliplink.me/api/set-email-allow-list/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la liste d'e-mails autorisés

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

EmailsAllowedListe délimitée d'e-mails autorisés

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-email-allow-list/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-email-allow-list/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailsAllowed=<EmailsAllowed>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — Capture de leads

Définir la capture de leads (base)

Active et configure le formulaire de capture de leads de base (la barrière qui recueille les coordonnées du lecteur avant la lecture).

Erreurs courantes : l'indicateur d'activation est IsLeadCapture, pas IsEnabled.

PUThttps://go.fliplink.me/api/set-lead-capture/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la capture de leads (base)

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsLeadCapturetrue | falsepar exemple false
LeadCaptureTitle
IsLeadAllowSkiptrue | falsepar exemple false
LeadSkipText
LeadFormAfterPagesnumberpar exemple 0
LeadAfterPagesnumberpar exemple 0

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-lead-capture/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-lead-capture/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsLeadCapture=false' \
  --data-urlencode 'LeadCaptureTitle=<LeadCaptureTitle>' \
  --data-urlencode 'IsLeadAllowSkip=false' \
  --data-urlencode 'LeadSkipText=<LeadSkipText>' \
  --data-urlencode 'LeadFormAfterPages=0' \
  --data-urlencode 'LeadAfterPages=0'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir les champs de lead

Active/désactive chaque champ standard de capture de leads (nom, e-mail, téléphone, société, etc.) et indique s'il est obligatoire.

PUThttps://go.fliplink.me/api/set-lead-fields/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la capture de leads (base)(active la capture de leads)Définir les champs de lead

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsLeadEmailtrue | falsepar exemple true
IsLeadEmailMandatorytrue | falsepar exemple true
IsLeadNametrue | falsepar exemple true
IsLeadNameMandatorytrue | falsepar exemple false
IsLeadPhonetrue | falsepar exemple false
IsLeadPhoneMandatorytrue | falsepar exemple false
IsLeadCompanytrue | falsepar exemple false
IsLeadCompanyMandatorytrue | falsepar exemple false
IsLeadDatetrue | falsepar exemple false
IsLeadDateMandatorytrue | falsepar exemple false
LeadPhoneCountry

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-lead-fields/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-lead-fields/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsLeadEmail=true' \
  --data-urlencode 'IsLeadEmailMandatory=true' \
  --data-urlencode 'IsLeadName=true' \
  --data-urlencode 'IsLeadNameMandatory=false' \
  --data-urlencode 'IsLeadPhone=false' \
  --data-urlencode 'IsLeadPhoneMandatory=false' \
  --data-urlencode 'IsLeadCompany=false' \
  --data-urlencode 'IsLeadCompanyMandatory=false' \
  --data-urlencode 'IsLeadDate=false' \
  --data-urlencode 'IsLeadDateMandatory=false' \
  --data-urlencode 'LeadPhoneCountry=<LeadPhoneCountry>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir les champs de lead personnalisés

Définit des champs personnalisés supplémentaires sur le formulaire de capture de leads, au-delà des champs standard nom/e-mail/téléphone.

PUThttps://go.fliplink.me/api/set-lead-custom-fields/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la capture de leads (base)(active la capture de leads)Définir les champs de lead personnalisés

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsLeadCustom1true | falsepar exemple false
IsLeadCustom1Mandatorytrue | falsepar exemple false
Custom1Label
IsLeadCustom2true | falsepar exemple false
IsLeadCustom2Mandatorytrue | falsepar exemple false
Custom2Label

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-lead-custom-fields/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-lead-custom-fields/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsLeadCustom1=false' \
  --data-urlencode 'IsLeadCustom1Mandatory=false' \
  --data-urlencode 'Custom1Label=<Custom1Label>' \
  --data-urlencode 'IsLeadCustom2=false' \
  --data-urlencode 'IsLeadCustom2Mandatory=false' \
  --data-urlencode 'Custom2Label=<Custom2Label>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir les libellés de lead

Définit les libellés affichés et le texte indicatif des champs du formulaire de capture de leads.

PUThttps://go.fliplink.me/api/set-lead-labels/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la capture de leads (base)(active la capture de leads)Définir les libellés de lead

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

LeadEmailemail
LeadName
LeadPhonephone
LeadCompany
LeadDate
LeadButton

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-lead-labels/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-lead-labels/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'LeadEmail=<LeadEmail>' \
  --data-urlencode 'LeadName=<LeadName>' \
  --data-urlencode 'LeadPhone=<LeadPhone>' \
  --data-urlencode 'LeadCompany=<LeadCompany>' \
  --data-urlencode 'LeadDate=<LeadDate>' \
  --data-urlencode 'LeadButton=<LeadButton>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir la confidentialité des leads

Configure le texte et les options de confidentialité/consentement de la capture de leads (par exemple la case de consentement RGPD).

PUThttps://go.fliplink.me/api/set-lead-privacy/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la capture de leads (base)(active la capture de leads)Définir la confidentialité des leads

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsLeadPrivacyPolicytrue | falsepar exemple false
PrivacyPolicyURLURL
PrivacyPolicyText

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-lead-privacy/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-lead-privacy/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsLeadPrivacyPolicy=false' \
  --data-urlencode 'PrivacyPolicyURL=<PrivacyPolicyURL>' \
  --data-urlencode 'PrivacyPolicyText=<PrivacyPolicyText>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir la vérification des leads

Active ou désactive la vérification de l'e-mail des leads, obligeant les lecteurs à confirmer leur e-mail avant l'accès.

PUThttps://go.fliplink.me/api/set-lead-verification/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la capture de leads (base)(active la capture de leads)Définir la vérification des leads

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsVerifyEmailtrue | falsepar exemple false
IsVerifyMobiletrue | falsepar exemple false
TwillioAPIKeyTa clé d'API Twilio (le nom du champ conserve l'orthographe d'origine « Twillio »).
EmailVerifyTitleText
EmailVerifyButtonText

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-lead-verification/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-lead-verification/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsVerifyEmail=false' \
  --data-urlencode 'IsVerifyMobile=false' \
  --data-urlencode 'TwillioAPIKey=<TwillioAPIKey>' \
  --data-urlencode 'EmailVerifyTitleText=<EmailVerifyTitleText>' \
  --data-urlencode 'EmailVerifyButtonText=<EmailVerifyButtonText>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le webhook de lead

Définit une URL de webhook qui reçoit chaque nouveau lead (enregistrée comme webhook de nouveau lead). Utilise test-webhook pour vérifier qu'il se déclenche.

PUThttps://go.fliplink.me/api/set-lead-webhook/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la capture de leads (base)(active la capture de leads)Définir le webhook de lead

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

WebhookURL_NewLeadURLL'URL de ton endpoint — reçoit une charge utile JSON pour chaque nouveau lead.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-lead-webhook/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-lead-webhook/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'WebhookURL_NewLead=<WebhookURL_NewLead>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Tester le webhook

Envoie une charge utile de TEST au webhook de lead configuré du flipbook pour que tu puisses vérifier le format de livraison sans véritable lead. Renvoie l'erreur « No lead webhook is configured for this flipbook. » si aucun n'est défini. La structure de la charge utile correspond à un vrai lead (clés : pdf_id, pdf_name, lead_name, lead_email, lead_phone, lead_company, lead_date, lead_custom_1, lead_custom_2) mais avec des valeurs factices (pdf_id:"-1", pdf_name:"Test PDF", ...). Aucun véritable lead n'est stocké et aucun e-mail de notification n'est envoyé.

POSThttps://go.fliplink.me/api/test-webhook/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le webhook de lead(un webhook doit d'abord être configuré)Tester le webhook

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

POST/api/test-webhook/{flipbookId}
curl -X POST 'https://go.fliplink.me/api/test-webhook/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Définir Google Sheets pour les leads

Connecte la capture de leads à une feuille Google Sheets — chaque nouveau lead est ajouté à la feuille que tu indiques (ID de la feuille + nom).

PUThttps://go.fliplink.me/api/set-lead-google-sheets/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir la capture de leads (base)(active la capture de leads)Définir Google Sheets pour les leads

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

GoogleSheetURLURL
GoogleSheetIDKey
GoogleSheetName

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-lead-google-sheets/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-lead-google-sheets/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'GoogleSheetURL=<GoogleSheetURL>' \
  --data-urlencode 'GoogleSheetIDKey=<GoogleSheetIDKey>' \
  --data-urlencode 'GoogleSheetName=<GoogleSheetName>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — Notifications et modèles d'e-mail

Définir les notifications

Configure les notifications par e-mail que tu reçois pour ce flipbook (nouveau lead, nouvelle vue, nouvelle vente).

PUThttps://go.fliplink.me/api/set-notifications/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir les notifications

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

NotificationsEmailemail
IsSendEmailOnViewtrue | falsepar exemple false

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-notifications/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-notifications/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'NotificationsEmail=<NotificationsEmail>' \
  --data-urlencode 'IsSendEmailOnView=false'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le modèle d'e-mail — Nouveau lead

Définit l'e-mail envoyé lors d'un événement nouveau lead. Envoie des valeurs vides pour restaurer le modèle NEW_LEAD par défaut.

PUThttps://go.fliplink.me/api/set-email-template-lead/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le modèle d'e-mail — Nouveau lead

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

EmailLeadSubject
EmailLeadBody

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-email-template-lead/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-email-template-lead/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailLeadSubject=<EmailLeadSubject>' \
  --data-urlencode 'EmailLeadBody=<EmailLeadBody>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le modèle d'e-mail — Nouvelle vue

Définit le modèle d'e-mail envoyé lors d'une notification de nouvelle vue. Envoie une valeur vide pour restaurer le modèle NEW_VIEW par défaut.

PUThttps://go.fliplink.me/api/set-email-template-view/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le modèle d'e-mail — Nouvelle vue

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

EmailViewSubject
EmailViewBody

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-email-template-view/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-email-template-view/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailViewSubject=<EmailViewSubject>' \
  --data-urlencode 'EmailViewBody=<EmailViewBody>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le modèle d'e-mail — Nouvelle vente

Définit le modèle d'e-mail envoyé lors d'une notification de nouvelle vente. Envoie une valeur vide pour restaurer le modèle NEW_SALE par défaut.

PUThttps://go.fliplink.me/api/set-email-template-sale/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le modèle d'e-mail — Nouvelle vente

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

EmailSaleSubject
EmailSaleBody

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-email-template-sale/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-email-template-sale/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailSaleSubject=<EmailSaleSubject>' \
  --data-urlencode 'EmailSaleBody=<EmailSaleBody>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — Ventes

Définir les réglages de vente

Configure la vente du flipbook (prix, devise, options). Activer le mode vente active automatiquement la vérification de l'e-mail et rend l'e-mail du lead obligatoire.

PUThttps://go.fliplink.me/api/set-sale-settings/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Lister les devises(choisis SaleCurr)Définir les réglages de vente

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsForSaletrue | falsepar exemple false
SaleCurrDe /api/list-currencies
SaleAmountnumberpar exemple 0

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-sale-settings/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-sale-settings/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsForSale=false' \
  --data-urlencode 'SaleCurr=USD' \
  --data-urlencode 'SaleAmount=0'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le texte de la page de vente

Définit le texte marketing affiché sur la page de vente / de paiement du flipbook.

PUThttps://go.fliplink.me/api/set-sale-page-text/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir les réglages de vente(active la vente)Définir le texte de la page de vente

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

SalePageTitle
SaleAccessPageTitle
SalePurchaseButtonText
SaleButtonText
SaleAccessButtonText
SaleButtonColor

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-sale-page-text/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-sale-page-text/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'SalePageTitle=<SalePageTitle>' \
  --data-urlencode 'SaleAccessPageTitle=<SaleAccessPageTitle>' \
  --data-urlencode 'SalePurchaseButtonText=<SalePurchaseButtonText>' \
  --data-urlencode 'SaleButtonText=<SaleButtonText>' \
  --data-urlencode 'SaleAccessButtonText=<SaleAccessButtonText>' \
  --data-urlencode 'SaleButtonColor=<SaleButtonColor>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir la passerelle de paiement

Sélectionne et configure la passerelle de paiement utilisée pour vendre ce flipbook.

PUThttps://go.fliplink.me/api/set-sale-gateway/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir les réglages de vente(active la vente)Définir la passerelle de paiement

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

SaleGatewayName
SaleGatewayKey
SaleGatewaySecret

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-sale-gateway/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-sale-gateway/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'SaleGatewayName=<SaleGatewayName>' \
  --data-urlencode 'SaleGatewayKey=<SaleGatewayKey>' \
  --data-urlencode 'SaleGatewaySecret=<SaleGatewaySecret>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — Approbation

Définir le bouton d'approbation

Ajoute un bouton de demande d'approbation au lecteur. Son activation déclenche le workflow de demande d'approbation.

PUThttps://go.fliplink.me/api/set-approval-button/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(DocType=document — éléments Document uniquement)Définir le bouton d'approbation

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsApprovalButtontrue | falsepar exemple false
ApprovalButtonText
ApprovalButtonColor
ApprovalButtonTextColor

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-approval-button/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-approval-button/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsApprovalButton=false' \
  --data-urlencode 'ApprovalButtonText=<ApprovalButtonText>' \
  --data-urlencode 'ApprovalButtonColor=<ApprovalButtonColor>' \
  --data-urlencode 'ApprovalButtonTextColor=<ApprovalButtonTextColor>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir les modèles d'e-mail d'approbation

Définit les modèles d'e-mail utilisés par le workflow d'approbation. Des valeurs vides récupèrent les valeurs par défaut.

PUThttps://go.fliplink.me/api/set-approval-email-templates/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(DocType=document — éléments Document uniquement)Définir les modèles d'e-mail d'approbation

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

EmailApproveRequestSubject
EmailApproveRequestBody
EmailApproveRemindSubject
EmailApproveRemindBody
EmailApproveSubmitSubject
EmailApproveSubmitBody

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-approval-email-templates/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-approval-email-templates/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailApproveRequestSubject=<EmailApproveRequestSubject>' \
  --data-urlencode 'EmailApproveRequestBody=<EmailApproveRequestBody>' \
  --data-urlencode 'EmailApproveRemindSubject=<EmailApproveRemindSubject>' \
  --data-urlencode 'EmailApproveRemindBody=<EmailApproveRemindBody>' \
  --data-urlencode 'EmailApproveSubmitSubject=<EmailApproveSubmitSubject>' \
  --data-urlencode 'EmailApproveSubmitBody=<EmailApproveSubmitBody>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — Partage

Définir l'interrupteur principal de partage

Interrupteur principal d'activation/désactivation des boutons de partage du lecteur.

PUThttps://go.fliplink.me/api/set-share-master/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'interrupteur principal de partage

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsShareButtonstrue | falsepar exemple false

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-share-master/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-share-master/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsShareButtons=false'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir les canaux de partage

Active/désactive individuellement chaque canal de partage social (Facebook, X, LinkedIn, WhatsApp, e-mail, etc.) dans le menu de partage du lecteur.

PUThttps://go.fliplink.me/api/set-share-channels/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir les canaux de partage

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsShareFacebooktrue | falsepar exemple true
IsShareTwittertrue | falsepar exemple true
IsShareWhatsApptrue | falsepar exemple true
IsShareTelegramtrue | falsepar exemple false
IsShareLinkedIntrue | falsepar exemple true
IsSharePinteresttrue | falsepar exemple false
IsShareReddittrue | falsepar exemple false
IsShareTumblrtrue | falsepar exemple false
IsShareMessengertrue | falsepar exemple false
IsShareEmailtrue | falsepar exemple true
IsShareLinetrue | falsepar exemple false
IsShareWeChattrue | falsepar exemple false
IsShareInstagramtrue | falsepar exemple false
IsShareFlipboardtrue | falsepar exemple false
IsShareGeneraltrue | falsepar exemple true

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-share-channels/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-share-channels/{flipbookId}' \  -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'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Sections — Suivi et IA

Définir le suivi analytique

Ajoute tes propres identifiants de suivi analytique (par exemple Google Analytics, GTM, Facebook Pixel) au flipbook hébergé.

PUThttps://go.fliplink.me/api/set-analytics-tracking/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le suivi analytique

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

FacebookAnalyticsCode
GoogleAnalyticsCode
GoogleTagManager

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-analytics-tracking/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-analytics-tracking/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'FacebookAnalyticsCode=<FacebookAnalyticsCode>' \
  --data-urlencode 'GoogleAnalyticsCode=<GoogleAnalyticsCode>' \
  --data-urlencode 'GoogleTagManager=<GoogleTagManager>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le fournisseur d'IA

Configure le fournisseur d'IA utilisé pour les fonctionnalités d'IA — le nom du fournisseur et sa clé d'API.

PUThttps://go.fliplink.me/api/set-ai-provider/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le fournisseur d'IA

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

AIProvider
AIKey

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-ai-provider/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-ai-provider/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'AIProvider=<AIProvider>' \
  --data-urlencode 'AIKey=<AIKey>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir l'assistant virtuel

Configure les réglages de base de l'assistant virtuel intégré au lecteur (chat/aide).

PUThttps://go.fliplink.me/api/set-virtual-assistant/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir l'assistant virtuel

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

IsVAtrue | falsepar exemple false
VAButtonText
VAButtonColor
VAButtonTextColor
VATextInvite / instructions de l'assistant
VAEmbeddingsBlob d'embeddings (chaîne)

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-virtual-assistant/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-virtual-assistant/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsVA=false' \
  --data-urlencode 'VAButtonText=<VAButtonText>' \
  --data-urlencode 'VAButtonColor=<VAButtonColor>' \
  --data-urlencode 'VAButtonTextColor=<VAButtonTextColor>' \
  --data-urlencode 'VAText=<VAText>' \
  --data-urlencode 'VAEmbeddings=<VAEmbeddings>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps

Définir le texte de statut de l'assistant virtuel

Définit le texte de statut/d'accueil affiché par l'assistant virtuel intégré au lecteur.

PUThttps://go.fliplink.me/api/set-virtual-assistant-status-text/{flipbookId}
PrérequisQui suis-je(une clé d'API valide)Créer à partir d'un fichier(récupère un flipbookId)Définir le texte de statut de l'assistant virtuel

Paramètres de chemin

flipbookIdnumberID numérique du flipbook/document — renvoyé par create-by-file / create-by-url (sous le nom ID) ou par list.

Paramètres du corps

VAButtonStatus1Libellé du statut d'écoute
VAButtonStatus2Libellé du statut d'enregistrement
VAButtonStatus3Libellé du statut de traitement
VAButtonStatus4Libellé du statut de prise de parole

Réponses d'erreur

401Missing or invalid API keyReturns a 401 Unauthorized HTML page — there is no JSON body.
200Item ID not found or not owned by your key{ "Result": "ERROR", "Message": "Item not found" }
200Unknown or misspelled body field{ "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }

Une clé manquante/invalide est rejetée avec un HTTP 401 (une page HTML, pas de JSON). Toute autre erreur renvoie un HTTP 200 avec { "Result": "ERROR", "Message": … } — alors branche-toi toujours sur Result, pas seulement sur le statut HTTP.

PUT/api/set-virtual-assistant-status-text/{flipbookId}
curl -X PUT 'https://go.fliplink.me/api/set-virtual-assistant-status-text/{flipbookId}' \  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'VAButtonStatus1=<VAButtonStatus1>' \
  --data-urlencode 'VAButtonStatus2=<VAButtonStatus2>' \
  --data-urlencode 'VAButtonStatus3=<VAButtonStatus3>' \
  --data-urlencode 'VAButtonStatus4=<VAButtonStatus4>'
Exemple de réponse200 OK
{
  "Result": "OK",
  "Message": "Updated successfully"
}

Colle ta clé d'API dans « Ta clé d'API » en haut — puis remplis les champs ci-dessous et envoie.

Paramètres de chemin — requis pour identifier l'élément

Paramètres du corps