Vai al contenuto
AchaduDevelopers
API operativaVai al sito web ↗
Cruscotto →
Developers/API/template_update
Modelli

Aggiorna modello

Aggiorna i campi inviati dal modello.

PATCH/templates/{id}templates:write
COMPORTAMENTO

La modifica viene convalidata e mantenuta nell'account chiave prima di rispondere. Interroga la risorsa restituita come fonte di verità.

EFFETTO

Può modificare la risorsa ed emettere l'evento di dominio corrispondente.

RIPETIZIONE

In caso di errore di rete, verificare lo stato della risorsa prima di riprovare. Ripristina automaticamente solo 429 e 5xx con backoff e jitter.

Richiesta

idstring · pathIdentificatore della risorsa.minLength 2 · maxLength 100obbligatorio
namestring · bodyNome del modello.facoltativo
bodystring · bodyCorpo con variabili Achadu.maxLength 12000facoltativo
marketplacestring · bodyMercato facoltativo.facoltativo
with_previewboolean · bodyLegacy preference. Offer messages always include a product link preview when available.facoltativo
AuthorizationBearer ach_live_...
Acceptapplication/json
Ambitotemplates:write

Esempio eseguibile

curl
curl -X PATCH 'https://achadu.com/api/v1/templates/resource_id' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "name": "My integration",
  "body": "string",
  "marketplace": "string"
}'

Risposta ed errori

Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.

200 application/json
{
  "data": {
    "id": "tpl_01J...",
    "name": "Direct deal",
    "body": "{{title}} for {{price}}",
    "has_preview": 1,
    "created_at": "2026-08-31T18:20:00.000Z"
  },
  "request_id": "req_01J..."
}
200Operazione completata.
400Parametro, corpo o transizione non validi.
401Chiave mancante, non valida, scaduta o revocata.
402Il piano dell'account non rilascia questa interfaccia.
403A chave precisa do escopo templates:write.
404La funzionalità non esiste in questo account.
409Lo stato attuale impedisce questa operazione.
413Il corpo JSON supera i 128 KB.
429La finestra di 120 richieste al minuto è stata superata.