Oferty
Utwórz ofertę
Tworzy ofertę oczekującą bez jej publikowania.
POST
/offersoffers:writeZACHOWANIE
Zmiana zostanie zweryfikowana i utrwalona na koncie kluczowym przed udzieleniem odpowiedzi. Zapytaj zwrócony zasób jako źródło prawdy.
EFEKT
Może zmienić zasób i wyemitować odpowiednie zdarzenie domeny.
POWTÓRKA
W przypadku awarii sieci potwierdź stan zasobu przed ponowną próbą. Automatycznie ponawiaj tylko 429 i 5xx z cofaniem i jitterem.
Żądanie
urlstring · bodyOryginalny adres URL HTTPS produktu.uri · maxLength 2000obowiązkowetitlestring · bodyPubliczny tytuł oferty.minLength 3 · maxLength 240obowiązkowemarketplacestring · bodyRynek źródłowy.maxLength 40opcjonalnepricenumber · bodyAktualna cena.opcjonalneoriginal_pricenumber · bodyPoprzednia cena.opcjonalnecurrencystring · bodyWaluta ISO 4217.minLength 3 · maxLength 8 · default BRLopcjonalneimagestring · bodyAdres URL HTTPS obrazu.uriopcjonalnestorestring · bodyNazwa sklepu.opcjonalnecategorystring · bodyKategoria.opcjonalnecouponstring · bodyKod kuponu.opcjonalnecopystring · bodyTekst redakcyjny oferty.maxLength 6000opcjonalnestatusstring · bodyStan wyselekcjonowany.opcjonalneAuthorization
Bearer ach_live_...Accept
application/jsonZakres
offers:writePrzykład wykonywalny
curl
curl -X POST 'https://achadu.com/api/v1/offers' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
--data '{
"url": "https://example.com/product",
"title": "Air fryer 5L",
"marketplace": "string",
"price": 329.9,
"original_price": 329.9
}'Odpowiedź i błędy
Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.
201 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"
},
"created": true,
"request_id": "req_01J..."
}201Zasób został utworzony i utrwalony.400Nieprawidłowy parametr, treść lub przejście.401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.402Plan konta nie udostępnia tego interfejsu.403A chave precisa do escopo offers:write.404Funkcja nie istnieje na tym koncie.409Obecny stan uniemożliwia tę operację.413Treść JSON przekracza 128 KB.429Przekroczono okno 120 żądań na minutę.