Verontschuldiging (preview)

Apify voert web-scrapers en AI-agents uit, beheert Actors en taken, plant en bewaakt uitvoeringen, haalt gegevenssets en resultaten op en activeert stromen van webhooks. Het maakt end-to-end gegevensverzameling, verrijking en automatisering mogelijk in werkstromen.

Deze connector is beschikbaar in de volgende producten en regio's:

Service Class Regio's
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logische apps Standard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contact
Naam Verontschuldig ondersteuning
URL https://apify.com/contact
E-mailadres support@apify.com
Connectormetagegevens
Uitgever Goedkeuren
Meer informatie over Apify. https://docs.apify.com
Website https://apify.com
Privacybeleid https://apify.com/privacy-policy
Categorieën Gegevens; AI

Goedkeuren

Apify is de grootste marketplace met hulpprogramma's voor AI. Met de Apify-connector voor Power Automate kunt u web-scrapers en AI-agents (actors) uitvoeren, vooraf geconfigureerde taken uitvoeren, gestructureerde gegevens ophalen uit gegevenssets en sleutel-waardearchieven en geautomatiseerde werkstromen activeren wanneer taken zijn voltooid. Meer dan 30.000 kant-en-klare actoren zijn beschikbaar in Apify Store voor veelvoorkomende scraping- en automatiseringsgebruiksscenario's.

Uitgever

Apify Technologies s.r.o.

Prerequisites

  • Een Apify-account - meld u gratis aan op apify.com. Een gratis laag met maandelijks platformtegoed is inbegrepen.
  • OAuth 2.0-autorisatie : de connector wordt geverifieerd via de OAuth-stroom van Apify. Er zijn geen API-tokens of handmatige configuratie van referenties nodig voor eindgebruikers.

Referenties ophalen

De connector maakt gebruik van OAuth 2.0-verificatie. Wanneer u de Apify-connector aan een stroom toevoegt en een nieuwe verbinding maakt, wordt u automatisch omgeleid naar apify-console om toegang te verlenen. Volg deze stappen:

  1. Voeg in uw Power Automate stroom een apify-actie of trigger toe.
  2. Wanneer u wordt gevraagd een verbinding te maken, klikt u op Aanmelden.
  3. U wordt omgeleid naar de autorisatiepagina van de Apify-console op console.apify.com.
  4. Als u niet bent aangemeld bij Apify, voert u het e-mailadres en wachtwoord van uw Apify-account in (of gebruikt u Google/GitHub aanmelding).
  5. Controleer de aangevraagde machtigingen:
    • profiel - toegang tot uw gebruikersprofielgegevens
    • full_api_access - volledige toegang tot de Api namens u
  6. Klik op Autoriseren om de connector toegang te verlenen.
  7. U wordt teruggeleid naar Power Automate met een actieve verbinding.

Er is geen handmatige vermelding van API-tokens, client-id's of geheimen vereist voor eindgebruikers. De connector verwerkt token automatisch vernieuwen.

Voor het Microsoft certificeringsbeoordelingsteam

Als u de connector wilt testen, hebt u een Apify-account nodig. U kunt er gratis een maken op apify.com - er is geen creditcard vereist. De gratis laag bevat voldoende platformtegoed om test actors uit te voeren en alle connectorbewerkingen te verifiëren. Nadat u een account hebt gemaakt, volgt u de stappen 1-7 hierboven om de connector te autoriseren.

Ondersteunde bewerkingen

Acties

Operation Beschrijving
Actor uitvoeren Voert een Apify Actor uit met de opgegeven invoer. U kunt een keuze maken uit onlangs gebruikte actors of door Apify Store bladeren. Wacht eventueel tot 60 seconden totdat de uitvoering is voltooid. Retourneert uitvoermetagegevens, inclusief status, gegevensset-id en sleutelwaardearchief-id.
Taak uitvoeren Voert een vooraf geconfigureerde Actor-taak uit. In taken worden standaardinvoerconfiguraties opgeslagen, zodat u deze kunt uitvoeren zonder dat u elke keer invoer hoeft op te geven. U kunt desgewenst de standaardinvoer overschrijven met aangepaste waarden.
Eén URL scrapen Hiermee wordt één webpagina verwijderd met behulp van de Apify Web Scraper Actor. Kies tussen adaptieve (aanbevolen), Firefox headless browser of Cheerio (onbewerkte HTTP) verkenningsmodi. Retourneert de uitvoermetagegevens voor het bijhouden.
Gegevenssetitems ophalen Hiermee worden items opgehaald uit een Apify-gegevensset. Gegevenssets slaan gestructureerde resultaten van Actor-uitvoeringen op. Ondersteunt paginering met limiet- en offsetparameters. Het antwoordschema wordt dynamisch afgeleid van de inhoud van de gegevensset.
Sleutel-waardearchiefrecord ophalen Haalt een record op uit een Sleutel-waardearchief apify door de sleutel. Sleutelwaarde slaat bewaringsbestanden, configuraties en uitvoeringsstatus op. Het antwoordschema wordt dynamisch afgeleid van de recordinhoud.

