API Links authentication

Sign API Link requests before external systems create link fetch jobs.

API Links are for internal tools, scripts, or platforms that need to trigger link resolution work. Authentication must prove the caller, protect against replay, dedupe retries, and let the relay queue desktop-executed jobs safely.

Direct answer

How are Link Peeler API Links authenticated?

Link Peeler API Links are authenticated with an API key, HMAC signature, timestamp, nonce, idempotency key, and JSON payload. The relay verifies freshness, replay controls, request shape, and quota before creating a job for desktop pickup.

Operational snapshot

What this page proves before production work begins.

API Links are for internal tools, scripts, or platforms that need to trigger link resolution work. Authentication must prove the caller, protect against replay, dedupe retries, and let the relay queue desktop-executed jobs safely.

Source state Desktop runtime Verified evidence
Search intent How are Link Peeler API Links authenticated?

Link Peeler API Links are authenticated with an API key, HMAC signature, timestamp, nonce, idempotency key, and JSON payload. The relay verifies freshness, replay controls, request shape, and quota before creating a job for desktop pickup.

Primary risk API key

Identifies the account and key prefix attached to the external caller.

First action Create payload

Include tracking URL, source, row ID, and idempotency key.

Decision hinge Caller proof

API key plus HMAC signature.

Search intent map

How this page maps search intent to the next useful action.

Each topic page is shaped around extractable answers, operational risk, workflow steps, and next-page routing so searchers do not hit a dead end after the first answer.

Direct answer

How are Link Peeler API Links authenticated?

Link Peeler API Links are authenticated with an API key, HMAC signature, timestamp, nonce, idempotency key, and JSON payload. The relay verifies freshness, replay controls, request shape, and quota before creating a job for desktop pickup.

Risk query

API key

Identifies the account and key prefix attached to the external caller.

Workflow query

Create payload

Include tracking URL, source, row ID, and idempotency key.

Decision query

Caller proof

API key plus HMAC signature.

Authentication fields

Each header controls a specific failure mode.

Generic webhook examples usually skip one of these controls. API Links make them part of the contract.

01

API key

Identifies the account and key prefix attached to the external caller.

02

Timestamp

Limits the validity window for old or delayed requests.

03

Nonce

Prevents the same signed request from being replayed.

04

HMAC signature

Proves the payload and headers were signed with the shared secret.

05

Idempotency key

Makes retries predictable for the same logical link fetch job.

06

Quota gate

Checks membership and plan limits before work enters the queue.

Signed request lifecycle

A signed request becomes queued work after validation.

The authentication flow protects the relay before the desktop ever receives the job.

01

Create payload

Include tracking URL, source, row ID, and idempotency key.

02

Generate controls

Create timestamp and nonce for the current request.

03

Sign body

Compute the HMAC over the exact timestamp, nonce, and JSON body.

04

Submit request

Send headers and body to the API Link endpoint.

05

Queue desktop work

After validation, the relay stores work for outbound desktop pickup.

Webhook vs API Links

API Links are stricter than generic webhooks by design.

The stricter contract matters because external requests can create paid-traffic operational work.

Decision point
Typical approach
Link Peeler approach
Caller proof
Shared token or unsigned endpoint.
API key plus HMAC signature.
Replay behavior
Retries can duplicate work.
Nonce and idempotency controls shape retries.
Execution
External caller may expect immediate worker access.
Relay queues work for outbound desktop pickup.
Implementation brief

The operational evidence this page gives searchers and operators.

Each topic page now repeats the core answer in several machine-readable shapes: risks, workflow checkpoints, and decision criteria. The content stays useful for humans while giving crawlers stronger entities and internal anchors.

Evidence checklist

Risks and requirements to verify.

  • API key Identifies the account and key prefix attached to the external caller.
  • Timestamp Limits the validity window for old or delayed requests.
  • Nonce Prevents the same signed request from being replayed.
  • HMAC signature Proves the payload and headers were signed with the shared secret.
  • Idempotency key Makes retries predictable for the same logical link fetch job.
  • Quota gate Checks membership and plan limits before work enters the queue.
Workflow checkpoints

How the work should move.

  • 01 - Create payload Include tracking URL, source, row ID, and idempotency key.
  • 02 - Generate controls Create timestamp and nonce for the current request.
  • 03 - Sign body Compute the HMAC over the exact timestamp, nonce, and JSON body.
  • 04 - Submit request Send headers and body to the API Link endpoint.
  • 05 - Queue desktop work After validation, the relay stores work for outbound desktop pickup.
Decision notes

Where Link Peeler changes the outcome.

  • Caller proof API key plus HMAC signature.
  • Replay behavior Nonce and idempotency controls shape retries.
  • Execution Relay queues work for outbound desktop pickup.
API Links auth FAQ

Questions about API Link authentication.

Where are API keys created?

API key creation stays inside the desktop client so local cache, device state, and cloud inventory remain aligned.

Why use nonce and idempotency together?

Nonce blocks replay of the same signed request. Idempotency makes intentional retries for the same logical job predictable.

Does an API Link call execute on the desktop immediately?

No. The relay validates and queues work. A linked desktop later pulls the job outbound.

Which template is related?

Use the API Link signing example for a copyable Node HMAC request skeleton.