Versions Compared

Key

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

...

authorization: as setup in the sprint security [linkSpring.Framework.Security [Link]

Mandatory parameters - you must provide at least one of the following parameters

...

Parameter

Option Value

Default Option

Description

pageSize

number

1

Defines which page number to return.

distance

number

5

Defines radius within which you need to generate the organization Units

unit

m | km | mi

km

Define the unit for the distance

phone

text (phone Number)

N/A

DHIS2 core element | Defines the phone number of the location

DHIS2 custom ou attribute

type

text

Defines the type of the location.

tags

text (csv)

N/A

Defines the tags the locations are associated with.

services

text (csv)

N/A

Defines the services offered by the locations.

contraception

text (csv)

N/A

Defines the contraceptives services offered by the locations.

area

text

N/A

Defines the area where the locations is located.

subArea

text

N/A

Defines the subArea where the locations is located.

whatsapp

text (phone Number)

N/A

Defines the whatsapp number of the location

facebook

text | url

N/A

Defines the fb url for the location

payload: :

URL (for GET request):

https://{{host}}/api/v1/locator?paging=false&coordinates=lat,lng&distance=5&unit=km

Payload (for POST request):

Code Block
languagejson
{
  "pageSize": 10,
  "distance": 5,
  "unit": "km",
  "coordinates": "lat,lng",
  "ancestor.code": "KE",  ---> Remove
  "services": "service1,service2",
  "uid": 'q13we2452wsd',
  "code": "CODE-123",
  "contraception": "iud,imp",
  "tags": "tag1,tag2",
  "type": "Public",
  "area": "Managua",
  "subArea": "Ciudad Sandino",
  "phonenumber": "180999093107",
  "wap": "977984123145",
  "facebook": "https://fb.me/facility1"
}

responseResponse:

Code Block
languagejson
{
    "status": 200,
    "pager": {...}
    "outlets": [
        {
            "dhisCode": "KE-CODE-123",
            "dhisId": "xkcEJARvo2O",
            "servicesStandard": "CCS,CNT,ANC,STI,HVS,HVT",
            "outletType": "Public",
            "ouShowContactInfo": "TLF",
            "path": "",
            "outletName": "Facility Clinic",
            "phoneNumber": "+254541483334",
            "postgresId": "1511345870",
            "locatorType": "OUT",
            "location": {
                "area": "Nairobi",
                "areaSub": "Starehe",
                "address": "street1, city, subarea, area",
                "latitude": "-1.28575",
                "longitude": "39.81234"
            },
            "dhisName": "Facility Clinic (KE-CODE-123)",
            "openingHours": "Mon-Fri,8:00,17:00;Sat,9:00,14:00;Public Holiday,9:00,14:00;Sun,Closed",
            "openingDate": "2023-02-11",
            "ouTags": "MSI",
            "providers": [],
            "ouContraceptives": "IMP,OCP,IUD,INJ,STL,EMC"
        }
    ]
}