Exports

get exports

get

/api/v3/exports/jobs

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

max_expirationstring

filter parameter return jobs with url_expiration less than this date or have 0 value

Example: 2018-08-22

userstring

filter parameter return jobs that created by user/users accept multi values

Example: 2,3

entity_typestring

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

200

{
  "count": 1,
  "limit": "text",
  "offset": 1,
  "order": "text",
  "orderby": "text",
  "curr": "text",
  "next": "text",
  "prev": "text",
  "total_count": 1,
  "results": [
    {
      "id": 1,
      "url": "text",
      "user": "{\"id\":1,\"url\":\"http://localhost:8000/api/v3/users/1\"}",
      "entity_type": "text",
      "fields": "text",
      "filters": {
        "status": [
          "text"
        ]
      },
      "status": "text",
      "header_row": {
        "label": "text",
        "key": "text",
        "type": "text",
        "input": "text",
        "unstructured": true,
        "id": "text",
        "instructions": "text",
        "required": "text",
        "default": "text",
        "options": "text",
        "cardinality": "text",
        "config": "text",
        "response_private": "text",
        "description": "text",
        "form_name": "text",
        "form_id": 1,
        "form_stage_id": 1,
        "form_stage_priority": 1,
        "priority": 1
      },
      "created": "text",
      "updated": "text",
      "url_expiration": 1,
      "include_hxl": true,
      "send_to_browser": true,
      "send_to_hdx": true,
      "allowed_privileges": [
        "text"
      ],
      "hxl_meta_data_id": 1,
      "total_batches": "text",
      "total_rows": "text",
      "hxl_heading_row": [
        "text"
      ]
    }
  ]
}

OK

add export

POST https://ushahididocs.api.ushahidi.io/api/v3/exports/jobs

Request Body

Name	Type	Description
user_id	String	The user identifier
url_expiration	Integer
updated	String
header_row	String
status	String
filters	String
fields	String
entity_type	String	The entity types
hxl_heading_row	String
send_to_hdx	String	Set true to send HXL and false not to send HXL
send_to_browser	String
include_hxl	Boolean	Set true to include HXL and false not to include HXL
total_rows	String
total_batches	String
hxl_meta_data_id	String

200: OK

{
    "id": 9,
    "url": null,
    "user": {
        "id": 2,
        "url": "http://localhost:8000/api/v3/users/2"
    },
    "entity_type": "post",
    "fields": null,
    "filters": {
        "status": [
            "all"
        ]
    },
    "status": "PENDING",
    "header_row": null,
    "created": "2022-11-02T15:42:55+00:00",
    "updated": null,
    "url_expiration": 0,
    "include_hxl": false,
    "send_to_browser": true,
    "send_to_hdx": false,
    "hxl_heading_row": null,
    "hxl_meta_data_id": null,
    "total_batches": null,
    "total_rows": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

edit export

PUT https://ushahididocs.api.ushahidi.io/api/v3/exports/jobs/1

Request Body

Name	Type	Description
user_id	String	The user identifier
url_expiration	Integer
updated	String
header_row	String
status	String
filters	String
fields	String
entity_type	String	The entity types
hxl_heading_row	String
send_to_hdx	String	Set true to send HXL and false not to send HXL
send_to_browser	String
include_hxl	Boolean	Set true to include HXL and false not to include HXL
total_rows	String
total_batches	String
hxl_meta_data_id	String

200: OK

{
    "id": 9,
    "url": null,
    "user": {
        "id": 2,
        "url": "http://localhost:8000/api/v3/users/2"
    },
    "entity_type": "post",
    "fields": null,
    "filters": {
        "status": [
            "all"
        ]
    },
    "status": "PENDING",
    "header_row": null,
    "created": "2022-11-02T15:42:55+00:00",
    "updated": null,
    "url_expiration": 0,
    "include_hxl": false,
    "send_to_browser": true,
    "send_to_hdx": false,
    "hxl_heading_row": null,
    "hxl_meta_data_id": null,
    "total_batches": null,
    "total_rows": null,
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
    ]
}

get export

get

/api/v3/exports/jobs/1

Authorizations

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

404

200

{
  "id": 1,
  "entity_type": "post",
  "created": "1970-01-01T00:00:00+00:00",
  "url_expiration": 0,
  "include_hxl": false,
  "send_to_browser": false,
  "send_to_hdx": false,
  "hxl_meta_data_id": 1,
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ],
  "user": {
    "id": 2,
    "url": "http://localhost:8000/api/v3/users/2"
  }
}

OK