Use Hoko with a custom API client
Call Hoko's unversioned REST resources from your application.
Before you start
Create a scoped key in Dashboard > Integrations > API Keys. Keep it in your server secret store. Use https://api.hoko.to.
Make your first request
Send the bearer key and read collections with GET https://api.hoko.to/collections. Use a returned collection ID with POST /links. Find a link with GET /links?externalId=... and send a unique request ID.
Verify the connection
Start with a read. Confirm the workspace and scopes. Save an external ID before a write. If a response is uncertain, read that external ID once and stop if the result is empty or ambiguous.
Fix common issues
- Use 401 for an invalid key.
- Use 403 for a missing scope.
- Use 429 for a rate limit.
- Honor Retry-After. Never retry an uncertain create blindly.
Disconnect
Remove the key from your secret store and revoke it in Hoko.
See the custom API reference at https://docs.hoko.to/custom-api.