Messages

get messages

GEThttps://ushahididocs.api.ushahidi.io/api/v3/messages

Query parameters

Response

200401

OK

Body

application/json

count*integer (int32)

results*array of getmessages_results (object)

limit*nullable string

offset*integer (int32)

order*string

orderby*string

curr*string

next*string

prev*string

total_count*integer (int32)

Request

JavaScriptCurlPython

const response = await fetch('https://ushahididocs.api.ushahidi.io/api/v3/messages', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401

{
  "results": [
    {
      "url": "text",
      "parent_id": "text",
      "post_id": "text",
      "user_id": "text",
      "data_source": "text",
      "data_source_message_id": "text",
      "title": "text",
      "message": "text",
      "datetime": {
        "date": "text",
        "timezone": "text"
      },
      "type": "text",
      "status": "text",
      "direction": "text",
      "created": "text",
      "additional_data": "text",
      "notification_post_id": "text",
      "contact": "text",
      "contact_type": "text",
      "allowed_privileges": [
        "text"
      ],
      "user": {
        "url": "text"
      }
    }
  ],
  "limit": "text",
  "order": "text",
  "orderby": "text",
  "curr": "text",
  "next": "text",
  "prev": "text"
}

add message

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

Request Body

Name	Type	Description
parent_id	String	The parent identifier
datetime	String	Date and time
user_id	String	user ID
title	String	Massage title
data_source_message_id	String	Data source message identifier
message	String	The main message you would like to add
contact_id	Integer	The post contact identifier
data_source	String	Data source
post_id	String	post ID
notification_post_id	String	Notification post identifier
additional_data	String	Additional information
direction	String	Message direction e.g. "outgoing"
status	String	Message status
type	String	Message type e.g. "sms"
contact_type	String	Contact type
contact	String	Message contact

200: OK

{
    "id": 20,
    "url": "http://localhost:8000/api/v3/messages/20",
    "user": {
        "id": 2,
        "url": "http://localhost:8000/api/v3/users/2"
    },
    "parent_id": null,
    "contact_id": 3,
    "post_id": null,
    "data_source": null,
    "data_source_message_id": null,
    "title": null,
    "message": "Another test message",
    "datetime": null,
    "type": "sms",
    "status": "pending",
    "direction": "outgoing",
    "created": "2022-11-02T15:20:45+00:00",
    "additional_data": null,
    "notification_post_id": null,
    "contact": null,
    "contact_type": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

get message

GEThttps://ushahididocs.api.ushahidi.io/api/v3/messages/2

Response

200401404

OK

Body

application/json

id*integer (int32)

url*string

parent_id*nullable string

contact_id*integer (int32)

post_id*nullable string

user_id*nullable string

data_source*nullable string

data_source_message_id*nullable string

title*string

message*string

datetime*nullable string

type*string

status*string

direction*string

created*string

additional_data*nullable string

notification_post_id*nullable string

contact*nullable string

contact_type*nullable string

allowed_privileges*array of string

Request

JavaScriptCurlPython

const response = await fetch('https://ushahididocs.api.ushahidi.io/api/v3/messages/2', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

{
  "id": 2,
  "url": "http://localhost:8000/api/v3/messages/2",
  "contact_id": 3,
  "title": "",
  "message": "Another test message",
  "type": "sms",
  "status": "received",
  "direction": "incoming",
  "created": "1970-01-01T00:00:00+00:00",
  "allowed_privileges": [
    "read",
    "create",
    "delete",
    "search"
  ]
}

edit message

PUT https://ushahididocs.api.ushahidi.io/api/v3/messages/18

Request Body

Name	Type	Description
parent_id	String	The parent identifier
datetime	String	Date and time
user_id	String	user ID
title	String	Massage title
data_source_message_id	String	Data source message identifier
message	String	The main message you would like to add
contact_id	Integer	The post contact identifier
data_source	String	Data source
post_id	String	post ID
notification_post_id	String	Notification post identifier
additional_data	String	Additional information
direction	String	Message direction e.g. "outgoing"
status	String	Message status
type	String	Message type e.g. "sms"
contact_type	String	Contact type
contact	String	Message contact

200: OK

{
    "id": 20,
    "url": "http://localhost:8000/api/v3/messages/20",
    "user": {
        "id": 2,
        "url": "http://localhost:8000/api/v3/users/2"
    },
    "parent_id": null,
    "contact_id": 3,
    "post_id": null,
    "data_source": null,
    "data_source_message_id": null,
    "title": null,
    "message": "Another test message",
    "datetime": null,
    "type": "sms",
    "status": "pending",
    "direction": "outgoing",
    "created": "2022-11-02T15:20:45+00:00",
    "additional_data": null,
    "notification_post_id": null,
    "contact": null,
    "contact_type": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

get message posts

GEThttps://ushahididocs.api.ushahidi.io/api/v3/messages/4/post

Response

200401404

OK

Body

application/json

id*integer (int32)

url*string

user*createsavedsearch_user (object)

Example: "{\"id\":1,\"url\":\"http://localhost:8000/api/v3/users/1\"}"

parent_id*nullable string

form*getcollectionposts_form (object)

message*deletecollectionpost_message (object)

Example: "{\"id\":4,\"url\":\"http://localhost:8000/api/v3/messages/4\"}"

color*nullable string

type*string

title*string

slug*nullable string

content*string

author_email*nullable string

author_realname*nullable string

status*string

created*string

updated*nullable string

locale*string

values*getmessageposts_values (object)

Example: "{\"last_location\":[\"Hamilton\"]}"

post_date*string

tags*array of string

published_to*array of string

completed_stages*array of string

sets*array of string

lock*nullable string

source*string

contact*getcollectionpost_contact (object)

Example: "{\"id\":3,\"url\":\"http://localhost:8000/api/v3/contact/3\"}"

data_source_message_id*nullable string

allowed_privileges*array of string

Request

JavaScriptCurlPython

const response = await fetch('https://ushahididocs.api.ushahidi.io/api/v3/messages/4/post', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

{
  "id": 110,
  "url": "http://localhost:8000/api/v3/posts/110",
  "user": {
    "id": 1,
    "url": "http://localhost:8000/api/v3/users/1"
  },
  "form": {
    "id": 1,
    "url": "http://localhost:8000/api/v3/forms/1"
  },
  "message": {
    "id": 4,
    "url": "http://localhost:8000/api/v3/messages/4"
  },
  "type": "report",
  "title": "ACL test post",
  "content": "Testing oauth posts api access",
  "status": "published",
  "created": "2012-12-17T11:18:40+00:00",
  "locale": "en_us",
  "values": {
    "last_location": [
      "Trisolaris"
    ]
  },
  "post_date": "2012-12-17T03:18:40+00:00",
  "tags": [],
  "published_to": [],
  "completed_stages": [],
  "sets": [],
  "source": "sms",
  "contact": {
    "id": 3,
    "url": "http://localhost:8000/api/v3/contact/3"
  },
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search",
    "change_status",
    "read_full"
  ]
}