Skip to content

Commit f998268

Browse files
Tidy up commit
1 parent 3a65d72 commit f998268

File tree

11 files changed

+168
-168
lines changed

11 files changed

+168
-168
lines changed

src/pages/docs/auth/capabilities.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ API keys and Ably-compatible tokens, have a set of capabilities assigned to them
77

88
API keys are long-lived, secret and typically not shared with clients. API key capabilities are configured using the [dashboard](https://ably.com/dashboard), or using the [Control API](/docs/platform/account/control-api).
99

10-
Ably-compatible tokens are designed to be shared with untrusted clients, are short-lived, and can be configured and issued programmatically. **For restricting client access to channels, tokens provide far more flexibility and security than API key capabilities.** See [selecting an authentication mechanism](/docs/auth#selecting-auth) to understand why token authentication is the preferred option in most scenarios.
10+
Ably-compatible tokens are designed to be shared with untrusted clients, are short-lived, and can be configured and issued programmatically. For restricting client access to channels, tokens provide far more flexibility and security than API key capabilities. See [selecting an authentication mechanism](/docs/auth#selecting-auth) to understand why token authentication is the preferred option in most scenarios.
1111

1212
### Capability changes and existing connections
1313

src/pages/docs/metadata-stats/stats.mdx

Lines changed: 32 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ curl --request GET \
4343
This endpoint returns a [statistics response type](#payload) including [account-only metrics](#account-only).
4444

4545
<Aside data-type='note'>
46-
To obtain your `ACCOUNT_ID`, you can use `/me` Control API endpoint to find your `ACCOUNT_ID`, or alternatively find it in the [**Settings**](https://ably.com/accounts/any/edit) page of your account dashboard:
46+
To obtain your `ACCOUNT_ID`, you can use `/me` Control API endpoint to find your `ACCOUNT_ID`, or alternatively find it in the [Settings](https://ably.com/accounts/any/edit) page of your account dashboard:
4747
</Aside>
4848

4949
<Code>
@@ -85,7 +85,7 @@ curl 'https://control.ably.net/v1/apps/${APP_ID}/stats' \
8585
This endpoint returns a [statistics response type](#payload).
8686

8787
<Aside data-type='note'>
88-
The `APP_ID` can be found in the [**Settings**](https://ably.com/accounts/any/apps/any/edit) tab of an application within your dashboard.
88+
The `APP_ID` can be found in the [Settings](https://ably.com/accounts/any/apps/any/edit) tab of an application within your dashboard.
8989
</Aside>
9090

9191
### App statistics via SDK <a id="app-sdk"/>
@@ -360,45 +360,45 @@ The following metadata is returned for each entry:
360360

361361
| Property | Description |
362362
| --- | --- |
363-
| **appId** | The ID of the Ably application the statistics are for. Only present when querying app statistics. |
364-
| **accountId** | The ID of the Ably account the statistics are for. Only present when querying account statistics. |
365-
| **intervalId** | Start time for the stats entry. Format is `yyyy-mm-dd:hh:mm` for `unit=minute`, and `yyyy-mm-dd:hh` for `unit=hour,day,month`. |
366-
| **unit** | Unit of time that the stats entry covers. One of `minute`, `hour`, `day` or `month`. |
367-
| **schema** | URI of the stats schema. |
368-
| **inProgress** | The last sub-interval included in this entry in the format `yyyy-mm-dd:hh:mm:ss`, else undefined. For entries that are still in progress, such as the current month. |
363+
| appId | The ID of the Ably application the statistics are for. Only present when querying app statistics. |
364+
| accountId | The ID of the Ably account the statistics are for. Only present when querying account statistics. |
365+
| intervalId | Start time for the stats entry. Format is `yyyy-mm-dd:hh:mm` for `unit=minute`, and `yyyy-mm-dd:hh` for `unit=hour,day,month`. |
366+
| unit | Unit of time that the stats entry covers. One of `minute`, `hour`, `day` or `month`. |
367+
| schema | URI of the stats schema. |
368+
| inProgress | The last sub-interval included in this entry in the format `yyyy-mm-dd:hh:mm:ss`, else undefined. For entries that are still in progress, such as the current month. |
369369

370370
### All messages <a id="messages"/>
371371

372372
All messages metrics include all messages types, such as those sent and received by Ably and clients, messages delivered via integrations and push notifications delivered to devices.
373373

374374
Failed vs. Refused messages:
375-
- **Failed** messages are those that did not succeed for reasons other than Ably actively rejecting them, such as external integration target rejections or Ably service issues.
376-
- **Refused** messages are those that Ably actively chose to reject, typically due to rate limiting, malformed messages, or insufficient client permissions.
375+
- Failed messages are those that did not succeed for reasons other than Ably actively rejecting them, such as external integration target rejections or Ably service issues.
376+
- Refused messages are those that Ably actively chose to reject, typically due to rate limiting, malformed messages, or insufficient client permissions.
377377

378378
| Metric | Description |
379379
| --- | --- |
380-
| **messages.all.all.count** | Total number of messages that were successfully received and sent by Ably, summed over all message types and transports. |
381-
| **messages.all.all.billableCount** | Total number of billable messages that were successfully received and sent by Ably, summed over all message types and transports. |
382-
| **messages.all.all.data** | Total data in messages successfully received and sent by Ably, summed over all message types and transports. |
383-
| **messages.all.all.uncompressedData** | Total data in messages successfully received and sent by Ably, excluding savings provided by delta compression. |
384-
| **messages.all.all.failed** | Total number of messages that failed. These are messages which did not succeed for some reason other than Ably explicitly refusing them, such as they were rejected by an external integration target, or a service issue on Ably's side. |
385-
| **messages.all.all.refused** | Total number of messages that were refused by Ably. For example, due to [rate limiting](/docs/platform/pricing/limits), malformed messages, or incorrect client permissions.|
386-
| **messages.all.messages.count** | Total message count, excluding presence and object messages. |
387-
| **messages.all.messages.billableCount** | Total billable message count, excluding presence and object messages. |
388-
| **messages.all.messages.data** | Total message size, excluding presence and object messages. |
389-
| **messages.all.messages.uncompressedData** | Total number of messages that failed. These are messages which did not succeed for some reason other than Ably explicitly refusing them, such as they were rejected by an external integration target, or a service issue on Ably's side. |
390-
| **messages.all.messages.failed** | Total number of messages excluding presence and object messages that failed. These are messages which did not succeed for some reason other than Ably explicitly refusing them, such as they were rejected by an external integration target, or a service issue on Ably's side. |
391-
| **messages.all.messages.refused** | Total number of messages excluding presence and object messages that were refused by Ably. For example, due to [rate limiting](/docs/platform/pricing/limits), malformed messages, or incorrect client permissions. |
392-
| **messages.all.presence.count** | Total presence message count. |
393-
| **messages.all.presence.billableCount** | Total billable presence message count. |
394-
| **messages.all.presence.data** | Total presence message size. |
395-
| **messages.all.presence.uncompressedData** | Total uncompressed presence message size, excluding delta compression. |
396-
| **messages.all.objects.count** | Total objects message count. |
397-
| **messages.all.objects.billableCount** | Total billable objects message count. |
398-
| **messages.all.objects.data** | Total objects message size. |
399-
| **messages.all.objects.uncompressedData** | Total uncompressed objects message size, excluding delta compression. |
400-
| **messages.all.messages.failed** | Total number of presence messages excluding presence and object messages that failed. These are messages which did not succeed for some reason other than Ably explicitly refusing them, such as they were rejected by an external integration target, or a service issue on Ably's side. |
401-
| **messages.all.messages.refused** | Total number of presence messages excluding presence and object messages that were refused by Ably. For example, due to [rate limiting](/docs/platform/pricing/limits), malformed messages, or incorrect client permissions. |
380+
| `messages.all.all.count` | Total number of messages that were successfully received and sent by Ably, summed over all message types and transports. |
381+
| `messages.all.all.billableCount` | Total number of billable messages that were successfully received and sent by Ably, summed over all message types and transports. |
382+
| `messages.all.all.data` | Total data in messages successfully received and sent by Ably, summed over all message types and transports. |
383+
| `messages.all.all.uncompressedData` | Total data in messages successfully received and sent by Ably, excluding savings provided by delta compression. |
384+
| `messages.all.all.failed` | Total number of messages that failed. These are messages which did not succeed for some reason other than Ably explicitly refusing them, such as they were rejected by an external integration target, or a service issue on Ably's side. |
385+
| `messages.all.all.refused` | Total number of messages that were refused by Ably. For example, due to [rate limiting](/docs/platform/pricing/limits), malformed messages, or incorrect client permissions.|
386+
| `messages.all.messages.count` | Total message count, excluding presence and object messages. |
387+
| `messages.all.messages.billableCount` | Total billable message count, excluding presence and object messages. |
388+
| `messages.all.messages.data` | Total message size, excluding presence and object messages. |
389+
| `messages.all.messages.uncompressedData` | Total number of messages that failed. These are messages which did not succeed for some reason other than Ably explicitly refusing them, such as they were rejected by an external integration target, or a service issue on Ably's side. |
390+
| `messages.all.messages.failed` | Total number of messages excluding presence and object messages that failed. These are messages which did not succeed for some reason other than Ably explicitly refusing them, such as they were rejected by an external integration target, or a service issue on Ably's side. |
391+
| `messages.all.messages.refused` | Total number of messages excluding presence and object messages that were refused by Ably. For example, due to [rate limiting](/docs/platform/pricing/limits), malformed messages, or incorrect client permissions. |
392+
| `messages.all.presence.count` | Total presence message count. |
393+
| `messages.all.presence.billableCount` | Total billable presence message count. |
394+
| `messages.all.presence.data` | Total presence message size. |
395+
| `messages.all.presence.uncompressedData` | Total uncompressed presence message size, excluding delta compression. |
396+
| `messages.all.objects.count` | Total objects message count. |
397+
| `messages.all.objects.billableCount` | Total billable objects message count. |
398+
| `messages.all.objects.data` | Total objects message size. |
399+
| `messages.all.objects.uncompressedData` | Total uncompressed objects message size, excluding delta compression. |
400+
| `messages.all.messages.failed` | Total number of presence messages excluding presence and object messages that failed. These are messages which did not succeed for some reason other than Ably explicitly refusing them, such as they were rejected by an external integration target, or a service issue on Ably's side. |
401+
| `messages.all.messages.refused` | Total number of presence messages excluding presence and object messages that were refused by Ably. For example, due to [rate limiting](/docs/platform/pricing/limits), malformed messages, or incorrect client permissions. |
402402

403403
### Inbound messages <a id="inbound"/>
404404

src/pages/docs/platform/account/app/api.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -43,10 +43,10 @@ Set resource restrictions to control access to channels and queues, ranging from
4343

4444
| Restriction | Description |
4545
| ----------- | ----------- |
46-
| **None** | No restrictions; access any channel or queue. |
47-
| **Only channels** | Access any channel but not queues. |
48-
| **Only queues** | Access any queue but not channels. |
49-
| **Selected channels and queues** | Specify explicit rules for access. |
46+
| None | No restrictions; access any channel or queue. |
47+
| Only channels | Access any channel but not queues. |
48+
| Only queues | Access any queue but not channels. |
49+
| Selected channels and queues | Specify explicit rules for access. |
5050

5151
When specifying selected channels and queues, you can provide a comma-separated list of resources. Each resource can match a single channel (e.g., `channel-name`) or multiple channels using wildcards (e.g., `namespace:*`). Queues use the prefix `[queue]` and meta channels use `[meta]`. See [capabilities documentation](/docs/auth/capabilities#wildcards) for detailed wildcard syntax.
5252

@@ -60,7 +60,7 @@ A single API key cannot support complex permission combinations, such as publish
6060

6161
| Option | Description |
6262
| ------ | ----------- |
63-
| **Revocable tokens** | Implement security measures by setting shorter token lifetimes and enabling the ability to revoke tokens issued by the API key. |
63+
| Revocable tokens | Implement security measures by setting shorter token lifetimes and enabling the ability to revoke tokens issued by the API key. |
6464

6565
### Change your API key settings
6666

src/pages/docs/platform/account/app/settings.mdx

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -17,33 +17,33 @@ The following provides an overview of your application settings.
1717
| **App ID** | This ID is automatically generated by Ably when you create an application. It is a critical part of your application's identity and is included in every API key and token issued for your application. |
1818
| **Name** | This is the user-defined name that you assigned when creating your application. It is helpful for quickly identifying the application among others in your dashboard, especially if you manage multiple applications. |
1919
| **Security** | Enabled by default, this option enforces Transport Layer Security (TLS) for all connections to your application. TLS protocol ensures data encryption and secure communication between clients and servers. |
20-
| **Enabled** | When an application is **disabled**, it no longer accepts new connections and deactivates all associated services. Clients cannot connect, send or receive messages, or use other Ably services. When **enabled**, the application allows new connections and activates all related services. |
20+
| **Enabled** | When an application is disabled, it no longer accepts new connections and deactivates all associated services. Clients cannot connect, send or receive messages, or use other Ably services. When enabled, the application allows new connections and activates all related services. |
2121

2222
### Channel rule configuration
2323

2424
The following explains the configuration rules for specific [namespaces](/docs/channels#namespaces) or [channels](/docs/channels):
2525

2626
| Section | Description |
2727
| ------- | ----------- |
28-
| **Namespace or channel ID** | Identify the specific namespace or channel to which this rule will apply. |
29-
| **Persist last message** | Stores the last message published on a channel for 365 days, accessible via the rewind mechanism. |
30-
| **Persist all messages** | Ably stores all messages for two minutes by default. Depending on your account package, this can be increased to 24 or 72 hours. It is also possible to persist the last message sent to a channel for a year. |
31-
| **Identified** | Requires clients to authenticate with a client ID to interact with channels in this namespace. |
32-
| **TLS only** | Restricts access to channels within this namespace to clients connected using TLS. |
33-
| **Push notifications enabled** | Enables publishing messages with a push payload, triggering native push notifications to registered devices. |
34-
| **Message interactions enabled** | Enables unique time serial fields in messages, enabling typed references between messages (e.g., implementing 'Likes' in a chat). |
35-
| **Server-side batching enabled** | Batches inbound messages on the server side before sending them to subscribers based on the configured policy. |
36-
| **Cancel** | Discards changes and closes the dialog without saving the new rule.|
28+
| Namespace or channel ID | Identify the specific namespace or channel to which this rule will apply. |
29+
| Persist last message | Stores the last message published on a channel for 365 days, accessible via the rewind mechanism. |
30+
| Persist all messages | Ably stores all messages for two minutes by default. Depending on your account package, this can be increased to 24 or 72 hours. It is also possible to persist the last message sent to a channel for a year. |
31+
| Identified | Requires clients to authenticate with a client ID to interact with channels in this namespace. |
32+
| TLS only | Restricts access to channels within this namespace to clients connected using TLS. |
33+
| Push notifications enabled | Enables publishing messages with a push payload, triggering native push notifications to registered devices. |
34+
| Message interactions enabled | Enables unique time serial fields in messages, enabling typed references between messages (e.g., implementing 'Likes' in a chat). |
35+
| Server-side batching enabled | Batches inbound messages on the server side before sending them to subscribers based on the configured policy. |
36+
| Cancel | Discards changes and closes the dialog without saving the new rule.|
3737

3838
### Protocol adapter settings
3939

4040
The following explains the configuration support for various communication protocols ([Pusher](/docs/protocols/pusher), [PubNub](/docs/protocols/pubnub), [MQTT](/docs/protocols/mqtt)), enabling different client libraries to interact with Ably.
4141

4242
| Settings | Description |
4343
| --------- | ----------- |
44-
| **Pusher protocol support** | Provides compatibility with the Pusher protocol. |
45-
| **PubNub protocol support** | Provides compatibility with the PubNub protocol. |
46-
| **MQTT protocol support** | Provides compatibility with the MQTT protocol. |
44+
| Pusher protocol support | Provides compatibility with the Pusher protocol. |
45+
| PubNub protocol support | Provides compatibility with the PubNub protocol. |
46+
| MQTT protocol support | Provides compatibility with the MQTT protocol. |
4747

4848
### Actions
4949

0 commit comments

Comments
 (0)