Apify (förhandsversion)
Apify kör webbskrapor och AI-agenter, hanterar aktörer och uppgifter, scheman och övervakar körningar, hämtar datauppsättningar och resultat och utlöser flöden från webhooks. Det möjliggör insamling, berikande och automatisering av data från slutpunkt till slutpunkt i arbetsflöden.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premie | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Standard | Alla Logic Apps-regioner utom följande: - Azure Government regioner – Regioner i Azure Kina - US Department of Defense (DoD) |
| Power Apps | Premie | Alla Power Apps-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premie | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Namn | Apify-stöd |
| URL | https://apify.com/contact |
| E-post | support@apify.com |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | Apify |
| Mer information om Apify finns. | https://docs.apify.com |
| Webbplats | https://apify.com |
| Sekretesspolicy | https://apify.com/privacy-policy |
| Kategorier | Data; Artificiell intelligens |
Apify
Apify är den största marknadsplatsen för verktyg för AI. Med Apify-anslutningsappen för Power Automate kan du köra webbskrapor och AI-agenter (kallas Aktörer), köra förkonfigurerade uppgifter, hämta strukturerade data från datauppsättningar och nyckelvärdeslager och utlösa automatiserade arbetsflöden när jobben är klara. Över 30 000 färdiga aktörer finns tillgängliga i Apify Store för vanliga användningsfall för skrapning och automatisering.
Utgivare
Apify Technologies s.r.o.
Förutsättningar
- Ett Apify-konto – registrera dig kostnadsfritt på apify.com. En kostnadsfri nivå med månatliga plattformskrediter ingår.
- OAuth 2.0-auktorisering – anslutningsappen autentiseras via Apifys OAuth-flöde. Slutanvändarna behöver inga API-token eller manuell konfiguration av autentiseringsuppgifter.
Hämta autentiseringsuppgifter
Anslutningsappen använder OAuth 2.0-autentisering. När du lägger till Apify-anslutningsappen i ett flöde och skapar en ny anslutning omdirigeras du automatiskt till Apify-konsolen för att auktorisera åtkomst. Följ de här stegen:
- I ditt Power Automate-flöde lägger du till valfri Apify-åtgärd eller utlösare.
- När du uppmanas att skapa en anslutning klickar du på Logga in.
- Du omdirigeras till auktoriseringssidan för Apify-konsolen på
console.apify.com. - Om du inte är inloggad på Apify anger du e-post och lösenord för Apify-kontot (eller använder Google/GitHub inloggning).
- Granska de begärda behörigheterna:
- profil – åtkomst till din användarprofilinformation
- full_api_access – fullständig åtkomst till Api:et Apify åt dig
- Klicka på Auktorisera för att bevilja anslutningsappen åtkomst.
- Du omdirigeras tillbaka till Power Automate med en aktiv anslutning.
Inga manuella inmatningar av API-token, klient-ID:n eller hemligheter krävs från slutanvändarna. Anslutningsappen hanterar tokenuppdatering automatiskt.
För Microsoft certifieringsgranskningsteamet
För att testa anslutningsappen behöver du ett Apify-konto. Du kan skapa ett kostnadsfritt på apify.com – inget kreditkort krävs. Den kostnadsfria nivån innehåller tillräckligt med plattformskrediter för att köra testaktörer och verifiera alla anslutningsåtgärder. När du har skapat ett konto följer du steg 1–7 ovan för att auktorisera anslutningsappen.
Åtgärder som stöds
Åtgärder
| Operation | Beskrivning |
|---|---|
| Kör aktör | Kör en Apify-aktör med angivna indata. Du kan välja bland nyligen använda aktörer eller bläddra i Apify Store. Du kan också vänta upp till 60 sekunder tills körningen har slutförts. Returnerar körningsmetadata, inklusive status, datamängds-ID och nyckelvärdeslagrings-ID. |
| Kör uppgift | Kör en förkonfigurerad aktörsaktivitet. Uppgifter lagrar standardindatakonfigurationer så att du kan köra dem utan att ange indata varje gång. Alternativt kan du åsidosätta standardindata med anpassade värden. |
| Skrapa enstaka URL | Skrapar en enda webbsida med hjälp av Apify Web Scraper Actor. Välj mellan anpassningsbara (rekommenderas), firefox huvudlös webbläsare eller Cheerio (rå HTTP) crawlningslägen. Returnerar körningsmetadata för spårning. |
| Hämta datamängdsobjekt | Hämtar objekt från en Apify-datauppsättning. Datauppsättningar lagrar strukturerade resultat från aktörskörningar. Stöder sidnumrering med gräns- och förskjutningsparametrar. Svarsschemat härleds dynamiskt från datamängdens innehåll. |
| Hämta nyckel/värde-arkivpost | Hämtar en post från ett apify-nyckelvärdearkiv med dess nyckel. Nyckelvärdeslager innehåller filer, konfigurationer och körningstillstånd. Svarsschemat härleds dynamiskt från postinnehållet. |
Triggers
| Operation | Beskrivning |
|---|---|
| Aktörskörningen är klar | Utlöses när en vald aktörskörning är klar. Prenumerera på specifika slutförandestatusar: lyckades, misslyckades, tidsgränsen överskrids eller avbröts. Alla statusar är aktiverade som standard. Utlösarnyttolasten innehåller fullständig körningsinformation och metadata. |
| Aktörsaktiviteten har slutförts | Utlöses när en vald aktörsaktivitetskörning har slutförts. Samma statusfiltreringsalternativ som utlösaren för aktörskörningen slutfördes. Användbart för övervakning av schemalagda eller återkommande aktivitetskörningar. |
Komma igång
Grundläggande arbetsflöde: Kör en aktör och få resultat
- Lägg till åtgärden Kör aktör i ditt flöde.
- Välj en aktör från dina nyligen använda aktörer eller från Apify Store.
- Ange den JSON-indata som krävs av aktören.
- Lägg till åtgärden Hämta datauppsättningsobjekt .
- Använd standarddatauppsättningens ID-utdata från steget Kör aktör som datauppsättningsparameter.
- Bearbeta de returnerade objekten i efterföljande flödessteg.
Händelsedrivet arbetsflöde: Reagera på slutförda körningar
- Lägg till utlösaren Aktörskörning slutförd som flödets utlösare.
- Välj den aktör som du vill övervaka.
- Välj vilka slutförandestatusar som ska utlösa flödet (alla aktiverade som standard).
- I efterföljande steg använder du utlösarnyttolasten för att komma åt körningsinformation och hämta resultat.
Arbetsflöde för snabbskrapa
- Lägg till åtgärden Skrapa enstaka URL .
- Ange den URL som du vill skrapa.
- Välj en crawlningstyp (Adaptive rekommenderas för de flesta webbplatser).
- Använd den slutförda utlösaren eller avsökningen aktörskörning för slutförande för att få resultat.
Kända problem och begränsningar
- Parametern Vänta på slut har högst 60 sekunder. För långvariga aktörer använder du den slutförda utlösaren För aktörskörning i stället för att vänta.
- Datauppsättningsscheman härleds dynamiskt från ett exempelobjekt. De kanske inte samlar in alla möjliga fält om datamängden innehåller objekt med varierande strukturer.
- Arkivpostscheman för nyckelvärde härleds från postinnehållet. Binära poster (bilder, PDF-filer) returneras as-is utan schemainferens.
- En enskild URL-åtgärd för Scrape använder en fast aktör (webbskrapa). För avancerade skrapningsscenarier använder du Kör aktör med en specialiserad aktör från Apify Store.
- Alternativen för minnesallokering varierar från 128 MB till 32 GB. Börja med standardinställningarna för att optimera kostnaderna.
Vanliga fel och åtgärder
| Error | Botemedel |
|---|---|
| Det går inte att autentisera | Kontrollera att du har ett aktivt Apify-konto. Prova att ta bort anslutningen och skapa en ny. |
| Aktörskörning returnerar statusEN MISSLYCKADES | Kontrollera om det finns detaljerade felmeddelanden i aktörskörningsloggarna i Apify-konsolen. Kontrollera att indata matchar aktörens förväntade format. |
| Datauppsättningen är tom när körningen har slutförts | Bekräfta att aktörskörningen har slutförts med statusEN LYCKADES. Målwebbplatsens struktur kan ha ändrats. |
| Tidsgränsen för flödet väntar på aktör | Ange "Vänta till slut" till 0 och använd utlösaren "Aktören har körts färdig" för att hantera långvariga aktörer asynkront. |
| Webhook-utlösare utlöses inte | Kontrollera att aktören eller uppgifts-ID:t är korrekt. Kontrollera att minst en händelsestatus är aktiverad. |
FAQ
Hur mycket kostar Apify? Själva anslutningsappen är kostnadsfri. Apify avgifter för plattformsanvändning baserat på beräkningstid och förbrukade resurser. En kostnadsfri nivå med månatliga krediter ingår i varje konto. Mer information finns i apify.com/pricing .
Vad är Skådespelare? Aktörer är serverlösa molnprogram som körs på Apify-plattformen. De kan utföra webbskrapa, dataextrahering, AI-automatisering med mera. Bläddra bland över 30 000 färdiga skådespelare på apify.com/store.
Vad är uppgifter? Uppgifter är sparade konfigurationer för Actors. De lagrar standardindatavärden så att du kan köra en aktör med förinställda parametrar utan att ange dem igen varje gång.
Användbara länkar
- Apify-dokumentation
- Api-referens för apify
- Apify Store – bläddra bland aktörer
- Apify prissättning
- Support och kontakt
- Community-forum
Åtgärder
| Hämta datamängdsobjekt |
Hämtar objekt från en av dina Apify-datauppsättningar med valfria sidnumreringsparametrar. |
| Hämta nyckel/värde-arkivpost |
Hämtar ett värde som lagras i nyckel/värde-arkivet under en specifik nyckel. |
| Kör aktör |
Kör en aktör och returnerar omedelbart utan att vänta på att körningen ska slutföras. Om du vill vänta tills körningen har slutförts använder du frågeparametern waitForFinish. |
| Kör uppgift |
Kör en aktörsaktivitet och returnerar omedelbart utan att vänta på att körningen ska slutföras. Om du vill vänta tills körningen har slutförts använder du frågeparametern waitForFinish. |
| Skrapa enstaka URL |
Skrapar en enda URL med hjälp av webbskrapaskådespelaren. Den här åtgärden startar en asynkron skrapning och returnerar körningsinformationen omedelbart. Använd utlösaren Aktörskörning slutförd för att bearbeta resultat när skrapet är klart. |
Hämta datamängdsobjekt
Hämtar objekt från en av dina Apify-datauppsättningar med valfria sidnumreringsparametrar.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Dataset
|
datasetId | True | string |
Välj den datauppsättning som objekt ska hämtas från. |
|
Limit
|
limit | integer |
Maximalt antal objekt som ska returneras. |
|
|
Offset
|
offset | integer |
Antal objekt att hoppa över från början av listan. |
Returer
Hämta nyckel/värde-arkivpost
Hämtar ett värde som lagras i nyckel/värde-arkivet under en specifik nyckel.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Store
|
storeId | True | string |
Välj det nyckel/värde-arkiv som posten ska hämtas från. |
|
Nyckel
|
recordKey | True | string |
Välj den nyckel som posten ska hämtas från. |
Returer
Kör aktör
Kör en aktör och returnerar omedelbart utan att vänta på att körningen ska slutföras. Om du vill vänta tills körningen har slutförts använder du frågeparametern waitForFinish.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Välj Aktör från
|
actorScope | True | string |
Välj den källa som ska sökas efter Aktörer från. |
|
Actor
|
actorId | True | string |
Aktörsidentifierare som ska köras. Ange aktörs-ID. |
|
Vänta på avslut (0–60 sekunder)
|
waitForFinish | integer |
Vänta tills körningen har slutförts i sekunder (0–60). |
|
|
Tidsgräns (sekunder)
|
timeout | integer |
Tidsgräns för körningen i sekunder. |
|
|
Build
|
build | string |
Aktörsversion som ska köras (tagg eller versionsnummer). Vanligtvis är det den "senaste". |
|
|
Minne (MB)
|
memory | integer |
Minnesgräns i MB (effekt 2, min 128). |
|
|
|
object |
Raw JSON-objekt som skickas som INDATA till aktören. |
Kör uppgift
Kör en aktörsaktivitet och returnerar omedelbart utan att vänta på att körningen ska slutföras. Om du vill vänta tills körningen har slutförts använder du frågeparametern waitForFinish.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Task
|
taskId | True | string |
Uppgiftsidentifierare som ska köras. |
|
Vänta på avslut (0–60 sekunder)
|
waitForFinish | integer |
Vänta tills körningen har slutförts i sekunder (0–60). |
|
|
Tidsgräns (sekunder)
|
timeout | integer |
Tidsgräns för körningen i sekunder. |
|
|
Build
|
build | string |
Aktörsversion som ska köras (tagg eller versionsnummer). Vanligtvis är det den "senaste". |
|
|
Minne (MB)
|
memory | integer |
Minnesgräns i MB (effekt 2, min 128). |
|
|
|
object |
Ett rå JSON-objekt som åsidosätter aktivitetens standardindata. |
Skrapa enstaka URL
Skrapar en enda URL med hjälp av webbskrapaskådespelaren. Den här åtgärden startar en asynkron skrapning och returnerar körningsinformationen omedelbart. Använd utlösaren Aktörskörning slutförd för att bearbeta resultat när skrapet är klart.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
URL till Scrape
|
url | True | string |
Den fullständiga URL:en för den enda sida som ska skrapas. Måste vara ett giltigt URL-format. |
|
Crawlningstyp
|
crawler_type | True | string |
Välj den crawlningsmotor som ska användas för att skrapa sidan. |
Utlösare
| Aktörsaktiviteten har slutförts |
Skapar en webhook för att prenumerera på aktivitetskörningshändelser för aktör. Utlöses när den valda aktivitetskörningen aktör avslutas med en specifik status. Alla statusar är aktiverade som standard. endast statusar som uttryckligen anges till false undantas. Minst en status måste vara aktiverad. |
| Aktörskörningen är klar |
Skapar en webhook för att prenumerera på aktörskörningshändelser. Utlöses när den valda aktörskörningen avslutas med en specifik status. Alla statusar är aktiverade som standard. endast statusar som uttryckligen anges till false undantas. Minst en status måste vara aktiverad. |
Aktörsaktiviteten har slutförts
Skapar en webhook för att prenumerera på aktivitetskörningshändelser för aktör. Utlöses när den valda aktivitetskörningen aktör avslutas med en specifik status. Alla statusar är aktiverade som standard. endast statusar som uttryckligen anges till false undantas. Minst en status måste vara aktiverad.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Statusar
|
eventTypes | array of string |
Status för aktörskörning som ska utlösas. |
|
|
Task
|
actorTaskId | True | string |
Välj den aktörsaktivitet som ska övervakas för händelser. |
|
Utlösaren vid körning lyckades
|
onRunSucceeded | boolean |
Utlösare när en aktörskörning lyckas. Standardvärdet är true om det inte anges. |
|
|
Utlösaren vid körning misslyckades
|
onRunFailed | boolean |
Utlösare när en aktörskörning misslyckas. Standardvärdet är true om det inte anges. |
|
|
Tidsgränsen för utlösare vid körning
|
onRunTimedOut | boolean |
Utlösare när tidsgränsen överskrids för en aktör. Standardvärdet är true om det inte anges. |
|
|
Utlösaren avbröts vid körning
|
onRunAborted | boolean |
Utlösare när en aktörskörning avbryts. Standardvärdet är true om det inte anges. |
Returer
Händelsenyttolast som skickas av webhook när en aktörskörning är klar.
- Webhook nyttolast
- WebhookPayloadSchema
Aktörskörningen är klar
Skapar en webhook för att prenumerera på aktörskörningshändelser. Utlöses när den valda aktörskörningen avslutas med en specifik status. Alla statusar är aktiverade som standard. endast statusar som uttryckligen anges till false undantas. Minst en status måste vara aktiverad.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Välj Aktör från
|
actorScope | True | string |
Välj den källa som ska sökas efter Aktörer från. |
|
Statusar
|
eventTypes | array of string |
Status för aktörskörning som ska utlösas. |
|
|
Actor
|
actorId | True | string |
Aktörsidentifierare som ska övervakas. Ange aktörs-ID. |
|
Utlösaren vid körning lyckades
|
onRunSucceeded | boolean |
Utlösare när en aktörskörning lyckas. Standardvärdet är true om det inte anges. |
|
|
Utlösaren vid körning misslyckades
|
onRunFailed | boolean |
Utlösare när en aktörskörning misslyckas. Standardvärdet är true om det inte anges. |
|
|
Tidsgränsen för utlösare vid körning
|
onRunTimedOut | boolean |
Utlösare när tidsgränsen överskrids för en aktör. Standardvärdet är true om det inte anges. |
|
|
Utlösaren avbröts vid körning
|
onRunAborted | boolean |
Utlösare när en aktörskörning avbryts. Standardvärdet är true om det inte anges. |
Returer
Händelsenyttolast som skickas av webhook när en aktörskörning är klar.
- Webhook nyttolast
- WebhookPayloadSchema
Definitioner
ActorRunResponseSchema
Fullständig information om en körd aktörskörning.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Aktörskörnings-ID
|
id | string |
Unik identifierare för aktörskörningen. |
|
Aktörs-ID
|
actId | string |
Unik identifierare för aktören som kördes. |
|
Användar-ID
|
userId | string |
Unik identifierare för den användare som äger aktörskörningen. |
|
Aktivitets-ID för aktör
|
actorTaskId | string |
Unik identifierare för aktörsaktiviteten (om körningen startades från en aktivitet). |
|
Startade på
|
startedAt | date-time |
Tidsstämpel när aktörskörningen startade. |
|
Klar vid
|
finishedAt | date-time |
Tidsstämpel när aktörskörningen är klar. |
|
Status
|
status | string |
Status för aktörskörningen (t.ex. SUCCEEDED, FAILED, RUNNING, ABORTED). |
|
Statusmeddelande
|
statusMessage | string |
Detaljerat statusmeddelande från aktörskörningen, inklusive bearbetning av sammanfattning och resultat. |
|
Är statusmeddelandeterminalen
|
isStatusMessageTerminal | boolean |
Om statusmeddelandet är terminal (slutligt) eller kan ändras under körningen. |
|
Metadata
|
meta | object |
Ytterligare metadata om aktörskörningen, inklusive information om ursprung och användaragent. |
|
Prisinformation
|
pricingInfo | object |
Detaljerad prisinformation, inklusive prismodell, händelser och kostnadsuppdelning. |
|
Statistik
|
stats | object |
Prestandastatistik, inklusive körning, minnesanvändning, CPU-användning och nätverkstrafik. |
|
Antal debiterade händelser
|
chargedEventCounts | object |
Antal fakturerbara händelser som inträffade under aktörskörningen. |
|
Options
|
options | object |
Konfigurationsalternativ som används för aktörskörningen (minne, timeout, versionsversion osv.). |
|
Bygg-ID
|
buildId | string |
Unik identifierare för aktörsversionen som används för den här körningen. |
|
Slutkod
|
exitCode | number |
Slutkod som returneras av aktörsprocessen (0 anger att den lyckades). |
|
Standardlagrings-ID för nyckelvärde
|
defaultKeyValueStoreId | string |
Unik identifierare för standardarkivet för nyckel/värde som är associerat med den här körningen. |
|
Standarddatauppsättnings-ID
|
defaultDatasetId | string |
Unik identifierare för standarddatauppsättningen där aktören lagrade sina resultat. |
|
Kö-ID för standardbegäran
|
defaultRequestQueueId | string |
Unik identifierare för standardbegärandekön som används av aktören. |
|
Byggnummer
|
buildNumber | string |
Versionsnummer för den aktörsversion som används för den här körningen. |
|
Container-URL
|
containerUrl | string |
URL för containern där aktörskörningen kördes. |
|
Är containerservern klar
|
isContainerServerReady | boolean |
Om containerservern är redo och tillgänglig. |
|
Git-grennamn
|
gitBranchName | string |
Namnet på Git-grenen som används för den här aktörskörningen (om tillämpligt). |
|
Användningssumma USD
|
usageTotalUsd | number |
Total kostnad för aktören körs i USD. |
WebhookPayloadSchema
Händelsenyttolast som skickas av webhook när en aktörskörning är klar.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
userId
|
userId | string |
ID för den användare som äger resursen som är associerad med händelsen. |
|
createdAt
|
createdAt | date-time |
Tidsstämpeln när händelsen inträffade. |
|
eventType
|
eventType | string |
Typen av händelse som utlöste webhooken (t.ex. ACTOR. KÖR. LYCKADES). |
|
actorId
|
eventData.actorId | string |
ID för den utlösande aktören. |
|
actorRunId
|
eventData.actorRunId | string |
ID för den specifika aktörskörningen som utlöste händelsen. |
|
Svar på aktörskörning
|
resource | ActorRunResponseSchema |
Fullständig information om en körd aktörskörning. |