Retrieve a job screenshot

GET

/v1/scraper/jobs/{id}/screenshot

curl --request GET \
  --url http://localhost:8080/v1/scraper/jobs/example/screenshot \
  --header 'x-api-key: <x-api-key>'

• Dev (Bun.serve, défaut local).
• Remplacer par l'URL prod.

Retourne { url, expiresAt, mime, width, height, bytes } (JSON) par défaut. Avec ?redirect=1, renvoie un 302 Location: <presignedUrl> consommable directement par un <img>. Owner-check côté handler — non-admin sur job d’autrui = 404. Si pas de screenshot disponible (pas demandé OU fail-soft), 404. TTL court par défaut (APOPHIS_S3_PRESIGN_TTL_SECONDS, default 300 s) — ne pas cacher la réponse.

Authorizations

• apiKey

Parameters

Path Parameters

id

required

string

Query Parameters

redirect

string

Set 1 pour recevoir un 302 redirect au lieu du JSON.

Responses

200

URL signée pour télécharger le screenshot.

Media type application/json

object

Example ^generated

{}

302

Redirect vers la presigned URL.

401

Authentification manquante ou invalide.

Media type application/json

object

status

required

string

Allowed value: error

code

required

string

error

required

object

message

string

requestId

required

string

details

Array<object>

object

path

string

code

string

message

string

key

additional properties

Example

{
  "status": "error"
}

404

Ressource introuvable (ou hors-tenant).

Media type application/json

object

status

required

string

Allowed value: error

code

required

string

error

required

object

message

string

requestId

required

string

details

Array<object>

object

path

string

code

string

message

string

key

additional properties

Example

{
  "status": "error"
}

503

Dépendance critique (Postgres, Valkey) indisponible.

Media type application/json

object

status

required

string

Allowed value: error

code

required

string

error

required

object

message

string

requestId

required

string

details

Array<object>

object

path

string

code

string

message

string

key

additional properties

Example

{
  "status": "error"
}