Versions Compared

Version Old Version 6 New Version 7
Changes made by

Rodolfo Melia

Rodolfo Melia

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Locator API has the following 3 three endpoints. The endpoint for browsing the web API is /api/ and all the api resource are currently available under version 1 i.e /v2/.

URL

1

Locators or OrgUnits near by

api/v2/locator

2

List of Areas in a country

api/v2/area

3

List of subAreas in the country and area

api/v2/subArea

Common features

Pagination

...

Locator API supports pagination across all the endpoints listed above and is enabled by default.

Parameter

Option Values

Default Option

Description

paging

true | false

true

Indicates weather to return lists of elements in pages

page

number

1

Defines which page number to return

pageSize

number

10

Defines the number of elements to return for each page.

Method

...

Example

GET Request

method: GET

...

Payload

Get

api/v1/locator?paging=true&page=2&pageSize=5

POST Request

method: POST

...

n/a

Post

api/v1/locator

...

Code Block
languagejson
{
  "paging": "true",
  "page": "5",
  "pageSize": "5"
}

Response:

Code Block
languagejson
{
  "status": 200,
  "pager": {
    "page": 2,
    "pageCount": 120,
    "total": 243,
    "pageSize": 5,
    "nextPage": "{{host}}/api/v1/locator?paging=true&page=3&pageSize=5",
    "prevPage": "{{host}}/api/v1/locator?paging=true&page=3&pageSize=5"
  },
  "data": {...}
}