Lister les collections
GET
/v1/collections
Permission read_products
Compte comme une lecture
Renvoie les collections du compte, par identifiant croissant. C'est ici que se traduit le collec.id d'un produit.
Le parcours se fait par curseur : tant que meta.has_more vaut true, rappelez l'adresse avec after égal à meta.next_after. Les éléments archivés ne sont renvoyés qu'avec archived=true.
Paramètres
limit |
Facultatif | Nombre d'éléments par page, de 1 à 100. 50 par défaut. |
after |
Facultatif | Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur next_after de la réponse précédente. |
archived |
Facultatif | true pour inclure aussi les éléments archivés. false par défaut : seuls les éléments en service sont renvoyés. |
Exemple d'appel
curl "https://api.wanapos.com/v1/collections" \ -H "Authorization: Bearer VOTRE_CLE"
Réponse en cas de succès (statut 200)
Une page de collections.
| Champ | Type | Description |
|---|---|---|
data |
liste | Une page, par identifiant croissant. Liste vide s'il n'y a rien. |
data[].id |
entier |
Identifiant de la collection. C'est la valeur de collec.id dans un produit. |
data[].name |
texte | Nom de la collection. |
data[].archived |
booléen |
true si la collection est archivée. |
data[].date_creation |
texte | Date de création. |
data[].date_update |
texte | Date de la dernière modification. Chaîne vide si inconnue. |
meta |
objet | |
meta.request_id |
texte | Identifiant de l'appel. |
meta.count |
entier | Nombre d'éléments dans cette page. |
meta.has_more |
booléen |
true s'il reste une page à lire. |
meta.next_after |
entier |
Valeur à passer dans after pour la page suivante. 0 quand le parcours est terminé. |
{
"data": [
{
"id": 3,
"name": "Printemps 2027",
"archived": false,
"date_creation": "2026-03-14T10:22:00+01:00",
"date_update": "2026-10-02T16:05:00+02:00"
}
],
"meta": {
"request_id": "3f9a1c0b7d2e4a61",
"count": 1,
"has_more": false,
"next_after": 0
}
}
Erreurs possibles
-
401
Clé absente, inconnue ou révoquée. Codes :
missing_key,invalid_key. -
403
Appel refusé pour ce compte ou cette clé. Codes :
api_not_activated,account_not_eligible,access_blocked,missing_scope. -
422
Un paramètre est absent, inconnu ou invalide. Code :
invalid_parameter. Le champfieldnomme le paramètre. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique combien de secondes attendre.
Une question ? contact@wanapos.com
