API access Keys for outside systems.

The keys that outside systems use to read data from ERA: a timing service, the website of a championship, a results screen. Only a superadmin can open this page.

What it is for

When a supplier needs the entry list or other data of your championships in their own system, give them a key. The key opens only the championships you tick, and you can switch it off at any time.

Step by step

1. Open the list. Go to System › API access. Each row shows the Service, the Contact, the Championships and the Status.
2. Create a key. Click New API key. Write the Service and the Contact email of the supplier; the Website is optional.
3. Tick the championships. Under Championships tick the ones the service may read. Click Create the key.
4. Give the key to the supplier. The card shows the Key. Click Copy and send it to the supplier through a safe channel.
5. Switch it off. Set Status to Disabled: the key does not work and click Save. Set it back to Active when needed.
6. Replace the key. If the key may have been seen by others, click Create a new key and confirm. The old key stops working at once: give the new one to the supplier.
7. Delete it. In the list click the delete button and confirm. The service stops receiving data.

What ERA checks

• The service name and a valid contact email are required.
• At least one championship must be ticked.
• Whoever has the key reads the data of the ticked championships: keep it secret.
• Creating, saving and replacing a key are recorded in the Action log; the key itself is not.

Common problems

See also

• Action log