Schemalagd URL-avfrågning

En webhook väntar normalt på att någon ska anropa den. Med ett schema är det appen som sköter anropet: den hämtar en URL som du anger med ett fast intervall och skickar svaret till samma webhook, så att ditt Shopify Flow-arbetsflöde körs enligt en tidsplan från vilket API som helst som returnerar JSON, formulärdata eller XML.

Vanliga användningsområden: hämta en leverantörs lageruppdateringar var 15:e minut, kontrollera ett ERP-system för nya beställningar varje timme eller läsa av en statusändpunkt en gång om dagen och låta Shopify Flow vidta åtgärder utifrån detta.

Att sätta upp en

För en ny webhook väljer du ”Skapa webhook” och svarar på frågan ”Vad ska utlösa denna webhook?” med ”Ingenting - kör den enligt ett schema”. Webhooken skapas med en hemlig token, så att ingen annan kan anropa dess URL, och öppnas på fliken Schema. För en webhook som du redan har, öppna den och gå till fliken Schema. Fyll sedan i:

Fält	Vad den gör
Aktiverad	Aktiverar schemat. Webhook-URL:en fortsätter att fungera oavsett vilket.
URL	Adressen som ska hämtas. Endast http och https, och den måste vara tillgänglig från det offentliga internet.
Intervall	Var 5:e, 15:e eller 30:e minut, var 1:a, 3:e, 6:e eller 12:e timme, eller en gång om dagen.
Läge	Varje hämtning utlöser Shopify Flow vid varje körning. Endast när svaret ändras utlöses det, och endast om innehållet skiljer sig från föregående körning.
Begäran-rubriker	Valfritt, för en API-nyckel eller ett bärartoken. Lagras i krypterad form och visas aldrig igen.

Den första körningen sker inom en minut efter att funktionen har aktiverats.

Kartläggning av insatsen

Den hämtade datastrukturen behandlas av webhooken på exakt samma sätt som en förfrågan som någon har skickat till dig: den analyseras utifrån innehållstyp, din fältmappning väljer ut de värden som Shopify Flow-tjänsten tar emot, och uppdelning i arrayer tillämpas om den är inställd.

Eftersom API:et själv bestämmer hur svaret ska se ut, hoppar schemalagda körningar över kontrollen av ”oväntade fält” som gäller för JSON-data som skickas från dina egna system. Du behöver bara mappa de värden som är viktiga för dig.

{
  "updated_at": "2026-09-17T08:00:00Z",
  "items": [
    { "sku": "ABC-1", "stock": 4 },
    { "sku": "ABC-2", "stock": 0 }
  ]
}

Koppla updated_at till ett Shopify Flow-fält för att kunna använda det i ditt arbetsflöde. För att hantera varje artikel separat ställer du in delningsvägen till items under Avancerade inställningar - varje element startar då sin egen Shopify Flow-körning. Se Datastrukturer och uppdelning av arrayer.

Kör nu

”Kör nu” utför en faktisk körning omedelbart: funktionen hämtar URL:en, visar HTTP-statusen, en förhandsgranskning av svaret och vad som hände (utlöst, oförändrat eller fel), och utlöser Shopify Flow om svaret är användbart. Använd den efter att du har ändrat URL:en eller rubrikerna istället för att vänta på nästa intervall.

Endast när svaret ändras

I det här läget jämför appen det hämtade dokumentet med det föregående och aktiverar endShopify Flow om det skiljer sig åt. Använd det för API-gränssnitt som returnerar samma dokument tills något faktiskt ändras, till exempel en lager- eller statusuppdatering. Jämförelsen gäller hela dokumentet, så ett API som inkluderar en tidsstämpel eller ett förfrågnings-ID i varje svar kommer att se annorlunda ut varje gång.

När ett schema misslyckas

I statusblocket på fliken visas den senaste körningen, den senaste HTTP-statusen, nästa körning och det senaste felet.

• Ett nätverksfel, en statuskod som inte är 2xx eller ett svar som inte går att tolka räknas som ett misslyckat körningsförsök och utlöser inte Shopify Flow.
• Efter 20 misslyckade försök i rad avbryter schemat sig själv och meddelar detta, istället för att fortsätta försöka nå en inaktiv URL i all oändlighet. Korrigera URL:en eller inloggningsuppgifterna och aktivera den igen.
• Att nå gränsen för ditt abonnemang räknas inte som ett misslyckande. Dessa körningar blockeras och visas på instrumentpanelen.

Vad appen inte hämtar

Endast offentliga adresser. Interna och privata adresser (localhost, privata adressintervall, slutpunkter för molnmetadata) avvisas, även om en omdirigering pekar mot en sådan. Svar får högst vara 1 MB stora och ta högst 10 sekunder, och högst 3 omdirigeringar följs. Dina rubriker tas bort om en omdirigering leder till en annan webbplats.

Var schemalagda körningar visas

I ”History”, med källan ”Scheduled”. Allt annat fungerar som vanligt: nyttolasten, resultatet från Shopify Flow-utlösaren, omförsök och uppspelning.