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

Mettre à jour la collection du magasin

Les mises à jour n’envoyaient que les champs de la collection.

PATCH/store/collections/{id}store: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

idstring · pathIdentificateur de ressource.minLength 2 · maxLength 100obligatoire
namestring · bodyNom public de la collection.minLength 2 · maxLength 120facultatif
slugstring · bodyUne seule balle publique.maxLength 80facultatif
descriptionstring · bodyDescriptif des collections.maxLength 1000facultatif
imagestring · bodyImage de couverture HTTPS.urifacultatif
offer_idsarray · bodyOffres affichées dans la collection.facultatif
activeboolean · bodyPublier la collection.facultatif
AuthorizationBearer ach_live_...
Acceptapplication/json
Portéestore:write

Exemple d'exécutable

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

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.