Catàleg de productes

GET/api/v1/products

Llistar productes

El teu catàleg (la fitxa comercial de cada producte). Per defecte només els actius.

Paràmetres de consulta

kindstring

Filtra per tipus (course, masterclass, live_event…).

publish_statusstring

Valors: published · draft · archived

include_inactiveboolean

true per incloure també els pausats.

bash

curl "https://www.clonify.com/api/v1/products" \
  -H "Authorization: Bearer clk_live_…"

POST/api/v1/products

Crear un producte

Crea una fitxa al catàleg del clon. Queda activa: el clon podrà recomanar-la quan encaixi en la conversa.

Permís d'escriptura

Cos (JSON)

titlestring 3..200obligatori

descriptionstring 40..4000obligatori

pricenumber | null

Omès o null = «consultar amb el creador».

currencystring ISO-3

ISO de 3 lletres. Per defecte EUR.

checkout_urlstring (URL HTTP(S), max. 1000) | null

tagsstring[]obligatori

Tipus(os) del producte: curs, masterclass, llibre, comunitat, coaching… Com a mínim un.

bash

curl -X POST "https://www.clonify.com/api/v1/products" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"…","description":"…","tags":["…"]}'

GET/api/v1/products/{id}

Llegir un producte

La fitxa completa d'un producte, amb les seves FAQs incloses.

Paràmetres de ruta

idintegerobligatori

bash

curl "https://www.clonify.com/api/v1/products/1" \
  -H "Authorization: Bearer clk_live_…"

PATCH/api/v1/products/{id}

Editar un producte

Només es toquen els camps que enviïs. Canviar el títol, la descripció o els tipus re-indexa el producte per al matching del clon.

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori

Cos (JSON)

replay_visibilitystring

Històric disponible en cursos, Actualitzacions i repeticions de directes. all permet tot l’històric; since_joined només el contingut des de l’entrada. Les renovacions conserven aquesta data; quan acaba l’accés es tanca el contingut i una nova subscripció comença una altra finestra. Omet-lo per conservar l’ajust actual. GET retorna replay_visibility.Valors: all · since_joined

titlestring 3..200

descriptionstring 40..4000

pricenumber | null

null = «consultar amb el creador».

currencystring ISO-3

checkout_urlstring (URL HTTP(S), max. 1000) | null

cta_labelstring 0..60 | null

Text del botó de la targeta. null = botó genèric.

tagsstring[]

is_activeboolean

false posa el producte en pausa comercialment (el clon deixa de recomanar-lo).

publish_statusstring

Valors: published · draft · archived

bash

curl -X PATCH "https://www.clonify.com/api/v1/products/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"replay_visibility":"all","title":"…"}'

POST/api/v1/products/{id}/entries/import

Importar entrades de contingut

Afegeix d'1 a 50 entrades de text a un producte existent (course, masterclass, capsules o downloadable) en una única operació. No crea productes ni canvia preus, accessos o l'estat del producte, i no envia avisos. HTML sanejat, màxim 50.000 caràcters per entrada i 3 MB per petició. Cada entrada queda en esborrany llevat que status=published. published_at conserva la data històrica; no programa la publicació. Una repetició idèntica retorna 200 i replayed=true; la primera importació retorna 201. Reutilitzar external_id amb un altre contingut retorna 409: no sincronitza correccions.

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori

Cos (JSON)

external_idstring 1..200obligatori

Identificador estable del lot dins d'aquest producte. Reutilitza'l en reintentar.

collection_titlestring 1..200

Títol opcional d'un mòdul nou que agrupa aquestes entrades.

entriesobject[]obligatori

Entrades ordenades amb external_id únic dins del lot, title i html obligatoris; description, published_at (ISO 8601 amb zona horària) i status (draft per defecte o published) opcionals. Conserva exactament el mateix contingut en reintentar. category (fins a 80 caràcters) i summary_html (fins a 8.000 caràcters, només negreta i cursiva) són opcionals. Les etiquetes b/i es converteixen a strong/em; s’eliminen enllaços, estils i contingut executable.

bash

curl -X POST "https://www.clonify.com/api/v1/products/1/entries/import" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"…","entries":[{"…":"…"}]}'

json

{ "data": { "product_id": 172, "external_id": "edition-2026-09-11", "module_id": 80, "entries": [{ "external_id": "article-1", "unit_id": 501, "status": "draft" }], "replayed": false } }

GET/api/v1/products/{id}/entries/import