Triggers

Operation Beschrijving
Actoruitvoering voltooid Wordt geactiveerd wanneer een geselecteerde Actor-uitvoering is voltooid. Abonneren op specifieke voltooiingsstatussen: geslaagd, mislukt, time-out of afgebroken. Alle statussen zijn standaard ingeschakeld. De nettolading van de trigger bevat volledige uitvoeringsdetails en metagegevens.
Actortaak voltooid Wordt geactiveerd wanneer de uitvoering van een geselecteerde Actor-taak is voltooid. Dezelfde opties voor statusfiltering als de trigger voor de uitvoering van actor voltooid. Handig voor het bewaken van geplande of terugkerende taakuitvoeringen.

Aan de slag

Basiswerkstroom: Een actor uitvoeren en resultaten ophalen

  1. Voeg de actie Actor uitvoeren toe aan uw stroom.
  2. Selecteer een actor in uw onlangs gebruikte actors of in apify Store.
  3. Geef de invoer-JSON op die vereist is voor de actor.
  4. Voeg de actie Gegevenssetitems ophalen toe.
  5. Gebruik de uitvoer van de standaardgegevensset-id uit de stap Actor uitvoeren als de parameter Gegevensset.
  6. De geretourneerde items verwerken in de volgende stroomstappen.

Gebeurtenisgestuurde werkstroom: Reageren op voltooide uitvoeringen

  1. Voeg de uitvoering van de actor voltooide trigger toe als de trigger van de stroom.
  2. Selecteer de actor die u wilt bewaken.
  3. Kies welke voltooiingsstatussen de stroom moeten activeren (standaard alle ingeschakeld).
  4. In de volgende stappen gebruikt u de nettolading van de trigger voor toegang tot uitvoeringsdetails en het ophalen van resultaten.

Snelle scrapewerkstroom

  1. Voeg de enkele URL-actie Knipsel toe.
  2. Voer de URL in die u wilt scrapen.
  3. Selecteer een verkenningstype (Adaptief wordt aanbevolen voor de meeste sites).
  4. Gebruik de uitvoering van actor voltooide trigger of poll voor voltooiing om resultaten op te halen.

Bekende problemen en beperkingen

  • De parameter Wachten op Voltooien heeft maximaal 60 seconden. Voor langlopende Actors gebruikt u de uitvoering van de actor voltooide trigger in plaats van te wachten.
  • Gegevenssetschema's worden dynamisch afgeleid van een voorbeelditem. Ze leggen mogelijk niet alle mogelijke velden vast als de gegevensset items met verschillende structuren bevat.
  • Recordschema's voor sleutel-waardeopslag worden afgeleid van de recordinhoud. Binaire records (afbeeldingen, PDF-bestanden) worden geretourneerd as-is zonder schemadeductie.
  • De actie Scrape single URL maakt gebruik van een vaste Actor (Web Scraper). Voor geavanceerde scrapingscenario's gebruikt u Run Actor met een gespecialiseerde Actor uit Apify Store.
  • Opties voor geheugentoewijzing variëren van 128 MB tot 32 GB. Begin met de standaardinstellingen om de kosten te optimaliseren.

Veelvoorkomende fouten en oplossingen

Fout Remedy
Kan niet verifiëren Zorg ervoor dat u een actief Apify-account hebt. Verwijder de verbinding en maak een nieuwe.
Actoruitvoering retourneert DE STATUS FAILED Controleer de actoruitvoeringslogboeken in de Apify-console voor gedetailleerde foutberichten. Controleer of de invoer overeenkomt met de verwachte indeling van de actor.
De gegevensset is leeg nadat de uitvoering is voltooid Bevestig dat de actoruitvoering is voltooid met de status SUCCEEDED. De structuur van de doelwebsite kan zijn gewijzigd.
Time-out voor stroom die wacht op Actor Stel 'Wachten op einde' in op 0 en gebruik de trigger 'Actor run finished' om langlopende Actors asynchroon te verwerken.
Webhook-trigger wordt niet geactiveerd Controleer of de actor- of taak-id juist is. Controleer of ten minste één gebeurtenisstatus is ingeschakeld.

Veelgestelde vragen

