antongulin API Exploration with Temporary Tokens
When you're unsure about an API endpoint's behavior, response shape, or want to test a flow before committing to implementation — create a temporary token and run test calls directly.
Workflow
1. Create a temporary token
fusebase token create --feature <featureId>
This outputs a short-lived token (15 min) to stdout. Capture it:
TOKEN=$(fusebase token create --feature <featureId>)
The featureId comes from fusebase.json → features[].id.
2. Write and run test code
Create a temporary script (e.g. _test-api.ts) to make the API calls you want to verify:
const token = process.env.TOKEN || "<paste-token-here>";
const res = await fetch("https://api-endpoint/...", {
headers: { "x-app-feature-token": token },
});
console.log(res.status);
console.log(await res.json());
Run it:
TOKEN=$(fusebase token create --feature <featureId>) bun _test-api.ts
3. Inspect results and iterate
Read the output, adjust your calls, and re-run. Once you understand the API behavior, implement it properly in your feature code.
4. Clean up
Delete the temporary test script when done — don't commit it.
Example: Testing @fusebase/dashboard-service-sdk
Use this to verify SDK calls before wiring them into feature UI code.
_test-sdk.ts:
import {
createClient,
DatabasesApi,
CustomDashboardRowsApi,
} from "@fusebase/dashboard-service-sdk";
const token = process.env.TOKEN!;
const BASE_URL =
"https://app-api.{FUSEBASE_HOST}/v4/api/proxy/dashboard-service/v1";
const client = createClient({
baseUrl: BASE_URL,
defaultHeaders: { "x-app-feature-token": token },
});
const dbApi = new DatabasesApi(client);
const rowsApi = new CustomDashboardRowsApi(client);
// List databases visible to this feature
const dbs = await dbApi.listDatabases({});
console.log("databases:", JSON.stringify(dbs, null, 2));
// Read rows from a specific dashboard view
const rows = await rowsApi.getRows({
dashboardId: "<dashboardId>",
viewId: "<viewId>",
});
console.log("rows:", JSON.stringify(rows, null, 2));
Run it:
TOKEN=$(fusebase token create --feature <featureId>) bun _test-sdk.ts
Replace BASE_URL host with the value matching your environment's FUSEBASE_HOST (e.g. app-api.thefusebase.com for prod).
Key Points
- Token expires in 15 minutes. Create a new one if it expires.
- Use this for any Fusebase API call you want to validate — dashboard data, feature endpoints, etc.
- The API spec is available at the public OpenAPI endpoint if you need to discover available routes.
- Prefix test files with
_(e.g._test-sdk.ts) so they're easy to spot and clean up.