API-reference

Webhooks

Webhook endpoints, their deliveries and the event types they can receive.

List webhook event types

GET/webhooks/event-types

Lists every event type a webhook can receive, with what it means, the scopes a subscription to it needs, its payload's JSON schema and an example.

Scopes: webhooks:read

Svar

200 The types. WebhookEventTypeList
Felter
- dataWebhookEventType[]
  The types.
  Vis felterne
  - typestring
    The type: attendee.registered and the others.
  - summarystring eller null
    In a few words.
  - descriptionstring eller null
    When it is sent and what it carries.
  - scopesstring[]
    The scopes a key needs to subscribe to it through /hooks.
  - schemaobject
    The JSON schema of the signed body: { type, timestamp, data }.
  - exampleobject
    An example of the signed body.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope

Forespørgsel

curl "https://attendbeacon.com/api/v1/webhooks/event-types" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/webhooks/event-types", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/webhooks/event-types");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/webhooks/event-types",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/webhooks/event-types" -Headers $headers

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/webhooks/event-types",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

List webhook endpoints

GET/webhooks

Lists the workspace's webhook endpoints. Their secrets are never shown, and an address's query is hidden.

Scopes: webhooks:read

Svar

200 The endpoints. WebhookList
Felter
- dataWebhook[]
  The endpoints.
  Vis felterne
  - webhookIdstring (uuid)
    The endpoint's id.
  - urlstring
    Its address, with any query hidden.
  - hoststring
    Its host.
  - descriptionstring eller null
    What it is for.
  - eventTypesstring[]
    What it receives.
  - activeboolean
    Whether it is switched on.
  - disabledReasonstring eller null
    Why it stopped by itself: gone (it answered 410).
  - lastStatusstring eller null
    How its last delivery went: succeeded or failed.
  - lastDeliveryUtcstring (date-time) eller null
    When it was last called, in UTC.
  - createdUtcstring (date-time)
    When it was added, in UTC.
  - createdBystring
    Who added it.
- mostinteger (int32)
  The most a workspace may have.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope

Forespørgsel

curl "https://attendbeacon.com/api/v1/webhooks" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/webhooks", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/webhooks");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/webhooks",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/webhooks" -Headers $headers

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/webhooks",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Add a webhook endpoint Ændrer data

POST/webhooks

Adds a webhook endpoint for some event types. Its signing secret is in this answer and nowhere else afterwards, so an Idempotency-Key is not honoured here: the answer is never kept. The key needs the scopes of what the event types deliver (GET /webhooks/event-types), and the endpoint is switched off when the key is revoked or expires.

Scopes: webhooks:write

Send en Idempotency-Key, så gentagne forsøg er sikre. →

Body NewWebhook

The endpoint.

urlstring (uri)
The https address to call. A public address only.
descriptionstring eller null
What it is for, at most 200 characters.
eventTypesstring[]
What it receives: attendee.registered and the others (GET /webhooks/event-types).
activeboolean
Switched on; a new one starts on.

Svar

201 The endpoint and its secret. WebhookCreated
Felter
- webhookWebhook
  A webhook endpoint: an address told what happens, signed the Standard Webhooks way.
  Vis felterne
  - webhookIdstring (uuid)
    The endpoint's id.
  - urlstring
    Its address, with any query hidden.
  - hoststring
    Its host.
  - descriptionstring eller null
    What it is for.
  - eventTypesstring[]
    What it receives.
  - activeboolean
    Whether it is switched on.
  - disabledReasonstring eller null
    Why it stopped by itself: gone (it answered 410).
  - lastStatusstring eller null
    How its last delivery went: succeeded or failed.
  - lastDeliveryUtcstring (date-time) eller null
    When it was last called, in UTC.
  - createdUtcstring (date-time)
    When it was added, in UTC.
  - createdBystring
    Who added it.
- secretstring
  The signing secret, whsec_ and Base64. Keep it: it is never shown again; POST /webhooks/{webhookId}/secret makes a new one.
400 invalidBody, invalidRequest, tooManyEndpoints.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, demoWorkspace.
429 rateLimited.
503 webhooksUnavailable.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope invalidBody invalidRequest demoWorkspace tooManyEndpoints webhooksUnavailable

Forespørgsel