Hoeveel kost Apify? De connector zelf is gratis. Verontschuldig de kosten voor platformgebruik op basis van de verbruikte rekentijd en resources. Een gratis laag met maandelijks tegoed is inbegrepen bij elk account. Zie apify.com/pricing voor meer informatie.

Wat zijn acteurs? Actors zijn serverloze cloudprogramma's die worden uitgevoerd op het Apify-platform. Ze kunnen webschroot, gegevensextractie, AI-automatisering en meer uitvoeren. Blader door meer dan 30.000 kant-en-klare actors op apify.com/store.

Wat zijn taken? Taken worden opgeslagen configuraties voor Actors. Ze slaan standaardinvoerwaarden op, zodat u een Actor met vooraf ingestelde parameters kunt uitvoeren zonder ze telkens opnieuw in te voeren.

Acties

Actor uitvoeren

Voert een Actor uit en keert onmiddellijk terug zonder te wachten tot de uitvoering is voltooid. Als u wilt wachten tot de uitvoering is voltooid, gebruikt u de queryparameter waitForFinish.

Eén URL scrapen

Hiermee wordt één URL geknipt met behulp van de Web Scraper Actor. Met deze actie wordt een asynchrone scrape gestart en worden de uitvoeringsdetails onmiddellijk geretourneerd. Gebruik de trigger Actor run finished om resultaten te verwerken zodra de scrape is voltooid.

Gegevenssetitems ophalen

Hiermee worden items opgehaald uit een van uw Apify-gegevenssets met optionele pagineringsparameters.

Sleutel-waardearchiefrecord ophalen

Hiermee haalt u een waarde op die is opgeslagen in het sleutel-waardearchief onder een specifieke sleutel.

Taak uitvoeren

Voert een Actor-taak uit en retourneert onmiddellijk zonder te wachten tot de uitvoering is voltooid. Als u wilt wachten tot de uitvoering is voltooid, gebruikt u de queryparameter waitForFinish.

Actor uitvoeren

Voert een Actor uit en keert onmiddellijk terug zonder te wachten tot de uitvoering is voltooid. Als u wilt wachten tot de uitvoering is voltooid, gebruikt u de queryparameter waitForFinish.

Parameters

Name Sleutel Vereist Type Description
Actor selecteren in
actorScope True string

Selecteer de bron waaruit u in Actors wilt zoeken.

Actor
actorId True string

Actor-id die moet worden uitgevoerd. Actor-id van supply.

Wachten op voltooien (0-60 seconden)
waitForFinish integer

Wacht tot de uitvoering in seconden is voltooid (0-60).

Timeout (seconden)
timeout integer

Time-out voor de uitvoering in seconden.

Build
build string

Actor-build die moet worden uitgevoerd (tag of buildnummer). Meestal is het de 'nieuwste'.

Geheugen (MB)
memory integer

Geheugenlimiet in MB (macht van 2, min. 128).

object

Onbewerkt JSON-object doorgegeven als INPUT aan de Actor.

Eén URL scrapen

Hiermee wordt één URL geknipt met behulp van de Web Scraper Actor. Met deze actie wordt een asynchrone scrape gestart en worden de uitvoeringsdetails onmiddellijk geretourneerd. Gebruik de trigger Actor run finished om resultaten te verwerken zodra de scrape is voltooid.

Parameters

Name Sleutel Vereist Type Description
URL naar scrape
url True string

De volledige URL van de ene pagina die moet worden verwijderd. Moet een geldige URL-indeling zijn.

Verkenningstype
crawler_type True string

Selecteer de verkenningsengine die u wilt gebruiken voor het scrapen van de pagina.

Gegevenssetitems ophalen

Hiermee worden items opgehaald uit een van uw Apify-gegevenssets met optionele pagineringsparameters.

Parameters

Name Sleutel Vereist Type Description
Dataset
datasetId True string

Selecteer de gegevensset waaruit u items wilt ophalen.

Limit
limit integer

Maximum aantal te retourneren items.

Offset
offset integer

Het aantal items dat moet worden overgeslagen vanaf het begin van de lijst.

Retouren

De uitvoer van deze bewerking is dynamisch.

Sleutel-waardearchiefrecord ophalen

Hiermee haalt u een waarde op die is opgeslagen in het sleutel-waardearchief onder een specifieke sleutel.

Parameters

Name Sleutel Vereist Type Description
Store
storeId True string

Selecteer het sleutel-waardearchief waaruit u de record wilt ophalen.

Sleutel
recordKey True string

Selecteer de sleutel waaruit u de record wilt ophalen.

Retouren

De uitvoer van deze bewerking is dynamisch.

