Webhooks

get webhooks

get

/api/v3/webhooks

Authorizations

Query parameters

orderbystring

Sorting parameter Available values : entity fields Default value : id

Example: id

orderstring

Sorting parameter Available values : [ASC,DESC] Default value : ASC

Example: asc

limitinteger · int32

Paging parameter Default value : null

Example: 2

offsetinteger · int32

Paging parameter Default value : 0

Example: 3

userinteger · int32

Filter Parameter check the user id

• accept "me" as special value

Example: 3

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/webhooks' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

401

200

{
  "count": 4,
  "offset": 0,
  "order": "asc",
  "orderby": "id",
  "curr": "http://localhost:8000/api/v3/webhooks?orderby=id&order=asc&offset=0",
  "next": "http://localhost:8000/api/v3/webhooks?orderby=id&order=asc&offset=0",
  "prev": "http://localhost:8000/api/v3/webhooks?orderby=id&order=asc&offset=0",
  "total_count": 4,
  "results": [
    {
      "id": 2,
      "url": "http://services.nationalmap.gov/ArcGIS/services/NEXRAD_Weather/MapServer/WMSServer",
      "name": "test",
      "shared_secret": "test123estfds78#43fds",
      "webhook_uuid": "test-test-test",
      "event_type": "create",
      "entity_type": "post",
      "created": "1970-01-01T00:00:00+00:00",
      "updated": "2022-11-02T20:02:00+00:00",
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ],
      "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
      }
    },
    {
      "id": 4,
      "url": "https://test.test",
      "name": "test",
      "shared_secret": "testestest",
      "webhook_uuid": "test-test-test",
      "event_type": "delete",
      "entity_type": "post",
      "created": "1970-01-01T00:00:00+00:00",
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ],
      "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
      }
    },
    {
      "id": 5,
      "url": "https://test.test",
      "name": "test",
      "shared_secret": "testestest",
      "webhook_uuid": "test-test-test",
      "event_type": "search",
      "entity_type": "post",
      "created": "1970-01-01T00:00:00+00:00",
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ],
      "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
      }
    },
    {
      "id": 6,
      "url": "http://services.nationalmap.gov/ArcGIS/services/NEXRAD_Weather/MapServer/WMSServer",
      "name": "test",
      "shared_secret": "test123estfds78#43fds",
      "webhook_uuid": "4472f128-4448-482a-b279-5a218d3ce559",
      "event_type": "create",
      "entity_type": "post",
      "created": "2022-11-02T20:00:00+00:00",
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ],
      "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
      }
    }
  ]
}

OK

add webhooks

POST https://ushahididocs.api.ushahidi.io/api/v3/webhooks

Request Body

Name	Type	Description
user_id	Integer	The user identifier
webhook_uuid	String	Webhook unique ID
shared_secret	String	The shared secrete unique ID
name	String	Webhook name
form_id	String	The form identifier
destination_field_key	String
event_type	String	The event type
url	String	Webhook URL
source_field_key	String
entity_type	String	Entity type

200: OK

{
    "id": 6,
    "url": "http://services.nationalmap.gov/ArcGIS/services/NEXRAD_Weather/MapServer/WMSServer",
    "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
    },
    "form_id": null,
    "name": "test",
    "shared_secret": "test123estfds78#43fds",
    "webhook_uuid": "4472f128-4448-482a-b279-5a218d3ce559",
    "event_type": "create",
    "entity_type": "post",
    "source_field_key": null,
    "destination_field_key": null,
    "created": "2022-11-02T20:00:00+00:00",
    "updated": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

get webhook

get

/api/v3/webhooks/2

Authorizations

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/webhooks/2' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

401

404

200

{
  "id": 2,
  "url": "https://test.test",
  "name": "test",
  "shared_secret": "testestest",
  "webhook_uuid": "test-test-test",
  "event_type": "create",
  "entity_type": "post",
  "created": "1970-01-01T00:00:00+00:00",
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ],
  "user": {
    "id": 1,
    "url": "http://localhost:8000/api/v3/users/1"
  }
}

OK

edit webhooks

PUT https://ushahididocs.api.ushahidi.io/api/v3/webhooks/2

Request Body

Name	Type	Description
user_id	Integer	The user identifier
webhook_uuid	String	Webhook unique ID
shared_secret	String	The shared secrete unique ID
name	String	Webhook name
form_id	String	The form identifier
destination_field_key	String
event_type	String	The event type
url	String	Webhook URL
source_field_key	String
entity_type	String	Entity type

200: OK

{
    "id": 6,
    "url": "http://services.nationalmap.gov/ArcGIS/services/NEXRAD_Weather/MapServer/WMSServer",
    "user": {
        "id": 1,
        "url": "http://localhost:8000/api/v3/users/1"
    },
    "form_id": null,
    "name": "test",
    "shared_secret": "test123estfds78#43fds",
    "webhook_uuid": "4472f128-4448-482a-b279-5a218d3ce559",
    "event_type": "create",
    "entity_type": "post",
    "source_field_key": null,
    "destination_field_key": null,
    "created": "2022-11-02T20:00:00+00:00",
    "updated": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

delete webhook

delete

/api/v3/webhooks/3

Authorizations

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/webhooks/3' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

401

404

200

{
  "id": 3,
  "url": "https://test.test",
  "name": "test",
  "shared_secret": "testestest",
  "webhook_uuid": "test-test-test",
  "event_type": "update",
  "entity_type": "post",
  "created": "1970-01-01T00:00:00+00:00",
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ],
  "user": {
    "id": 1,
    "url": "http://localhost:8000/api/v3/users/1"
  }
}

OK

edit a webhook post

PUT https://ushahididocs.api.ushahidi.io/api/v3/webhooks/posts/96

Request Body

Name	Type	Description
form_id	Integer	Form unique identifier
slug	String	Post slug
type	String	Post type
message	String	Additiong message for post
url	String	Post URL
author_email	String	Email address of source
title	String	Title of the new post
content	String	Post content
user_id	Integer	The user's unique Identifier
author_realname	String	The full name of the Post source
status	String	The status of post
locale	String	Post local language
color	String	Post color
id	String	Unique identifier of post
values	String	This is an array containing two items, one for the title and the description
published_to	Array	This contains an array of where the post was published
source	String	Source of post
sets	String	An array of set id's
tags	String	Contains an array of tag Id's
contact	String	Post contact

200: OK

{
  "id": 0,
  "url": "string",
  "user_id": 0,
  "parent_id": 0,
  "form_id": 0,
  "title": "string",
  "content": "string",
  "message": "string",
  "color": "string",
  "type": "string",
  "slug": "string",
  "author_email": "string",
  "author_realname": 0,
  "status": "string",
  "created": "string",
  "updated": "string",
  "locale": "string",
  "values": [
    "string"
  ],
  "post_date": "string",
  "tags": [
    "string"
  ],
  "published_to": [
    0
  ],
  "completed_stages": [
    0
  ],
  "sets": [
    0
  ],
  "lock": "string",
  "source": "string",
  "data_source_message_id": "string",
  "allowed_privileges": [
    "string"
  ]
}