API-referanse

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.

Omfang: webhooks:read

Svar

200 The types. WebhookEventTypeList
Felt
- dataWebhookEventType[]
  The types.
  Vis feltene
  - 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.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope

Forespørsel

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.

Omfang: webhooks:read

Svar

200 The endpoints. WebhookList
Felt
- dataWebhook[]
  The endpoints.
  Vis feltene
  - 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.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope

Forespørsel

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 Endrer 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.

Omfang: webhooks:write

Send en Idempotency-Key for å gjøre nye forsøk trygge. →

Innhold 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
Felt
- webhookWebhook
  A webhook endpoint: an address told what happens, signed the Standard Webhooks way.
  Vis feltene
  - 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.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope invalidBody invalidRequest demoWorkspace tooManyEndpoints webhooksUnavailable

Forespørsel

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.

Omfang: webhooks:read

Svarer med en ETag; send If-None-Match for å slippe en ny nedlasting.

Parametere

sti

webhookIdstring (uuid)påkrevd
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
Felt
- 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.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound

Forespørsel

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 Endrer 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.

Omfang: webhooks:write

Send If-Match med ETag-en du leste, slik at en endring i mellomtiden ikke overskrives.

Parametere

sti

webhookIdstring (uuid)påkrevd
The webhook endpoint's id.

header

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

Innhold 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
Felt
- 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.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound invalidBody invalidRequest demoWorkspace preconditionFailed

Forespørsel

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 Endrer data

DELETE/webhooks/{webhookId}

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

Omfang: webhooks:write

Parametere

sti

webhookIdstring (uuid)påkrevd
The webhook endpoint's id.

Svar

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

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound demoWorkspace

Forespørsel

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 Endrer 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.

Omfang: webhooks:write

Send en Idempotency-Key for å gjøre nye forsøk trygge. →

Parametere

sti

webhookIdstring (uuid)påkrevd
The webhook endpoint's id.

Svar

200 The new secret, shown this once. WebhookSecret
Felt
- 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.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound demoWorkspace webhooksUnavailable

Forespørsel

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 Endrer 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.

Omfang: webhooks:write

Send en Idempotency-Key for å gjøre nye forsøk trygge. →

Parametere

sti

webhookIdstring (uuid)påkrevd
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
Felt
- 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.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound idempotencyKeyInUse idempotencyKeyReused invalidIdempotencyKey

Forespørsel

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.

Omfang: webhooks:read

Parametere

sti

webhookIdstring (uuid)påkrevd
The webhook endpoint's id.

spørring

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

Svar

200 The deliveries. WebhookDeliveryList
Felt
- dataWebhookDelivery[]
  The deliveries.
  Vis feltene
  - 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.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound

Forespørsel

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."
}

Veiledningene og dette nettstedet er på ditt språk. Beskrivelsene i selve API-referansen er på engelsk, slik API-et selv er.

#List webhook event types

Svar

Avvisninger

#List webhook endpoints

Svar

Avvisninger

#Add a webhook endpoint Endrer data

Innhold NewWebhook

Svar

Avvisninger

#Get a webhook endpoint

Parametere

Svar

Avvisninger

#Change a webhook endpoint Endrer data

Parametere

Innhold NewWebhook

Svar

Avvisninger

#Remove a webhook endpoint Endrer data

Parametere

Svar

Avvisninger

#Make a new signing secret Endrer data

Parametere

Svar

Avvisninger

#Send a test message Endrer data

Parametere

Svar

Avvisninger

#List deliveries

Parametere

Svar

Avvisninger

List webhook event types

List webhook endpoints

Add a webhook endpoint Endrer data

Get a webhook endpoint

Change a webhook endpoint Endrer data

Remove a webhook endpoint Endrer data

Make a new signing secret Endrer data

Send a test message Endrer data

List deliveries