Taak uitvoeren

Voert een Actor-taak uit en retourneert onmiddellijk zonder te wachten tot de uitvoering is voltooid. Als u wilt wachten tot de uitvoering is voltooid, gebruikt u de queryparameter waitForFinish.

Parameters

Name Sleutel Vereist Type Description
Task
taskId True string

Taak-id die moet worden uitgevoerd.

Wachten op voltooien (0-60 seconden)
waitForFinish integer

Wacht tot de uitvoering in seconden is voltooid (0-60).

Timeout (seconden)
timeout integer

Time-out voor de uitvoering in seconden.

Build
build string

Actor-build die moet worden uitgevoerd (tag of buildnummer). Meestal is het de 'nieuwste'.

Geheugen (MB)
memory integer

Geheugenlimiet in MB (macht van 2, min. 128).

object

Een onbewerkt JSON-object om de standaardinvoer van de taak te overschrijven.

Triggers

Actortaak voltooid

Hiermee maakt u een webhook om u te abonneren op actortaakuitvoeringsevenementen. Triggers wanneer de geselecteerde Actor-taakuitvoering is voltooid met een specifieke status. Alle statussen zijn standaard ingeschakeld; alleen statussen die expliciet zijn ingesteld op false, worden uitgesloten. Ten minste één status moet ingeschakeld blijven.

Actoruitvoering voltooid

Hiermee maakt u een webhook om u te abonneren op actoruitvoeringsevenementen. Triggers wanneer de geselecteerde Actor-uitvoering is voltooid met een specifieke status. Alle statussen zijn standaard ingeschakeld; alleen statussen die expliciet zijn ingesteld op false, worden uitgesloten. Ten minste één status moet ingeschakeld blijven.

Actortaak voltooid

Hiermee maakt u een webhook om u te abonneren op actortaakuitvoeringsevenementen. Triggers wanneer de geselecteerde Actor-taakuitvoering is voltooid met een specifieke status. Alle statussen zijn standaard ingeschakeld; alleen statussen die expliciet zijn ingesteld op false, worden uitgesloten. Ten minste één status moet ingeschakeld blijven.

Parameters

Name Sleutel Vereist Type Description
Statussen
eventTypes array of string

Uitvoeringsstatussen van actor om aan te activeren.

Task
actorTaskId True string

Selecteer de actortaak om te controleren op gebeurtenissen.

Trigger bij uitvoering voltooid
onRunSucceeded boolean

Trigger wanneer een Actor-uitvoering slaagt. De standaardwaarde is waar als deze niet is ingesteld.

Trigger bij uitvoering mislukt
onRunFailed boolean

Trigger wanneer een Actor-uitvoering mislukt. De standaardwaarde is waar als deze niet is ingesteld.

Trigger bij time-out van uitvoering
onRunTimedOut boolean

Trigger wanneer er een time-out optreedt voor een actor. De standaardwaarde is waar als deze niet is ingesteld.

Trigger bij uitvoering afgebroken
onRunAborted boolean

Trigger wanneer een Actor-uitvoering wordt afgebroken. De standaardwaarde is waar als deze niet is ingesteld.

Retouren

Nettolading van gebeurtenis die wordt verzonden door webhook wanneer een Actor-uitvoering is voltooid.

Webhook-gegevens
WebhookPayloadSchema

Actoruitvoering voltooid

Hiermee maakt u een webhook om u te abonneren op actoruitvoeringsevenementen. Triggers wanneer de geselecteerde Actor-uitvoering is voltooid met een specifieke status. Alle statussen zijn standaard ingeschakeld; alleen statussen die expliciet zijn ingesteld op false, worden uitgesloten. Ten minste één status moet ingeschakeld blijven.

Parameters

Name Sleutel Vereist Type Description
Actor selecteren in
actorScope True string

Selecteer de bron waaruit u in Actors wilt zoeken.

Statussen
eventTypes array of string

Uitvoeringsstatussen van actor om aan te activeren.

Actor
actorId True string

Actor-id die moet worden bewaakt. Actor-id van supply.

Trigger bij uitvoering voltooid
onRunSucceeded boolean

Trigger wanneer een Actor-uitvoering slaagt. De standaardwaarde is waar als deze niet is ingesteld.

Trigger bij uitvoering mislukt
onRunFailed boolean

Trigger wanneer een Actor-uitvoering mislukt. De standaardwaarde is waar als deze niet is ingesteld.

Trigger bij time-out van uitvoering
onRunTimedOut boolean

Trigger wanneer er een time-out optreedt voor een actor. De standaardwaarde is waar als deze niet is ingesteld.

