Intent
Deliver a reliable integration via scripts with clear inputs and outputs.
When to use
- Integration scope is small or early-stage.
- A full platform is unnecessary.
- You need fast delivery with minimal overhead.
Core mechanics
- Authenticate to external APIs.
- Transform and map data.
- Apply updates with retries and logging.
Implementation checklist
- Document credentials and authentication flow.
- Define mapping rules and validation.
- Implement rate limiting and retries.
- Add logging and error reporting.
- Provide a dry-run mode when possible.
Failure modes and mitigations
- API changes -> monitor versions and update mappings.
- Rate limits -> implement backoff.
- Partial updates -> add idempotency and retries.
Observability and validation
- Request/response logs and error rates.
- Counts of records processed and updated.
Artifacts
- Config file and mapping docs.
- Run logs and summary reports.