DokumentationWorkflowsApps og tjenester

HTTP node

Kalder en ekstern URL, f.eks. et API, en anden webhook eller en MCP-server. Auth, body, headers og query-parametre kan udfyldes fra templates. Svar-body'en parses automatisk som JSON. Se opsætning, input og output, testforløb og løsning af typiske fejl.

10 min. læsningOpdateret

Hvad noden gør

Kalder en ekstern URL, f.eks. et API, en anden webhook eller en MCP-server. Auth, body, headers og query-parametre kan udfyldes fra templates. Svar-body'en parses automatisk som JSON.

Brug HTTP som et klart afgrænset trin i et anymize-workflow.

  • Behandler 1 input.
  • Leverer 1 output til efterfølgende trin.
  • Kører som et normalt trin i forløbet.

Opsæt noden

  1. 01Åbn et workflow, og tilføj HTTP fra nodekataloget.
  2. 02Udfyld de påkrævede felter, og knyt værdier fra tidligere trin.
  3. 03Kør noden med et lille testsæt, og kontrollér outputtet.
  4. 04Forbind det vellykkede output, og aktivér først efter en samlet test.

Handlinger og tilstande

HTTP har én klart afgrænset opgave. Indstillingerne vises, når du vælger noden.

Indstillinger

FeltBetydningOmråde
MetodeValg: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONSStandard
URLIndstil værdien i nodepanelet.Standard
GodkendelseHvordan det eksterne API godkender. Token / nøgle / adgangskode kommer i det tilsvarende felt nedenfor.Standard
Adgangsdata fra workflow-secretVælg workflow-secret'et med token, API-nøgle eller Basic Auth-adgangskode. Klarteksten kommer aldrig ind i workflow-JSON'en.Beskyttet
Navn på nøgle-feltetHvad feltet hedder, hvor API'et forventer din nøgle. Står som regel i API-dokumentationen, ofte X-API-Key.Standard
Navn på nøgle-parameteret i URL'enHvad parameteret i URL'en hedder, som bærer din nøgle, f.eks. ?api_key=… . Står i API-dokumentationen.Standard
BrugernavnIndstil værdien i nodepanelet.Standard
Query-parametreFøjes til URL'en som ?key=value. Eksisterende query-strenge i URL'en bevares.Standard
HeadersNøgle/værdi-par som felter. Authorization sættes automatisk via Auth-feltet ovenfor, her kun custom-headers.Standard
Body-formatHvordan body'en overføres. 'Form' til ældre API'er, der forventer felter som formulardata; 'Rå' til XML eller ren tekst. I tvivl: Automatisk.Standard
BodyNo-code-editor: tilføj felt + værdi, typen (tekst/tal/boolean/JSON) genkendes automatisk. Øverst til højre kan du skifte til rå JSON.Standard
Læs svaret somJSON stopper workflowet, hvis svaret ikke indeholder gyldige strukturerede data.Standard
Send videreNår en liste modtages, kan det næste trin behandle hver post separat.Standard
Navn på tekst eller filDet næste trin finder teksten eller filen under dette navn. Strukturerede JSON-data beholder deres egne feltnavne.Standard
ImportkontraktIndstil værdien i nodepanelet.Standard
Importeret dataformatIndstil værdien i nodepanelet.Standard
Følg omdirigeringerÅbner den nye adresse ved omdirigering. Slå fra for at sende det første svar videre.Standard
Ved HTTP-fejl„Kør videre" lader workflowet køre videre selv ved 4xx/5xx eller netværksfejl, du tjekker $json.ok og reagerer (retry, fallback, log).Standard
Afbryd efter (millisekunder)Afbryder forespørgslen, hvis modparten tager for lang tid. I millisekunder (1000 = 1 sekund). Maks. 30000 (30 sekunder).Standard
Maks. svar-størrelse (bytes)Større svar afbrydes, så workflowet ikke overbelastes. Angives i bytes (5000000 = 5 MB). Standard 5 MB, maksimum 10 MB.Standard
Kør én gang pr. elementFra (standard): noden kører én gang for hele inputtet. Til: får den flere elementer (f.eks. fra „Del liste op“), kører den én gang PR. element, og {{ $json }} er så præcis dette element. Sådan arbejder du en filliste igennem post for post.Standard
Pause mellem elementer (millisekunder)Ventetid før hver kørsel undtagen den første. 1000 = 1 sekund pr. element. Nyttigt, hvis modparten ellers begrænser dig. Maksimalt 300000 (5 minutter).Standard

Input og output

InputBetydningType
urlMål-URL. Tilsidesætter konfig-feltet.text
bodyRequest-body.json
OutputBetydningType
bodyIndstil værdien i nodepanelet.json
statusHTTP-statuskode.number
oktrue ved 2xx, ellers false.boolean
headersSvar-headers (små bogstaver i keys).json

Eksempel og testkørsel

API-GET med Bearer-token: start med et lille og genkendeligt datasæt. Kontrollér outputtet, og brug kun felter, der faktisk findes.

Eksempel på testkørsel

{
  "query": "anymize",
  "limit": 10
}

Adgang og sikkerhed

Gennemgå hvilke data der kommer ind i trinnet, og hvad outputtet indeholder.

Gem nøgler og loginoplysninger i den beskyttede forbindelsesstyring. Indsæt dem aldrig i almindelige felter, testdata eller beskrivelser.

Løs typiske fejl

  • Intet output: kontrollér den seneste kørsel og felterne fra den forrige node.
  • Tom variabel: åbn outputtet fra det forrige trin, og brug et felt fra de faktiske testdata.