Sub Posts & Translation

Get post revisions

GEThttps://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/revisions

Path parameters

parent_id*string

Parent Identifier

Query parameters

Response

200404

OK

Body

application/json

countsinteger

resultsarray of PostResponseList_results (object)

limitinteger

offsetinteger

orderstring

orderbystring

currstring

nextstring

prevstring

total_countinteger

Request

JavaScriptCurlPython

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

Response

200404

{
  "results": [
    {
      "url": "text",
      "user": [
        {
          "url": "text"
        }
      ],
      "form": [
        {
          "url": "text"
        }
      ],
      "title": "text",
      "content": "text",
      "message": "text",
      "color": "text",
      "type": "text",
      "slug": "text",
      "author_email": "text",
      "status": "text",
      "created": "text",
      "updated": "text",
      "locale": "text",
      "values": [
        "text"
      ],
      "post_date": "text",
      "tags": [
        "text"
      ],
      "published_to": [],
      "completed_stages": [],
      "sets": [],
      "lock": "text",
      "source": "text",
      "data_source_message_id": "text",
      "allowed_privileges": [
        "text"
      ]
    }
  ],
  "order": "text",
  "orderby": "text",
  "curr": "text",
  "next": "text",
  "prev": "text"
}

Get post revision

GEThttps://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/revisions/105

Path parameters

parent_id*string

Parent Identifier

Response

200404

OK

Body

application/json

idinteger

urlstring

user_idinteger

parent_idinteger

form_idinteger

titlestring

contentstring

messagestring

colorstring

typestring

slugstring

author_emailstring

author_realnameinteger

statusstring

createdstring

updatedstring

localestring

valuesarray of string

post_datestring

tagsarray of string

published_toarray of integer

completed_stagesarray of integer

setsarray of integer

lockstring

sourcestring

data_source_message_idstring

allowed_privilegesarray of string

Request

JavaScriptCurlPython

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

Response

200404

{
  "url": "text",
  "title": "text",
  "content": "text",
  "message": "text",
  "color": "text",
  "type": "text",
  "slug": "text",
  "author_email": "text",
  "status": "text",
  "created": "text",
  "updated": "text",
  "locale": "text",
  "values": [
    "text"
  ],
  "post_date": "text",
  "tags": [
    "text"
  ],
  "published_to": [],
  "completed_stages": [],
  "sets": [],
  "lock": "text",
  "source": "text",
  "data_source_message_id": "text",
  "allowed_privileges": [
    "text"
  ]
}

Get post translation

GEThttps://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations

Path parameters

parent_id*string

Parent Identifier

Query parameters

Response

200

OK

Body

application/json

idinteger

urlstring

user_idinteger

parent_idinteger

form_idinteger

titlestring

contentstring

messagestring

colorstring

typestring

slugstring

author_emailstring

author_realnameinteger

statusstring

createdstring

updatedstring

localestring

valuesarray of string

post_datestring

tagsarray of string

published_toarray of integer

completed_stagesarray of integer

setsarray of integer

lockstring

sourcestring

data_source_message_idstring

allowed_privilegesarray of string

Request

JavaScriptCurlPython

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

Response

200

{
  "url": "text",
  "title": "text",
  "content": "text",
  "message": "text",
  "color": "text",
  "type": "text",
  "slug": "text",
  "author_email": "text",
  "status": "text",
  "created": "text",
  "updated": "text",
  "locale": "text",
  "values": [
    "text"
  ],
  "post_date": "text",
  "tags": [
    "text"
  ],
  "published_to": [],
  "completed_stages": [],
  "sets": [],
  "lock": "text",
  "source": "text",
  "data_source_message_id": "text",
  "allowed_privileges": [
    "text"
  ]
}

Get post translation

GEThttps://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations/{translation_id}

Path parameters

parent_id*string

Parent Identifier

translation_id*string

Translation indentifier

Response

200404

OK

Body

application/json

idinteger

urlstring

user_idinteger

parent_idinteger

form_idinteger

titlestring

contentstring

messagestring

colorstring

typestring

slugstring

author_emailstring

author_realnameinteger

statusstring

createdstring

updatedstring

localestring

valuesarray of string

post_datestring

tagsarray of string

published_toarray of integer

completed_stagesarray of integer

setsarray of integer

lockstring

sourcestring

data_source_message_idstring

allowed_privilegesarray of string

Request

JavaScriptCurlPython

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

Response

200404

