Sådan virker webhooks - Enrow API Documentation

Hvorfor bruge webhooks?

Webhooks lader resultaterne komme til dig, i stedet for at du gentagne gange spørger efter dem. I stedet for at polle et GET-endpoint, indtil en søgning er færdig, sender Enrow hvert resultat til din server i det øjeblik, det er klar — hvilket sparer requests, reducerer latens og holder din kode enkel. Stop med at spilde requests — lad resultaterne komme til dig. Fordi hvert Enrow-endpoint er asynkront, er webhooks den anbefalede måde at modtage resultater på på tværs af Email Finder, Email Verifier og Phone Finder. Webhooks omgår også rate limits helt, eftersom Enrow ringer til dig i stedet for omvendt.

Hvordan fungerer et webhook-flow?

Et webhook-flow forvandler en enkelt søgeforespørgsel til en automatisk levering. Du fortæller Enrow, hvor resultaterne skal sendes hen, og Enrow klarer resten:

Du sender en POST med en søgeforespørgsel med en webhook-URL i settings
Enrow returnerer et søge-ID med det samme
Enrow behandler søgningen i baggrunden
Når den er færdig, sender Enrow resultaterne med POST til din webhook-URL

Hvordan opsætter jeg en webhook?

Du kan registrere en webhook på to måder, afhængigt af om du vil bruge den til én søgning eller hver søgning:

Per request: Inkluder en webhook-URL i settings-objektet i ethvert API-kald
Globalt: Konfigurer en standard-webhook fra integrationssiden på dashboardet

{
  "fullname": "Dwight Schrute",
  "company_domain": "dundermifflin.com",
  "settings": {
    "webhook": "https://your-app.com/webhooks/enrow"
  }
}

Din webhook-URL skal være et gyldigt HTTPS-endpoint, der returnerer en 200-statuskode.

Hvilke events udløser et webhook-kald?

Seks typer events kan udløse et webhook-kald, én per endpoint og søgetype:

Event	Description
`single_search_finished`	En enkelt e-mailsøgning er afsluttet
`bulk_search_finished`	En bulk-e-mailsøgning er afsluttet
`verification_finished`	En enkelt e-mailverifikation er afsluttet
`bulk_verification_finished`	En bulk-e-mailverifikation er afsluttet
`single_phone_search_finished`	En enkelt telefonsøgning er afsluttet
`bulk_phone_search_finished`	En bulk-telefonsøgning er afsluttet

Hvordan ser en webhook-payload ud?

Webhook-payloaden afhænger af endpointet, og om søgningen var enkelt eller bulk. Enkelte søgninger leverer det fulde resultat direkte, mens bulk-søgninger leverer en færdigmeldings-notifikation, som du følger op på med en GET-forespørgsel.

Email Finder — Single

For enkelte søgninger modtager du det fulde resultat direkte i webhook-notifikationen. Dette fjerner behovet for at udføre en GET-forespørgsel.

{
  "event": "single_search_finished",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44dfrij84fjrt",
  "credits": {
    "cost": 1
  },
  "result": {
    "email": "dwight.schrute@dundermifflin.com",
    "qualification": "valid",
    "custom": "your_custom_data",
    "info": {
      "company_domain": "dundermifflin.com",
      "fullname": "Dwight Schrute",
      "firstname": "Dwight",
      "lastname": "Schrute"
    }
  }
}

Email Finder — Bulk

For bulk-søgninger modtager du en notifikation om, at batchen er færdig. Kald derefter endpointet GET /email/find/bulk med id for at hente resultaterne.

{
  "event": "bulk_search_finished",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44dfrij84fjrt",
  "credits": {
    "cost": 2284
  }
}

Email Verifier — Single

Det fulde resultat er inkluderet direkte — ingen GET-forespørgsel nødvendig.

{
  "event": "verification_finished",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44dfrij84fjrt",
  "email": "pam.beesly@dundermifflin.com",
  "qualification": "valid",
  "custom": "your_custom_data"
}

Email Verifier — Bulk

Dette er kun en notifikation. Kald GET /email/verify/bulk med id for at hente resultaterne.

{
  "event": "bulk_verification_finished",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44dfrij84fjrt",
  "credits": {
    "cost": 386.25
  }
}

Phone Finder — Single

Det fulde resultat er inkluderet direkte — ingen GET-forespørgsel nødvendig.

{
  "event": "single_phone_search_finished",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44dfrij84fjrt",
  "credits": {
    "cost": 50
  },
  "result": {
    "number": "+15705551234",
    "params": {
      "linkedin_url": "https://www.linkedin.com/in/michael-scott"
    },
    "qualification": "found"
  }
}

Phone Finder — Bulk

Dette er kun en notifikation. Kald GET /phone/bulk med id for at hente resultaterne.

{
  "event": "bulk_phone_search_finished",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44dfrij84fjrt"
}

Hvordan adskiller enkelte og bulk-webhooks sig?

Webhooks for enkelte søgninger indeholder det komplette resultat, så der er ikke behov for ekstra kald. Webhooks for bulk-søgninger signalerer kun, at batchen er færdig — derefter henter du resultaterne med det tilsvarende GET-endpoint.

