Offres
Liste des offres
Répertoriez les offres avec des filtres de statut, de marché et de texte.
GET
/offersoffers:readCOMPORTEMENT
La lecture respecte les filtres et renvoie uniquement les ressources visibles par le compte lié à la clé.
EFFET
Ne modifie pas les ressources et ne déclenche pas la publication.
RÉPÉTITION
L’opération peut être répétée en toute sécurité. Sur 429 ou 5xx, utilisez l'intervalle exponentiel avec gigue.
Demande
limitinteger · queryQuantité par page.min 1 · max 100 · default 30facultatifoffsetinteger · queryDécalage de pagination.min 0 · default 0facultatifstatusstring · queryStatut organisé.facultatifmarketplacestring · queryMarché.facultatifquerystring · queryRecherchez par titre ou par magasin.facultatifAuthorization
Bearer ach_live_...Accept
application/jsonPortée
offers:readExemple d'exécutable
curl
curl 'https://achadu.com/api/v1/offers' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json'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": "off_01J...",
"marketplace": "amazon",
"title": "Air fryer 5L",
"url": "https://example.com/product",
"price": 329.9,
"currency": "BRL",
"review_status": "pending",
"created_at": "2026-08-31T18:20:00.000Z"
}
],
"pagination": {
"total": 1,
"limit": 30,
"offset": 0,
"has_more": false
},
"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 offers:read.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.