curl -X POST "https://attendbeacon.com/api/v1/webhooks" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://hooks.example.com/attendbeacon",
  "description": "CRM sync",
  "eventTypes": [
    "attendee.registered",
    "attendee.cancelled",
    "attendee.erased"
  ]
}'

const response = await fetch("https://attendbeacon.com/api/v1/webhooks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "url": "https://hooks.example.com/attendbeacon",
    "description": "CRM sync",
    "eventTypes": [
      "attendee.registered",
      "attendee.cancelled",
      "attendee.erased"
    ]
  })
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Post, "https://attendbeacon.com/api/v1/webhooks");
request.Headers.Add("Idempotency-Key", Guid.NewGuid().ToString());
request.Content = new StringContent("""
{
  "url": "https://hooks.example.com/attendbeacon",
  "description": "CRM sync",
  "eventTypes": [
    "attendee.registered",
    "attendee.cancelled",
    "attendee.erased"
  ]
}
""", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os, uuid
import requests

response = requests.post(
    "https://attendbeacon.com/api/v1/webhooks",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}",
        "Idempotency-Key": str(uuid.uuid4())
    },
    json={
        "url": "https://hooks.example.com/attendbeacon",
        "description": "CRM sync",
        "eventTypes": [
            "attendee.registered",
            "attendee.cancelled",
            "attendee.erased"
        ]
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
    "Idempotency-Key" = [guid]::NewGuid().ToString()
}
$body = @'
{
  "url": "https://hooks.example.com/attendbeacon",
  "description": "CRM sync",
  "eventTypes": [
    "attendee.registered",
    "attendee.cancelled",
    "attendee.erased"
  ]
}
'@

$data = Invoke-RestMethod -Method Post -Uri "https://attendbeacon.com/api/v1/webhooks" -Headers $headers -ContentType "application/json" -Body $body

400 invalidBody, invalidRequest, tooManyEndpoints.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidBody",
  "title": "The body is not readable",
  "status": 400,
  "detail": "The body is not JSON, or a field has the wrong type.",
  "instance": "/api/v1/webhooks",
  "code": "invalidBody",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "The body is not JSON, or a field has the wrong type."
}

Get a webhook endpoint

GET/webhooks/{webhookId}

Gets one webhook endpoint, without its secret.

Scopes: webhooks:read

Svarer med en ETag; send If-None-Match for at spare en download.

Parametre

sti

webhookIdstring (uuid)påkrævet
The webhook endpoint's id.

header

If-None-Matchstring
The ETag you have: when it is still current the answer is 304 with no body.

Svar

200 The endpoint. Webhook
Felter
- webhookIdstring (uuid)
  The endpoint's id.
- urlstring
  Its address, with any query hidden.
- hoststring
  Its host.
- descriptionstring eller null
  What it is for.
- eventTypesstring[]
  What it receives.
- activeboolean
  Whether it is switched on.
- disabledReasonstring eller null
  Why it stopped by itself: gone (it answered 410).
- lastStatusstring eller null
  How its last delivery went: succeeded or failed.
- lastDeliveryUtcstring (date-time) eller null
  When it was last called, in UTC.
- createdUtcstring (date-time)
  When it was added, in UTC.
- createdBystring
  Who added it.
304 Not modified: If-None-Match named the representation as it is.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 notFound.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound

Forespørgsel

curl "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b" -Headers $headers

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/webhooks/{webhookId}",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Change a webhook endpoint Ændrer data

PATCH/webhooks/{webhookId}

Changes an endpoint's address, description, event types, or switches it on or off. A field left out stays as it is. A new address or new event types need the scopes of everything the endpoint will then receive.

Scopes: webhooks:write

Send If-Match med den ETag, du læste, så en ændring i mellemtiden ikke overskrives.

Parametre

sti

webhookIdstring (uuid)påkrævet
The webhook endpoint's id.

header

If-Matchstring
The ETag you read, so a change made since is refused (412) rather than overwritten.

Body NewWebhook

The fields to change.

urlstring (uri)
The https address to call. A public address only.
descriptionstring eller null
What it is for, at most 200 characters.
eventTypesstring[]
What it receives: attendee.registered and the others (GET /webhooks/event-types).
activeboolean
Switched on; a new one starts on.

Svar

200 The endpoint as it is now. Webhook
Felter
- webhookIdstring (uuid)
  The endpoint's id.
- urlstring
  Its address, with any query hidden.
