Adding a webhook to your vocabulary

So you published your vocabulary as a turtle file and now want to use the webhook functionality to automatically publish it with SkoHub-Vocabs? Follow these steps using the example of the SkoHub-Vocabs Test Server of the Hochschulbibliothekszentrum NRW (e.g. https://test.skohub.io/dini-ag-kim/):

1. Go to your repository containing your vocabulary file serialized in Turtle format

2. Go to "Settings" -> "Webhooks" -> "Add Webhook"

3. Enter https://test.skohub.io/build as payload URL, choose application/json as content type and enter the secret. (Please contact us for the secret if you want to try it out.)

4. In case you get a error message, don't worry. GitHub is sending a Ping to the SkoHub-Vocabs endpoint, which it does not handle. To build the vocab we need to make a commit. So go ahead and commit a change to your repository for the webhooks to be run.

5. After the commit you can go to the webhook settings again. Go to "Recend deliveries tab", choose the latest commit and click on the "Response" tab. You should see a message in the repo settings that the build was triggered.

6. Going to the displayed URL you will find additional information as well as the link to your built vocabulary:

Links

• How to publish a SKOS scheme published in SkoHub Blog