Trigger bij uitvoering afgebroken
onRunAborted boolean

Trigger wanneer een Actor-uitvoering wordt afgebroken. De standaardwaarde is waar als deze niet is ingesteld.

Retouren

Nettolading van gebeurtenis die wordt verzonden door webhook wanneer een Actor-uitvoering is voltooid.

Webhook-gegevens
WebhookPayloadSchema

Definities

ActorRunResponseSchema

Volledige informatie over een uitgevoerde Actor-uitvoering.

Name Pad Type Description
Id van actoruitvoering
id string

Unieke id van de actoruitvoering.

Actor-id
actId string

Unieke id van de actor die is uitgevoerd.

Gebruikers-ID
userId string

De unieke id van de gebruiker die eigenaar is van de Actor-uitvoering.

Actor-taak-id
actorTaskId string

Unieke id van de Actor-taak (als de uitvoering is gestart vanaf een taak).

Gestart bij
startedAt date-time

Tijdstempel wanneer de Actor-uitvoering is gestart.

Voltooid op
finishedAt date-time

Tijdstempel wanneer de actor is uitgevoerd.

Status
status string

Status van de actoruitvoering (bijvoorbeeld GESLAAGD, MISLUKT, UITVOEREN, AFGEBROKEN).

Statusbericht
statusMessage string

Gedetailleerd statusbericht van de Actor-uitvoering, inclusief de verwerking van samenvatting en resultaten.

Is statusberichtterminal
isStatusMessageTerminal boolean

Of het statusbericht terminal (definitief) is of tijdens de uitvoering kan worden gewijzigd.

Metadata
meta object

Aanvullende metagegevens over de Actor-uitvoering, inclusief informatie over oorsprong en gebruikersagent.

Prijsinformatie
pricingInfo object

Gedetailleerde prijsinformatie, waaronder prijsmodel, gebeurtenissen en uitsplitsing van kosten.

Statistieken
stats object

Prestatiestatistieken, waaronder runtime, geheugengebruik, CPU-gebruik en netwerkverkeer.

Aantal in rekening gebrachte gebeurtenissen
chargedEventCounts object

Het aantal factureerbare gebeurtenissen dat is opgetreden tijdens de uitvoering van de actor.

Opties
options object

Configuratieopties die worden gebruikt voor de Actor-uitvoering (geheugen, time-out, buildversie, enzovoort).

Build-id
buildId string

De unieke id van de Actor-build die voor deze uitvoering wordt gebruikt.

Afsluitcode
exitCode number

Afsluitcode die wordt geretourneerd door het Actor-proces (0 geeft aan dat het is gelukt).

Standaard-sleutel-waardearchief-id
defaultKeyValueStoreId string

Unieke id van het standaardarchief met sleutelwaarden dat aan deze uitvoering is gekoppeld.

Standaardgegevensset-id
defaultDatasetId string

Unieke id van de standaardgegevensset waarin de Actor de resultaten heeft opgeslagen.

Standaardwachtrij-id van aanvraag
defaultRequestQueueId string

Unieke id van de standaardaanvraagwachtrij die door de actor wordt gebruikt.

Buildnummer
buildNumber string

Buildnummer van de Actor-versie die voor deze uitvoering wordt gebruikt.

Container-URL
containerUrl string

URL van de container waarop de Actor-uitvoering is uitgevoerd.

Is containerserver gereed
isContainerServerReady boolean

Of de containerserver gereed en toegankelijk is.

Naam van Git-vertakking
gitBranchName string

Naam van de Git-vertakking die wordt gebruikt voor deze Actor-uitvoering (indien van toepassing).

Gebruikstotaal USD
usageTotalUsd number

Totale kosten van de actoruitvoering in USD.

WebhookPayloadSchema

Nettolading van gebeurtenis die wordt verzonden door webhook wanneer een Actor-uitvoering is voltooid.

Name Pad Type Description
gebruikers-ID
userId string

Id van de gebruiker die eigenaar is van de resource die is gekoppeld aan de gebeurtenis.

gemaaktOp
createdAt date-time

De tijdstempel waarop de gebeurtenis heeft plaatsgevonden.

eventType
eventType string

Het type gebeurtenis dat de webhook heeft geactiveerd (bijvoorbeeld ACTOR. UITVOEREN. GESLAAGD).

actorId
eventData.actorId string

Id van de triggerende actor.

actorRunId
eventData.actorRunId string

Id van de specifieke Actor-uitvoering die de gebeurtenis heeft geactiveerd.

Antwoord van actoruitvoering
resource ActorRunResponseSchema

Volledige informatie over een uitgevoerde Actor-uitvoering.