ClonifyDevelopersAnar al tauler

Començar

  • Autenticació
  • Errors
  • Paginació
  • Límits de peticions
  • Webhooks
  • Per a agents d'IA
  • Servidor MCP

Referència de l'API

  • Seguiment d'alumnes6
  • Lliuraments externs per API6
  • Xat amb el clon1
  • Contactes i etiquetes5
  • Accessos d'acadèmies4
  • Converses4
  • Catàleg de productes11
  • Vendes externes2
  • Coneixement12
  • Multimèdia4
  • Clons (versions a l'API)3
  • Reunions i reserves3
  • Webinars6
  • Compte i consum1
Clonify

Lliuraments externs per API

GET/api/v1/external-delivery/connections

Connexions de lliurament extern

Llista connexions i disponibilitat de credencials sense retornar secrets. Pàgines de fins a 100 registres.

Paràmetres de consulta

starting_afterinteger
bash
curl "https://www.clonify.com/api/v1/external-delivery/connections" \
  -H "Authorization: Bearer clk_live_…"
POST/api/v1/external-delivery/connections

Desar connexió de lliurament extern

POST JSON a una URL HTTPS pública sense paràmetres, fragments ni credencials. name: 2–120 caràcters; url: fins a 500; auth: none o bearer; enabled: true per defecte. Sense id crea una connexió; amb id actualitza nom, enabled i token mantenint URL, auth i contracte de confirmació. token (12–4096) és només escriptura; ometre’l conserva l’actual. Autoritza bearer per aquesta API, mai al xat. successField i successValue van junts; si falten, qualsevol HTTP 2xx confirma. El destí ha de permetre reintents idempotents amb Idempotency-Key; idempotencySupported ha de ser true. Desar no envia proves ni concedeix accés. Deshabilitar atura els lliuraments pendents.

Permís d'escriptura

Cos (JSON)

idinteger
namestringobligatori
urlstringobligatori
authstringobligatori

Valors: none · bearer

tokenstring
enabledboolean
successFieldstring
successValuestring | number | boolean | null
idempotencySupportedbooleanobligatori
bash
curl -X POST "https://www.clonify.com/api/v1/external-delivery/connections" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","url":"…","auth":"none","idempotencySupported":true}'
json
{
  "data": {
    "id": 7,
    "name": "External access",
    "url": "https://service.example/api/access",
    "auth": "bearer",
    "enabled": true,
    "has_credential": true,
    "success_field": "ok",
    "success_value": true
  }
}
GET/api/v1/external-delivery/rules

Regles de lliurament extern

Llista associacions de productes i connexions, camps i activació. Pàgines de fins a 100 registres.

Paràmetres de consulta

starting_afterinteger
bash
curl "https://www.clonify.com/api/v1/external-delivery/rules" \
  -H "Authorization: Bearer clk_live_…"
POST/api/v1/external-delivery/rules

Desar regla de lliurament extern

Associa el producte o paquet exacte venut, no els components. payload té 1–32 camps JSON plans amb source (buyer.email, buyer.name, purchase.id o product.id) o value (text, número, booleà o null). Sense id crea o substitueix la regla de producte i connexió; amb id només actualitza aquella associació. enabled és false per defecte i requereix connexió habilitada i autoritzada. Només compres futures registrades, incloses vendes externes importades; sense històric, etiquetes ni accessos manuals. Els canvis no alteren lliuraments en cua. refundPolicy és review per defecte: qualsevol devolució cancel·la pendents i marca enviats o en curs per revisar manualment. keep conserva el lliurament. Sense revocació automàtica.

Permís d'escriptura

Cos (JSON)

idinteger
productIdintegerobligatori
connectionIdintegerobligatori
payloadobjectobligatori
enabledboolean
refundPolicystring

Valors: review · keep

bash
curl -X POST "https://www.clonify.com/api/v1/external-delivery/rules" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"productId":1,"connectionId":1,"payload":[{"…":"…"}]}'
GET/api/v1/external-delivery/deliveries

Estat de lliuraments externs

Llista compres i estat pending, delivering, delivered, failed, review o cancelled. delivered significa confirmació segons el contracte de l’API, no inici de sessió. Fins a vuit intents davant errors temporals amb la mateixa Idempotency-Key. Pàgines de fins a 100 registres.

Paràmetres de consulta

starting_afterinteger
bash
curl "https://www.clonify.com/api/v1/external-delivery/deliveries" \
  -H "Authorization: Bearer clk_live_…"
POST/api/v1/external-delivery/deliveries/{id}/retry

Reintentar lliurament extern

Posa un lliurament failed en pending amb la mateixa clau idempotent. Requereix connexió habilitada i cap devolució pendent de revisió. No concedeix accés en aquesta petició.

Permís d'escriptura

Paràmetres de ruta

idintegerobligatori
bash
curl -X POST "https://www.clonify.com/api/v1/external-delivery/deliveries/1/retry" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'