Skip to content
Hub / App guides / Article

API keys & integrations (admin)

10 min read · 8 views

API settings — scoped keys for station tablets and integrations.
API settings — scoped keys for station tablets and integrations.

Overview

Advanced → API Settings manages API keys (used by station applets after provisioning). Integrations lists AI, MyPuppies, payment gateways, notifications, and Stripe financing panels.

Steps

  1. Provision applets from the device—admin JWT creates scoped keys automatically.
  2. Revoke keys when a tablet is lost or retired.
  3. Store integration secrets only in admin; never embed in public pages.
  4. Test MyPuppies push on one youngling before bulk sync.
  5. See MyPuppies integration and applet guides.

Practical note

API keys are passwords—treat provisioning like handing out office keys.

Admin setup

Changes here affect all staff—communicate maintenance windows.

Advanced options

Cross-link to matching app guide in the same module. Superadmin-only actions: platform host boundary.

Troubleshooting

Admin page 403: user lacks admin role—use breeder admin account.

Developer & API notes (members)

Station provisioning:

  • POST /api/v01/applets/provision.php — admin JWT; returns ApiKey credentials
  • GET /api/v01/applets/status.php — ApiKey auth
  • POST /api/v01/applets/revoke.php — admin JWT or ApiKey

API key CRUD: /api/v01/admin/api_keys/{fetch,save,delete}.php — kennel admin; superadmin permission names excluded from assignable list.

Integration settings: under /api/v01/integrations/*/settings/ per provider (AI, notifications, payment_gateways, stripe_financing, mypuppies).