- hoststring
  Its host.
- descriptionstring eller null
  What it is for.
- eventTypesstring[]
  What it receives.
- activeboolean
  Whether it is switched on.
- disabledReasonstring eller null
  Why it stopped by itself: gone (it answered 410).
- lastStatusstring eller null
  How its last delivery went: succeeded or failed.
- lastDeliveryUtcstring (date-time) eller null
  When it was last called, in UTC.
- createdUtcstring (date-time)
  When it was added, in UTC.
- createdBystring
  Who added it.
400 invalidBody, invalidRequest.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, demoWorkspace.
404 notFound.
412 preconditionFailed.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound invalidBody invalidRequest demoWorkspace preconditionFailed

Forespørgsel

curl -X PATCH "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "If-Match: $ETAG" \
  -H "Content-Type: application/json" \
  -d '{
  "active": false
}'

const response = await fetch("https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`,
    "If-Match": etag,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "active": false
  })
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Patch, "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b");
request.Headers.IfMatch.Add(new EntityTagHeaderValue(etag));
request.Content = new StringContent("""
{
  "active": false
}
""", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.patch(
    "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}",
        "If-Match": etag
    },
    json={
        "active": False
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
    "If-Match" = $etag
}
$body = @'
{
  "active": false
}
'@

$data = Invoke-RestMethod -Method Patch -Uri "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b" -Headers $headers -ContentType "application/json" -Body $body

400 invalidBody, invalidRequest.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidBody",
  "title": "The body is not readable",
  "status": 400,
  "detail": "The body is not JSON, or a field has the wrong type.",
  "instance": "/api/v1/webhooks/{webhookId}",
  "code": "invalidBody",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "The body is not JSON, or a field has the wrong type."
}

Remove a webhook endpoint Ændrer data

DELETE/webhooks/{webhookId}

Removes an endpoint and its secret. Nothing more is sent to it.

Scopes: webhooks:write

Parametre

sti

webhookIdstring (uuid)påkrævet
The webhook endpoint's id.

Svar

204 Removed.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, demoWorkspace.
404 notFound.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound demoWorkspace

Forespørgsel

curl -X DELETE "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Delete, "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();

import os
import requests

response = requests.delete(
    "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

Invoke-RestMethod -Method Delete -Uri "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b" -Headers $headers

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/webhooks/{webhookId}",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Make a new signing secret Ændrer data

POST/webhooks/{webhookId}/secret

Replaces an endpoint's signing secret. The old one stops working at once: there is no overlap, because a secret that leaked should not be trusted any longer. No Idempotency-Key: the answer, a secret, is never kept.

Scopes: webhooks:write

Send en Idempotency-Key, så gentagne forsøg er sikre. →

Parametre

sti

webhookIdstring (uuid)påkrævet
The webhook endpoint's id.

Svar

200 The new secret, shown this once. WebhookSecret
Felter
- webhookIdstring (uuid)
  The endpoint's id.
- secretstring
  The new secret, shown this once.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, demoWorkspace.
404 notFound.
429 rateLimited.
503 webhooksUnavailable.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound demoWorkspace webhooksUnavailable

Forespørgsel

curl -X POST "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/secret" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

const response = await fetch("https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/secret", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`,
    "Idempotency-Key": crypto.randomUUID()
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Post, "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/secret");
request.Headers.Add("Idempotency-Key", Guid.NewGuid().ToString());

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os, uuid
import requests

response = requests.post(
    "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/secret",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}",
        "Idempotency-Key": str(uuid.uuid4())
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
    "Idempotency-Key" = [guid]::NewGuid().ToString()
}

$data = Invoke-RestMethod -Method Post -Uri "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/secret" -Headers $headers

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/webhooks/{webhookId}/secret",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Send a test message Ændrer data

POST/webhooks/{webhookId}/test

Sends a signed webhook.test message to the endpoint now, while you wait, and says what it answered. A switched-off endpoint can be tested too.

Scopes: webhooks:write

Send en Idempotency-Key, så gentagne forsøg er sikre. →

Parametre

sti

webhookIdstring (uuid)påkrævet
The webhook endpoint's id.

header

Idempotency-Keystring
A key of your own, such as a UUID, so a retry after a lost connection is answered with the first answer instead of doing it twice. Kept 24 hours.

Svar

200 What came of it. WebhookTest
Felter
- okboolean
  Whether the endpoint answered 2xx.
- statusinteger (int32) eller null
  The status it answered.
- errorstring eller null
  What went wrong.
- durationMsinteger (int32) eller null
  How long it took.
- deliveryIdstring (uuid)
  The delivery, in the endpoint's log.
400 invalidIdempotencyKey.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 notFound.
409 idempotencyKeyInUse.
422 idempotencyKeyReused.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound idempotencyKeyInUse idempotencyKeyReused invalidIdempotencyKey

Forespørgsel

curl -X POST "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/test" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

const response = await fetch("https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/test", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`,
    "Idempotency-Key": crypto.randomUUID()
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Post, "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/test");
request.Headers.Add("Idempotency-Key", Guid.NewGuid().ToString());

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os, uuid
import requests

response = requests.post(
    "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/test",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}",
        "Idempotency-Key": str(uuid.uuid4())
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
    "Idempotency-Key" = [guid]::NewGuid().ToString()
}

