Passer au contenu
AchaduDevelopers
API opérationnelleAller sur le site Web ↗
Tableau de bord →
Developers/API/store_update
Magasin

Mettre à jour le magasin

Les mises à jour stockent l’identité, le thème, les réseaux et la confidentialité.

PATCH/storestore:write
COMPORTEMENT

Le changement est validé et conservé dans le compte clé avant de répondre. Interrogez la ressource renvoyée comme source de vérité.

EFFET

Il peut modifier la ressource et émettre l'événement de domaine correspondant.

RÉPÉTITION

En cas de panne du réseau, confirmez l'état de la ressource avant de réessayer. Refaites automatiquement uniquement 429 et 5xx avec recul et gigue.

Demande

namestring · bodyNom du magasin.facultatif
taglinestring · bodyPhrase principale.facultatif
logostring · bodyURL du logo.urifacultatif
coverstring · bodyURL de couverture.urifacultatif
faviconstring · bodyURL de l'icône.urifacultatif
aboutstring · bodyDescriptif du magasin.facultatif
themeobject · bodyJetons visuels.facultatif
socialobject · bodyLiens sociaux.facultatif
privacyobject · bodyPréférences du public.facultatif
badgeboolean · bodyAffiche le sceau.facultatif
activeboolean · bodyPubliez la boutique.facultatif
AuthorizationBearer ach_live_...
Acceptapplication/json
Portéestore:write

Exemple d'exécutable

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"
}'

Réponse et erreurs

Chaque réponse inclut request_id. Les listes ajoutent une pagination ; les ressources mutables renvoient l'état persistant après l'opération.

200 application/json
{
  "data": {
    "id": "site_01J...",
    "subdomain": "mystore",
    "name": "Ana's Finds",
    "theme": "light",
    "active": 1,
    "domain_verified": 1
  },
  "request_id": "req_01J..."
}
200Opération terminée.
400Paramètre, corps ou transition non valide.
401Clé manquante, invalide, expirée ou révoquée.
402Le plan de compte ne libère pas cette interface.
403A chave precisa do escopo store:write.
404La fonctionnalité n'existe pas dans ce compte.
409L'état actuel empêche cette opération.
413Le corps JSON dépasse 128 Ko.
429La fenêtre de 120 requêtes par minute a été dépassée.