DokumentationWorkflowsApps og tjenester
GitHub API-forespørgsel node
Fri forespørgsel til GitHub-API'et til det, de andre GitHub-blokke ikke dækker. Bruger din forbundne konto, kun stier under api.github.com. Se opsætning, input og output, testforløb og løsning af typiske fejl.
8 min. læsningOpdateret
Hvad noden gør
Fri forespørgsel til GitHub-API'et til det, de andre GitHub-blokke ikke dækker. Bruger din forbundne konto, kun stier under api.github.com.
Brug GitHub API-forespørgsel 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
- 01Åbn et workflow, og tilføj GitHub API-forespørgsel fra nodekataloget.
- 02Hvis din GitHub-konto ikke er forbundet endnu, så forbind den direkte i nodepanelet eller under Konnektorer.
- 03Udfyld de påkrævede felter, og knyt værdier fra tidligere trin.
- 04Kør noden med et lille testsæt, og kontrollér outputtet.
- 05Forbind det vellykkede output, og aktivér først efter en samlet test.
Handlinger og tilstande
Vælg den ønskede funktion i Handling. Panelet viser derefter de relevante indstillinger.
- Hent data (GET)
- Ændr data
Indstillinger
| Felt | Betydning | Område |
|---|---|---|
| Handling | Valg: Hent data (GET), Ændr data | Standard |
| Sti | Sti i GitHub-API'et, der starter med /, f.eks. /repos/octocat/hello-world/issues. | Standard |
| Forespørgselsparametre | Tilføjes som ?nøgle=værdi. | Standard |
| Metode | Valg: POST (opret), PUT (sæt), PATCH (ændr), DELETE (slet) | Standard |
| Indhold (JSON) | Forespørgslens JSON-indhold. | Standard |
| GitHub-konto | Lad feltet stå tomt, så bruger trinnet din forbundne GitHub-konto. | Standard |
| Kør én gang pr. element | Fra (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 |
| Hvis et element fejler | „Spring over“ skriver et `error`-felt for det fejlede element og fortsætter med resten i stedet for at miste hele kørslen på én ulæselig fil. | 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
| Input | Betydning | Type |
|---|---|---|
| Standard | Modtager hele resultatet fra det forrige trin. | JSON |
| Output | Betydning | Type |
|---|---|---|
| Standard | Gør resultatet tilgængeligt som JSON for næste trin. | JSON |
Noden kan behandle lister element for element. Fejlhåndtering og pause findes under avancerede indstillinger.
Eksempel og testkørsel
Hent egen konto: start med et lille og genkendeligt datasæt. Kontrollér outputtet, og brug kun felter, der faktisk findes.
Eksempel på testkørsel
{
"path": "/user"
}Adgang og sikkerhed
Noden arbejder med din egen forbundne GitHub-konto. Den ser og ændrer kun det, kontoen har lov til. Tjek de viste tilladelser, når du forbinder. Det passende område (Issues, Pull requests, Repos) skal også være slået til i indstillingerne for din GitHub-forbindelse under Konnektorer. Som standard er alle områder slået til.
"Tilladte handlinger" i indstillingerne for din GitHub-forbindelse under Konnektorer gælder også for denne node og tjekkes ved hver kørsel. Med "Kun læsning" eller "Læsning og kladder" kører kun de læsende handlinger: Hent data (GET). Disse handlinger kræver "Tillad ændringer": Ændr data.
Nøgler og loginoplysninger hører hjemme i Workflow-secrets eller i dine forbundne konti. Indsæt dem aldrig som almindelig tekst i workflow-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.
- Forbindelse afvist: opret forbindelsen igen med de nødvendige tilladelser.
- Handling blokeret: sæt "Tilladte handlinger" for forbindelsen under Konnektorer til "Tillad ændringer", eller vælg en læsende handling.
- Listen behandles kun én gang: aktivér kørsel pr. element.