$data = Invoke-RestMethod -Method Post -Uri "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/test" -Headers $headers

400 invalidIdempotencyKey.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidIdempotencyKey",
  "title": "Idempotency-Key is not valid",
  "status": 400,
  "detail": "An Idempotency-Key is 1 to 255 visible ASCII characters; a UUID is a good one.",
  "instance": "/api/v1/webhooks/{webhookId}/test",
  "code": "invalidIdempotencyKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "An Idempotency-Key is 1 to 255 visible ASCII characters; a UUID is a good one."
}

List deliveries

GET/webhooks/{webhookId}/deliveries

Lists an endpoint's latest deliveries, newest first: what was sent, how many attempts, what the endpoint answered.

Scopes: webhooks:read

Parametre

sti

webhookIdstring (uuid)påkrævet
The webhook endpoint's id.

forespørgsel

limitinteger (int32)
How many, up to 200.
Standard: 50

Svar

200 The deliveries. WebhookDeliveryList
Felter
- dataWebhookDelivery[]
  The deliveries.
  Vis felterne
  - deliveryIdstring (uuid)
    The delivery's id.
  - messageIdstring
    The message's webhook-id: msg_ and its id, the same on every attempt.
  - eventTypestring
    Its type.
  - statusstring
    Pending, claimed, succeeded, failed or cancelled.
  - testboolean
    Whether it was a test.
  - attemptsinteger (int32)
    Attempts so far.
  - nextAttemptUtcstring (date-time) eller null
    When it is tried again, in UTC.
  - statusCodeinteger (int32) eller null
    The last status the endpoint answered.
  - errorstring eller null
    The last error.
  - durationMsinteger (int32) eller null
    How long the last attempt took.
  - createdUtcstring (date-time)
    When it was queued, in UTC.
  - completedUtcstring (date-time) eller null
    When it ended, in UTC.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 notFound.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound

Forespørgsel

curl "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/deliveries?limit=2" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/deliveries?limit=2", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/deliveries?limit=2");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/deliveries", params={"limit": 2},
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/webhooks/2c8e4a6f-1b3d-4e5a-9c7b-0d2f4a6c8e1b/deliveries?limit=2" -Headers $headers

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/webhooks/{webhookId}/deliveries",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Guiderne og dette site er på dit sprog. API-referencens egne beskrivelser er på engelsk, ligesom API'et selv.

#List webhook event types

Svar

Afvisninger

#List webhook endpoints

Svar

Afvisninger

#Add a webhook endpoint Ændrer data

Body NewWebhook

Svar

Afvisninger

#Get a webhook endpoint

Parametre

Svar

Afvisninger

#Change a webhook endpoint Ændrer data

Parametre

Body NewWebhook

Svar

Afvisninger

#Remove a webhook endpoint Ændrer data

Parametre

Svar

Afvisninger

#Make a new signing secret Ændrer data

Parametre

Svar

Afvisninger

#Send a test message Ændrer data

Parametre

Svar

Afvisninger

#List deliveries

Parametre

Svar

Afvisninger

List webhook event types

List webhook endpoints

Add a webhook endpoint Ændrer data

Get a webhook endpoint

Change a webhook endpoint Ændrer data

Remove a webhook endpoint Ændrer data

Make a new signing secret Ændrer data

Send a test message Ændrer data

List deliveries