Authentication and Connections

Understand API-key-only operations and operations that also require an APIFuse Connection.

Authentication and Connections

Every APIFuse gateway call uses your APIFuse API key. Some operations can run with only that key. Others also need a Connection because the provider requires account-specific authorization.

Authentication modes

Mode	What you provide	Common use
`none`	APIFuse API key	Public data or search operations
`credentials`	APIFuse API key and Connection ID	Operations that use a connected provider account

API-key-only operation

curl -X POST https://api.apifuse.com/v1/kakaomap/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Seoul Station"}'

Operation with a Connection

When an operation requires a Connection, include its af_con_<22-char> identifier:

curl -X POST https://api.apifuse.com/v1/catchtable/my-status \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-ApiFuse-Connection-Id: af_con_1234567890123456789012" \
  -H "Content-Type: application/json" \
  -d '{}'

Create and manage Connections in the APIFuse platform before calling protected operations.