Consultar una importació

Retorna el rebut original amb els identificadors de les entrades creades. Només consulta importacions del compte de la clau. 404 si no existeix. No reflecteix modificacions posteriors de les entrades.

Paràmetres de ruta

idintegerobligatori

Paràmetres de consulta

external_idstring 1..200obligatori

Identificador del lot utilitzat en importar.

bash

curl "https://www.clonify.com/api/v1/products/1/entries/import" \
  -H "Authorization: Bearer clk_live_…"

PATCH/api/v1/products/{id}/entries/import

Actualitzar la presentació de les entrades

Actualitza només la categoria i el resum de les entrades ja importades. Conserva el cos, les dates, l’estat, els accessos i el rebut original. Operació atòmica, repetible i limitada al compte i producte de la clau. null elimina un camp; ometre’l el conserva.

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori

Cos (JSON)

external_idstring 1..200obligatori

Identificador del lot original.

entriesobject[]obligatori

D’1 a 50 entrades amb l’external_id original i category o summary_html. No s’admeten entrades repetides.

bash

curl -X PATCH "https://www.clonify.com/api/v1/products/1/entries/import" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"…","entries":[{"…":"…"}]}'

GET/api/v1/products/{id}/faqs

Llistar FAQs d'un producte

Les respostes que ensenyen al clon a resoldre dubtes i objeccions sobre aquest producte.

Paràmetres de ruta

idintegerobligatori

bash

curl "https://www.clonify.com/api/v1/products/1/faqs" \
  -H "Authorization: Bearer clk_live_…"

POST/api/v1/products/{id}/faqs

Crear FAQ de producte

Quan preguntin alguna cosa semblant SOBRE aquest producte, el clon respondrà el que s'indiqui.

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori

Cos (JSON)

questionstring 3..300obligatori

answerstring 1..4000obligatori

answer_modestring

Per defecte 'free': el clon respon amb la seva veu recolzant-se en el teu text (la FAQ és guia). 'context' ho fixa amb més fidelitat (enllaços, passos i dades es respecten).Valors: free · contexto

actionsobject[]

Accions en disparar-se: {type: asset|product|external_link|video_embed|escalate_offer, …}.

bash

curl -X POST "https://www.clonify.com/api/v1/products/1/faqs" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"question":"…","answer":"…"}'

DELETE/api/v1/products/{id}/faqs/{faqId}

Esborrar FAQ de producte

Esborra la FAQ PERMANENTMENT. No hi ha paperera: si va ser un error, torna a crear-la.

Permís d'esborrat

Paràmetres de ruta

idintegerobligatori

faqIdintegerobligatori

bash

curl -X DELETE "https://www.clonify.com/api/v1/products/1/faqs/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

json

{ "id": 51, "product_id": 172, "deleted": true }

DELETE/api/v1/products/{id}

Esborrar un producte

Esborra el producte PERMANENTMENT, amb les seves FAQs. Per deixar de recomanar-lo sense perdre'l, millor PATCH amb is_active=false (pausa) o publish_status='archived'.

Permís d'esborrat

Paràmetres de ruta

idintegerobligatori

bash

curl -X DELETE "https://www.clonify.com/api/v1/products/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

json

{ "id": 172, "deleted": true }

Catàleg de productes

GET/api/v1/products

Llistar productes

El teu catàleg (la fitxa comercial de cada producte). Per defecte només els actius.

Paràmetres de consulta

kindstring

Filtra per tipus (course, masterclass, live_event…).

publish_statusstring

Valors: published · draft · archived

include_inactiveboolean

true per incloure també els pausats.

bash

curl "https://www.clonify.com/api/v1/products" \
  -H "Authorization: Bearer clk_live_…"

POST/api/v1/products

Crear un producte

Crea una fitxa al catàleg del clon. Queda activa: el clon podrà recomanar-la quan encaixi en la conversa.

Permís d'escriptura

Cos (JSON)

titlestring 3..200obligatori

descriptionstring 40..4000obligatori

pricenumber | null

Omès o null = «consultar amb el creador».

currencystring ISO-3

ISO de 3 lletres. Per defecte EUR.

checkout_urlstring (URL HTTP(S), max. 1000) | null

tagsstring[]obligatori

Tipus(os) del producte: curs, masterclass, llibre, comunitat, coaching… Com a mínim un.

bash

curl -X POST "https://www.clonify.com/api/v1/products" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"…","description":"…","tags":["…"]}'

