# Swile Corporate Gateway API

> Public REST API for corporate clients (HR/admin tools) to integrate with Swile: manage branches,
> work groups, employees, benefit orders, and physical card logistics.

Authentication is HTTP Basic on `GET /api/v1/auth/login` to obtain a JWT (valid 120 minutes), then
`Authorization: Bearer <token>` on every other `/api/**` call. There is no self-service signup -
credentials (username/password and a corporateId) are provisioned by Swile beforehand.

## Docs

- [Integration Guide](/docs/integration-guide.html): step-by-step guide with curl examples for every
  flow (authentication, creating branches, work groups, employees, the three ways to create an
  order, requesting a physical card), enum value tables (employee status, payment methods, wallet
  codes, shipment tracking status), and sequence diagrams for each flow.
- [OpenAPI spec](/v3/api-docs): machine-readable, generated live from the running application -
  always reflects the current API exactly.
- [Swagger UI](/swagger-ui/index.html): interactive reference and request explorer, also live.

## Environments

- Production: https://corporate-gateway.swile.com.br
- Staging: https://corporate-gateway-staging.swile.com.br