Lista era återförsäljare

GET /api/public/v1/retailers

Utvecklardokumentation: alla sidor

Börja

Hjälp och dokumentation

Ändringar

01Autentisering

Behörighet
api:read
Header

Authorization: Bearer YOUR_API_KEY eller X-API-Key: YOUR_API_KEY

Plan

Er plan måste omfatta API-åtkomst. Nyckeln knyter anropet till ert konto.

02Frågeparametrar

ParameterBeteende
limitStandardvärde 50. Värden begränsas till 1 till 200.
cursorSkicka föregående svars nextCursor oförändrat. Utelämna det på första sidan. En felaktig markör ger 400.

03Anrop

Shell · TEST
curl "https://api.test.stockisto.com/api/public/v1/retailers?limit=50" \
  -H "Authorization: Bearer $STOCKISTO_API_KEY"

04Svar

Ett varumärke ser aktiva anslutna återförsäljare med en tillåten, offentligt synlig plats. En återförsäljare ser sin egen aktiva post. Resultaten sorteras efter återförsäljar-id. Fortsätt tills nextCursor är null. Ett 200-svar har följande format; data innehåller tillgängliga poster:

JSON
{ "data": [], "nextCursor": null }
FältTyp och betydelse
data[].idUUID. Återförsäljarens id.
data[].nameSträng. Återförsäljarens namn.
data[].websiteSträng eller null.
data[].citySträng eller null.
data[].countrySträng eller null.
nextCursorOpak sträng eller null. Skicka tillbaka som cursor.

GET /api/public/v1/locations använder samma sidindelning och nyckel. Svaret innehåller synliga platser: id, retailerId, adress, kontaktuppgifter, koordinater och öppettider. Leverantörers resultat följer även relationens landsbegränsningar.

Shell · TEST
curl "https://api.test.stockisto.com/api/public/v1/locations?limit=50" \
  -H "Authorization: Bearer $STOCKISTO_API_KEY"

05Fel och gränser

SvarNästa steg
400Använd exakt det nextCursor som returnerades.
401Kontrollera giltighet och återkallelse. Prova nyckeln med /api/public/v1/ping.
402Läs feature_key i svaret och välj en plan med funktionen på Priser. Priser
403Använd en nyckel med api:read.
429Vänta enligt Retry-After; kontrollera anropsgränsen och månadskvoten.
503Gränskontrollen är otillgänglig. Försök efter Retry-After.

Standardgränsen är 300 anrop per minut och nyckel. Globala gränser och månadskvoten gäller också. Be oss höja nyckelns gräns.