GET/api/v1/products/{id}

Llegir un producte

La fitxa completa d'un producte, amb les seves FAQs incloses.

Paràmetres de ruta

idintegerobligatori

bash

curl "https://www.clonify.com/api/v1/products/1" \
  -H "Authorization: Bearer clk_live_…"

PATCH/api/v1/products/{id}

Editar un producte

Només es toquen els camps que enviïs. Canviar el títol, la descripció o els tipus re-indexa el producte per al matching del clon.

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori

Cos (JSON)

replay_visibilitystring

titlestring 3..200

descriptionstring 40..4000

pricenumber | null

null = «consultar amb el creador».

currencystring ISO-3

checkout_urlstring (URL HTTP(S), max. 1000) | null

cta_labelstring 0..60 | null

Text del botó de la targeta. null = botó genèric.

tagsstring[]

is_activeboolean

false posa el producte en pausa comercialment (el clon deixa de recomanar-lo).

publish_statusstring

Valors: published · draft · archived

bash

curl -X PATCH "https://www.clonify.com/api/v1/products/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"replay_visibility":"all","title":"…"}'

POST/api/v1/products/{id}/entries/import

Importar entrades de contingut

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori

Cos (JSON)

external_idstring 1..200obligatori

Identificador estable del lot dins d'aquest producte. Reutilitza'l en reintentar.

collection_titlestring 1..200

Títol opcional d'un mòdul nou que agrupa aquestes entrades.

entriesobject[]obligatori

bash

curl -X POST "https://www.clonify.com/api/v1/products/1/entries/import" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"…","entries":[{"…":"…"}]}'

json

{ "data": { "product_id": 172, "external_id": "edition-2026-09-11", "module_id": 80, "entries": [{ "external_id": "article-1", "unit_id": 501, "status": "draft" }], "replayed": false } }

GET/api/v1/products/{id}/entries/import

Consultar una importació

Paràmetres de ruta

idintegerobligatori

Paràmetres de consulta

external_idstring 1..200obligatori

Identificador del lot utilitzat en importar.

bash

curl "https://www.clonify.com/api/v1/products/1/entries/import" \
  -H "Authorization: Bearer clk_live_…"

PATCH/api/v1/products/{id}/entries/import

Actualitzar la presentació de les entrades

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori

Cos (JSON)

external_idstring 1..200obligatori

Identificador del lot original.

entriesobject[]obligatori

D’1 a 50 entrades amb l’external_id original i category o summary_html. No s’admeten entrades repetides.

bash

curl -X PATCH "https://www.clonify.com/api/v1/products/1/entries/import" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"…","entries":[{"…":"…"}]}'

GET/api/v1/products/{id}/faqs

Llistar FAQs d'un producte

Les respostes que ensenyen al clon a resoldre dubtes i objeccions sobre aquest producte.

Paràmetres de ruta

idintegerobligatori

bash

curl "https://www.clonify.com/api/v1/products/1/faqs" \
  -H "Authorization: Bearer clk_live_…"

POST/api/v1/products/{id}/faqs

Crear FAQ de producte

Quan preguntin alguna cosa semblant SOBRE aquest producte, el clon respondrà el que s'indiqui.

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori

Cos (JSON)

questionstring 3..300obligatori

answerstring 1..4000obligatori

answer_modestring

actionsobject[]

Accions en disparar-se: {type: asset|product|external_link|video_embed|escalate_offer, …}.

bash

curl -X POST "https://www.clonify.com/api/v1/products/1/faqs" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"question":"…","answer":"…"}'

DELETE/api/v1/products/{id}/faqs/{faqId}

Esborrar FAQ de producte

Esborra la FAQ PERMANENTMENT. No hi ha paperera: si va ser un error, torna a crear-la.

Permís d'esborrat

Paràmetres de ruta

idintegerobligatori

faqIdintegerobligatori

bash

curl -X DELETE "https://www.clonify.com/api/v1/products/1/faqs/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

json

{ "id": 51, "product_id": 172, "deleted": true }

DELETE/api/v1/products/{id}

Esborrar un producte

Esborra el producte PERMANENTMENT, amb les seves FAQs. Per deixar de recomanar-lo sense perdre'l, millor PATCH amb is_active=false (pausa) o publish_status='archived'.

Permís d'esborrat

Paràmetres de ruta

idintegerobligatori

bash

curl -X DELETE "https://www.clonify.com/api/v1/products/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

json

{ "id": 172, "deleted": true }