Example request
xcrun simctl io booted screenshot captures/home.png curl -X POST https://api.appscreenshotapi.com/v1/renders \ -H "Authorization: Bearer $APPSCREENSHOTAPI_KEY" \ --data @store-screenshots.json
Implementation checklist
- Store APPSCREENSHOTAPI_KEY in the platform secret manager.
- Run the render step after real simulator, device, or builder captures exist.
- Use an Idempotency-Key tied to the release tag or commit SHA.
- Archive returned images, lint JSON, or the Fastlane ZIP for review.
Where the API fits
Xcode Simulator should own building the app and collecting real screenshots. appscreenshotapi owns the repeatable store-asset render: frames, captions, canvases, localization, linting, and ZIP output.
This keeps visual generation outside the build runner while still letting release automation regenerate every asset from one checked-in request file.
Failure and approval behavior
Treat official lint failures as release blockers. If the API returns a billing URL, stop and show it to a human rather than attempting autonomous payment.