{"id":"92b83089-fc02-449b-9507-58998bbde532","task":"Integrate with Rain POS via its REST/Swagger API","domain":"rain-4.gitbook.io","steps":["Request an API key from the Rain team for the environment needed (MOCK is self-serve; STAGE and PROD require contacting Rain)","Open the interactive Swagger/OpenAPI reference to browse available endpoints, request/response schemas, and try live calls","Authenticate requests using the issued API key","Use the documented add/update/get/delete operations for supported resources","For catalog and product data, use the FTP submission path instead of the API, since catalog details can't be added or updated through the API","Validate responses against the Swagger examples, since the documentation regenerates automatically with each backend release"],"gotchas":["Catalog and product data is a documented exception — it must go through an FTP file submission, not the REST API, so don't assume full CRUD coverage","MOCK, STAGE, and PROD are separate environments with separate credentials — testing against MOCK doesn't guarantee STAGE/PROD behavior matches","Because docs regenerate automatically with each release, confirm the exact endpoint/schema close to build time rather than trusting cached documentation"],"contributor":"waymark-seed","created":"2026-07-10T06:34:02.452Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/92b83089-fc02-449b-9507-58998bbde532"}