{
  "url": "text",
  "title": "text",
  "content": "text",
  "message": "text",
  "color": "text",
  "type": "text",
  "slug": "text",
  "author_email": "text",
  "status": "text",
  "created": "text",
  "updated": "text",
  "locale": "text",
  "values": [
    "text"
  ],
  "post_date": "text",
  "tags": [
    "text"
  ],
  "published_to": [],
  "completed_stages": [],
  "sets": [],
  "lock": "text",
  "source": "text",
  "data_source_message_id": "text",
  "allowed_privileges": [
    "text"
  ]
}

Add a post translation

POST https://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations

Path Parameters

Name	Type	Description
parent_id**	String	Parent Identifier

Request Body

Name	Type	Description
content	String	Post content
type	String	Post type
author_email	String	Email address of source
message	String	Additional message for post
url	String	Post URL
id	String	Post unique identifier
slug	String	Post slug
user_id	String	Post user indentifier
color	String	Post color
title	String	Post Tiitle
locale	String	The local language of post
status	String	Post status
author_realname	String	The full name of the Post source
published_to	Array	This contains an array of where the post was published
completed_stages	Array	Contains an array of post-completed stage
source	String	The Source of the post contains an array of post-completed stage

200: OK

{
    "id": 10000,
    "url": "http://localhost:8000/api/v3/posts/10000",
    "parent": {
        "id": 97,
        "url": "http://localhost:8000/api/v3/posts/97"
    },
    "form": null,
    "user_id": null,
    "message": null,
    "color": null,
    "type": "report",
    "title": "creat post",
    "slug": "test-create6",
    "content": "test: create new post",
    "author_email": "[e-mail]",
    "author_realname": null,
    "status": "draft",
    "created": "2022-09-02T08:34:57+00:00",
    "updated": null,
    "locale": "fr_fr",
    "values": {
        "markdown": [
            "#markdowny"
        ]
    },
    "post_date": "2022-09-02T08:34:57+00:00",
    "tags": [],
    "published_to": [],
    "completed_stages": [],
    "sets": [],
    "lock": null,
    "source": null,
    "contact": null,
    "data_source_message_id": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "change_status",
        "read_full"
    ]
}

Edit post translation

PUT https://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations/{translation_id}

Path Parameters

Name	Type	Description
parent_id*	Integer	Parent Identifier
translation_id*	integer	Translation Identifier

Request Body

Name	Type	Description
id	String	Post unique identifier
published_to	Array	Contains an array of post-completed stage
locale	String	The local language of the post
status	String	Post status
author_realname	String	The full name of the Post source
author_email	String	The full name of the Post source
type	String	Post type
color	String	Post color
message	String	Post message
content	String	Content of post
title	String	Post title
user_id	String	Post user identifier
url	String	Post URL
source	String	The Source of the post contains an array of post-completed stage

200: OK

{
    "id": 10000,
    "url": "http://localhost:8000/api/v3/posts/10000",
    "parent": {
        "id": 97,
        "url": "http://localhost:8000/api/v3/posts/97"
    },
    "form": null,
    "user_id": null,
    "message": null,
    "color": null,
    "type": "report",
    "title": "creat post",
    "slug": "test-create6",
    "content": "test: create new post",
    "author_email": "[e-mail]",
    "author_realname": null,
    "status": "draft",
    "created": "2022-09-02T08:34:57+00:00",
    "updated": null,
    "locale": "fr_fr",
    "values": {
        "markdown": [
            "#markdowny"
        ]
    },
    "post_date": "2022-09-02T08:34:57+00:00",
    "tags": [],
    "published_to": [],
    "completed_stages": [],
    "sets": [],
    "lock": null,
    "source": null,
    "contact": null,
    "data_source_message_id": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "change_status",
        "read_full"
    ]
}

Delete post translation

DELETEhttps://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations/{translation_id}

Path parameters

parent_id*string

Parent Identifier

translation_id*string

Translation indentifier

Response

200404

OK

Body

application/json

idinteger

urlstring

user_idinteger

parent_idinteger

form_idinteger

titlestring

contentstring

messagestring

colorstring

typestring

slugstring

author_emailstring

author_realnameinteger

statusstring

createdstring

updatedstring

localestring

valuesarray of string

post_datestring

tagsarray of string

published_toarray of integer

completed_stagesarray of integer

setsarray of integer

lockstring

sourcestring

data_source_message_idstring

allowed_privilegesarray of string

Request

JavaScriptCurlPython

