FazerCards Glossary

REST API

An HTTP API following REST conventions (resources at stable URLs, JSON bodies, standard verbs) — the contract type FazerCards exposes at /api/v2.

REST API stands for representational state transfer over HTTP. Resources (catalog, order, balance) live at stable URLs, GET reads them, POST creates orders. FazerCards' public surface is REST: JSON in/out, X-Api-Key for auth, predictable status codes (200/201/4xx/5xx). REST is preferred over GraphQL for this domain because the operations are simple and the client is usually a backend, not a UI consuming a typed schema.

Key facts

  • Base URL: https://api.fzr.cards/api/v2
  • OpenAPI spec at /public/docs
  • Authentication: X-Api-Key header
  • Errors follow a uniform JSON shape with code + message

See also