# עבודה עם חוזי API

> תיעוד מקור. מקור: postman/README.md · 6a466bf.

This directory is the Git-reviewed API contract layer for LinkNodes Energy.

Cloud workspace: `Digital Ops's Workspace`

- OpenAPI spec: `LinkNodes Energy API`
- Production collection: `LinkNodes Energy — Production API`
- Production environment: `LinkNodes Energy — Production`
- Provider folders: Charging Providers, Fuel Providers, Payments & Webhooks, Mobile Client API

## Rules

- Provider credentials and customer secrets never go into committed Postman files.
- The current `/api/platform/*` surface stays browser-session/same-origin protected.
- Native iOS/Android uses a dedicated bearer-token client API rather than weakening browser protections.
- Every new provider integration should add a versioned contract, executable happy-path checks, error/failure simulations, webhook examples when relevant, and ownership notes.
- Read-only production checks may run in CI. Write tests must target an isolated environment or mock.

The Postman team currently blocks monitor creation through the connected API with HTTP 403, so scheduled Postman Monitor activation remains an account-permission gap. GitHub CI provides the active automated gate in the meantime.
