createAppToken
Create app token
Creates a new app token for metered public API access. This endpoint is unauthenticated — no session or credentials are required. The token is created in the `pending` state and a 6-digit verification code is emailed to the supplied address. The token value is **not** issued yet — confirm the code with `POST /app-token/verify` to activate the token and receive its value (shown only once). The server assigns a default read quota. The token grants access to public data only, metered by the read quota. Once active, pass the token via the `X-App-Token` header on subsequent requests.
/app-token
Usage and SDK Samples
curl -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
"https://meta24.metasolutions.se/app-token" \
-d '{
"name" : "my-data-app",
"email" : "owner@example.com"
}'
var api = new Entryscape.AppTokenApi();
api.createAppToken({name: 'my-data-app', email: 'owner@example.com'}, function(error, data) {
if (!error) {
console.log('Token ID:', data.id);
console.log('Status:', data.status);
// data.token is null until verified via POST /app-token/verify
console.log('Check', data.email, 'for the 6-digit verification code');
}
});
const api = new AppTokenApi(config);
const response = await api.createAppToken({
appTokenCreateRequest: { name: 'my-data-app', email: 'owner@example.com' },
});
console.log('Token ID:', response.id);
console.log('Status:', response.status);
// response.token is null until verified via POST /app-token/verify
console.log('Check', response.email, 'for the 6-digit verification code');
api_instance = entryscape_client.AppTokenApi()
response = api_instance.create_app_token(
app_token_create_request={'name': 'my-data-app', 'email': 'owner@example.com'}
)
print(f'Token ID: {response.id}')
print(f'Status: {response.status}')
# response.token is None until verified via POST /app-token/verify
print(f'Check {response.email} for the 6-digit verification code')
var apiInstance = new AppTokenApi();
var response = apiInstance.CreateAppToken(
appTokenCreateRequest: new AppTokenCreateRequest(name: "my-data-app", email: "owner@example.com")
);
Debug.WriteLine("Token ID: " + response.Id);
Debug.WriteLine("Status: " + response.Status);
// response.Token is null until verified via POST /app-token/verify
Debug.WriteLine("Check " + response.Email + " for the 6-digit verification code");
Scopes
Parameters
Body parameters
| Name | Description |
|---|---|
| appTokenCreateRequest * |
Responses