Zum Inhalt springen
AchaduDevelopers
Developers/API/store_update
Speichern

Store aktualisieren

Aktualisiert die Identität, das Thema, die Netzwerke und den Datenschutz.

PATCH/storestore:write
VERHALTEN

Die Änderung wird validiert und im Schlüsselkonto gespeichert, bevor reagiert wird. Fragen Sie die zurückgegebene Ressource als Quelle der Wahrheit ab.

WIRKUNG

Es kann die Ressource ändern und das entsprechende Domänenereignis ausgeben.

WIEDERHOLUNG

Bestätigen Sie bei einem Netzwerkfehler den Ressourcenstatus, bevor Sie es erneut versuchen. Nur 429 und 5xx mit Backoff und Jitter automatisch wiederholen.

Anfrage

namestring · bodyShopname.optional
taglinestring · bodyHauptsatz.optional
logostring · bodyLogo-URL.urioptional
coverstring · bodyCover-URL.urioptional
faviconstring · bodySymbol-URL.urioptional
aboutstring · bodyBeschreibung des Shops.optional
themeobject · bodyVisuelle Token.optional
socialobject · bodySoziale Links.optional
privacyobject · bodyÖffentliche Vorlieben.optional
badgeboolean · bodyZeigt Siegel an.optional
activeboolean · bodyVeröffentlichen Sie den Shop.optional
AuthorizationBearer ach_live_...
Acceptapplication/json
Umfangstore:write

Ausführbares Beispiel

curl
curl -X PATCH 'https://achadu.com/api/v1/store' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "name": "My integration",
  "tagline": "string",
  "logo": "https://cdn.example.com/image.jpg"
}'

Reaktion und Fehler

Jede Antwort enthält request_id. Listen fügen Paginierung hinzu; Veränderbare Ressourcen geben nach der Operation den persistenten Zustand zurück.

200 application/json
{
  "data": {
    "id": "site_01J...",
    "subdomain": "mystore",
    "name": "Ana's Finds",
    "theme": "light",
    "active": 1,
    "domain_verified": 1
  },
  "request_id": "req_01J..."
}
200Vorgang abgeschlossen.
400Ungültiger Parameter, Körper oder Übergang.
401Fehlender, ungültiger, abgelaufener oder widerrufener Schlüssel.
402Der Account-Plan gibt diese Schnittstelle nicht frei.
403A chave precisa do escopo store:write.
404Die Funktion ist in diesem Konto nicht vorhanden.
409Der aktuelle Status verhindert diesen Vorgang.
413Der JSON-Körper ist größer als 128 KB.
429Das Zeitfenster von 120 Anfragen pro Minute wurde überschritten.