HTTP Endpoints (inbound)

Inbound HTTP for Caffeine AI Motoko backends via mo:caffeineai-http-endpoints.

When to use which skill

Need	Skill
External client (`curl`, webhook, bot) hits the canister over HTTPS	this skill
Canister calls an external HTTPS API	`extension-http-outcalls`
Typed OpenAI / Google / X / Stripe client	the matching domain skill (those wrap outbound calls)

Do not implement inbound handlers with the management-canister http_request / Call.httpRequest outcall API — that is the opposite direction.

Client hits the backend Motoko canister over HTTPS (not *.caffeine.xyz, custom domain, or frontend/asset canister).
The HTTP Gateway calls http_request (query).
Mutating routes return Http.upgrade() so the gateway re-issues as http_request_update (update).