Type	Single searches	Bulk searches
Payload	Fuldt resultat inkluderet	Kun notifikation (ID + credits)
GET nødvendig?	Nej	Ja — brug GET-endpointet med `id`

For enkelte søgninger indeholder webhooken alt, hvad du har brug for. For bulk-søgninger fortæller webhooken dig, at batchen er færdig — derefter henter du resultaterne.

Hvad er best practices for webhook-endpoints?

Et pålideligt webhook-endpoint svarer hurtigt, accepterer kun HTTPS og tolererer en lejlighedsvis dublet. Følg disse praksisser for at holde leveringer pålidelige:

Returnér 200 hurtigt

Behandl webhook-payloads asynkront. Returnér en 200 med det samme, og håndtér derefter dataene i et baggrundsjob.

Brug HTTPS

Brug altid HTTPS-endpoints. HTTP-webhooks vil blive afvist.

Håndtér dubletter

I sjældne tilfælde kan webhooks blive leveret mere end én gang. Brug id-feltet til at deduplikere.

Brug custom-felter

Send custom-data med i dine requests for at identificere, hvilken record et webhook-resultat hører til:

{
  "fullname": "Dwight Schrute",
  "company_domain": "dundermifflin.com",
  "custom": { "crm_id": "lead_001" }
}

custom-feltet returneres uændret i webhook-payloaden.

Skal jeg bruge webhooks eller polling?

Brug webhooks til produktion og polling kun til hurtig prototyping eller fejlfinding. Webhooks leverer resultater i realtid uden at forbruge din request-kvote, mens polling foretager gentagne GET-kald, der tæller mod dine rate limits.

	Webhooks	Polling (GET)
Latens	Realtid	Afhænger af poll-interval
API-kald	0 (Enrow ringer til dig)	Flere kald per søgning
Påvirkning af rate limit	Ingen	Forbruger kvote
Kompleksitet	Kræver opsætning af endpoint	Enklere at implementere

Vi anbefaler webhooks til produktionsbrug. Brug kun polling til hurtig prototyping eller fejlfinding.

FAQ

Koster webhooks ekstra credits?

Nej. Webhooks forbruger ikke yderligere credits — du betaler kun for selve søgningen. Credit-omkostningen rapporteres i credits.cost-feltet i payloaden. Se Credits og fakturering for omkostninger per endpoint.

Hvad sker der, hvis mit endpoint ikke returnerer en 200?

Din webhook-URL skal være et gyldigt HTTPS-endpoint, der returnerer en 200-statuskode. Hvis din server ikke kan nås eller svarer med en anden status, behandles leveringen som mislykket. Som reserveløsning kan du altid hente resultater ved at polle det relevante GET-endpoint med søgningens id.

Hvordan matcher jeg en webhook til den oprindelige request?

Brug id fra søgesvaret, eller send et custom-objekt med i din request — det returneres uændret i webhook-payloaden, så du kan mappe resultater tilbage til dine egne records, såsom et CRM-lead-ID.

Hvorfor modtog jeg ikke en webhook?

De mest almindelige årsager er en URL, der ikke er HTTPS, et endpoint, der ikke returnerer 200, eller en server, der timer ud. Bekræft, at dit endpoint er offentligt tilgængeligt over HTTPS. For bredere fejlfinding, se Fejlhåndtering og Statuskoder.

Næste skridt

Find en e-mail

Send en webhook-URL med i settings for at få resultatet leveret automatisk.

Hent bulk-resultater

Hent batch-resultater, efter at en bulk_search_finished-webhook er udløst.

Autentificering

Sådan sender du din API-nøgle i x-api-key-headeren.

Rate limits

Se hvorfor webhooks undgår den request-kvote, som polling forbruger.

​Hvorfor bruge webhooks?

​Hvordan fungerer et webhook-flow?

​Hvordan opsætter jeg en webhook?

​Hvilke events udløser et webhook-kald?

​Hvordan ser en webhook-payload ud?

​Email Finder — Single

​Email Finder — Bulk

​Email Verifier — Single

​Email Verifier — Bulk

​Phone Finder — Single

​Phone Finder — Bulk

​Hvordan adskiller enkelte og bulk-webhooks sig?

​Hvad er best practices for webhook-endpoints?

​Skal jeg bruge webhooks eller polling?

​FAQ

​Næste skridt

Find en e-mail

Hent bulk-resultater

Autentificering

Rate limits

Hvorfor bruge webhooks?

Hvordan fungerer et webhook-flow?

Hvordan opsætter jeg en webhook?

Hvilke events udløser et webhook-kald?

Hvordan ser en webhook-payload ud?

Email Finder — Single

Email Finder — Bulk

Email Verifier — Single

Email Verifier — Bulk

Phone Finder — Single

Phone Finder — Bulk

Hvordan adskiller enkelte og bulk-webhooks sig?

Hvad er best practices for webhook-endpoints?

Skal jeg bruge webhooks eller polling?

FAQ

Næste skridt