Przejdź do treści
AchaduDevelopers
Developers/API/template_create
Szablony

Utwórz szablon

Tworzy szablon publikacji wielokrotnego użytku.

POST/templatestemplates:write
ZACHOWANIE

Zmiana zostanie zweryfikowana i utrwalona na koncie kluczowym przed udzieleniem odpowiedzi. Zapytaj zwrócony zasób jako źródło prawdy.

EFEKT

Może zmienić zasób i wyemitować odpowiednie zdarzenie domeny.

POWTÓRKA

W przypadku awarii sieci potwierdź stan zasobu przed ponowną próbą. Automatycznie ponawiaj tylko 429 i 5xx z cofaniem i jitterem.

Żądanie

namestring · bodyNazwa szablonu.obowiązkowe
bodystring · bodyTreść ze zmiennymi Achadu.maxLength 12000obowiązkowe
marketplacestring · bodyOpcjonalny rynek.opcjonalne
with_previewboolean · bodyLegacy preference. Offer messages always include a product link preview when available.opcjonalne
AuthorizationBearer ach_live_...
Acceptapplication/json
Zakrestemplates:write

Przykład wykonywalny

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

Odpowiedź i błędy

Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.

201 application/json
{
  "data": {
    "id": "tpl_01J...",
    "name": "Direct deal",
    "body": "{{title}} for {{price}}",
    "has_preview": 1,
    "created_at": "2026-08-31T18:20:00.000Z"
  },
  "created": true,
  "request_id": "req_01J..."
}
201Zasób został utworzony i utrwalony.
400Nieprawidłowy parametr, treść lub przejście.
401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.
402Plan konta nie udostępnia tego interfejsu.
403A chave precisa do escopo templates:write.
404Funkcja nie istnieje na tym koncie.
409Obecny stan uniemożliwia tę operację.
413Treść JSON przekracza 128 KB.
429Przekroczono okno 120 żądań na minutę.