# mapping: # allows to map fields from the remote format to the one expected by Homer
# title: 'id' # use value from field 'id' as title
# content: 'value' # value from field 'value' as content
- # refreshInterval: 10000 # time interval to refresh message
+ # refreshInterval: 10000 # Optional: time interval to refresh message
#
# Real example using chucknorris.io for showing Chuck Norris facts as messages:
# url: https://api.chucknorris.io/jokes/random
# background: red # optional color for card to set color directly without custom stylesheet
```
-If you choose to fetch message information from an endpoint, the output format should be:
+If you choose to fetch message information from an endpoint, the output format should be as follows (or you can [custom map fields as shown in tips-and-tricks](./tips-and-tricks.md#mapping-fields)):
```json
{
```yml
message:
url: https://api.chucknorris.io/jokes/random
- mapping:
- title: 'id'
- content: 'value'
+ mapping:
+ title: 'id'
+ content: 'value'
```
As you would see, using the ID as a title doesn't seem nice, that's why when a field is empty it would keep the default values, like this:
```yml
message:
url: https://api.chucknorris.io/jokes/random
- mapping:
- content: 'value'
+ mapping:
+ content: 'value'
title: "Chuck Norris Facts!"
```
```yml
message:
url: https://api.chucknorris.io/jokes/random
- mapping:
- content: 'value'
+ mapping:
+ content: 'value'
title: "Chuck Norris Facts!"
content: "Message could not be loaded"
```