const response = await fetch('https://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations/{translation_id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200404

{
  "url": "text",
  "title": "text",
  "content": "text",
  "message": "text",
  "color": "text",
  "type": "text",
  "slug": "text",
  "author_email": "text",
  "status": "text",
  "created": "text",
  "updated": "text",
  "locale": "text",
  "values": [
    "text"
  ],
  "post_date": "text",
  "tags": [
    "text"
  ],
  "published_to": [],
  "completed_stages": [],
  "sets": [],
  "lock": "text",
  "source": "text",
  "data_source_message_id": "text",
  "allowed_privileges": [
    "text"
  ]
}

Get post local translation

GEThttps://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations/(local)

Path parameters

parent_id*string

Parent Identifier

Response

200404

OK

Body

application/json

idinteger

urlstring

user_idinteger

parent_idinteger

form_idinteger

titlestring

contentstring

messagestring

colorstring

typestring

slugstring

author_emailstring

author_realnameinteger

statusstring

createdstring

updatedstring

localestring

valuesarray of string

post_datestring

tagsarray of string

published_toarray of integer

completed_stagesarray of integer

setsarray of integer

lockstring

sourcestring

data_source_message_idstring

allowed_privilegesarray of string

Request

JavaScriptCurlPython

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

Response

200404

{
  "url": "text",
  "title": "text",
  "content": "text",
  "message": "text",
  "color": "text",
  "type": "text",
  "slug": "text",
  "author_email": "text",
  "status": "text",
  "created": "text",
  "updated": "text",
  "locale": "text",
  "values": [
    "text"
  ],
  "post_date": "text",
  "tags": [
    "text"
  ],
  "published_to": [],
  "completed_stages": [],
  "sets": [],
  "lock": "text",
  "source": "text",
  "data_source_message_id": "text",
  "allowed_privileges": [
    "text"
  ]
}

Edit post local translation

PUT https://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations/(local)

Path Parameters

Name	Type	Description
parent_id*	Integer	Parent Identifier
local*	String	Post locale

Request Body

Name	Type	Description
id	String	Post unique identifier
published_to	Array	Contains an array of post-completed stage
locale	String	The local language of the post
status	String	Post status
author_realname	String	The full name of the Post source
author_email	String	The full name of the Post source
type	String	Post type
color	String	Post color
message	String	Post message
content	String	Content of post
title	String	Post title
user_id	Integer	Post user identifier
url	String	Post URL
source	String	The Source of the post contains an array of post-completed stage
form_id	Integer	Post form identifier

200: OK

{
    "id": 10000,
    "url": "http://localhost:8000/api/v3/posts/10000",
    "parent": {
        "id": 97,
        "url": "http://localhost:8000/api/v3/posts/97"
    },
    "form": null,
    "user_id": null,
    "message": null,
    "color": null,
    "type": "report",
    "title": "creat post",
    "slug": "test-create6",
    "content": "test: create new post",
    "author_email": "[e-mail]",
    "author_realname": null,
    "status": "draft",
    "created": "2022-09-02T08:34:57+00:00",
    "updated": null,
    "locale": "fr_fr",
    "values": {
        "markdown": [
            "#markdowny"
        ]
    },
    "post_date": "2022-09-02T08:34:57+00:00",
    "tags": [],
    "published_to": [],
    "completed_stages": [],
    "sets": [],
    "lock": null,
    "source": null,
    "contact": null,
    "data_source_message_id": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "change_status",
        "read_full"
    ]}

Delete post local translation

DELETEhttps://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations/(local)

Path parameters

parent_id*string

Parent Identifier

Response

200404

OK

Body

application/json

idinteger

urlstring

user_idinteger

parent_idinteger

form_idinteger

titlestring

contentstring

messagestring

colorstring

typestring

slugstring

author_emailstring

author_realnameinteger

statusstring

createdstring

updatedstring

localestring

valuesarray of string

post_datestring

tagsarray of string

published_toarray of integer

completed_stagesarray of integer

setsarray of integer

lockstring

sourcestring

data_source_message_idstring

allowed_privilegesarray of string

Request

JavaScriptCurlPython

const response = await fetch('https://ushahididocs.api.ushahidi.io/api/v3/posts/{parent_id}/translations/(local)', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200404

{
  "url": "text",
  "title": "text",
  "content": "text",
  "message": "text",
  "color": "text",
  "type": "text",
  "slug": "text",
  "author_email": "text",
  "status": "text",
  "created": "text",
  "updated": "text",
  "locale": "text",
  "values": [
    "text"
  ],
  "post_date": "text",
  "tags": [
    "text"
  ],
  "published_to": [],
  "completed_stages": [],
  "sets": [],
  "lock": "text",
  "source": "text",
  "data_source_message_id": "text",
  "allowed_privileges": [
    "text"
  ]
}