Skip to main content

Upload a photo

POST 
/api/photo/upload

Upload a photo to the Ownli cloud. All photos used for check-ins need to be uploaded to the Ownli cloud first.

Request​

Header Parameters

    partnerId stringrequired

    Partner Id

    clientId stringrequired

    Client Id

    clientSecret stringrequired

    Client Secret

Body

required

    userId stringrequired
    name stringrequired

    User defined file name of the photo. You can give a name that makes it easier the URL easier to identify. Also it will be helpful to provide a suffix so tools like a Browser, Finder or explorer can display it automatically.

    photo stringrequired

    Base64 encoded string representation of the photo.

    deviceIdentifier string

    Unique identifier of the device on which the photo was taken.

    deviceManufacturer string

    The manufacturer of the device on which the photo was taken. e.g. Apple, Xiaomi, Samsung, OPPO, OnePlus etc.

    deviceModel string

    The model of the device on which the photo was taken. e.g. LM-G900, motorola edge, IPad, IPhone 14

    deviceOS string

    The OS of the device on which the photo was taken. Android 9, iOS 13.2.3 etc.

    takenOn stringrequired

    [takenOn] The timestamp at which the photo was taken. (The date should be in the ISO8601 UTC format YYY-MM-DDThh:mm:ss.SSSZ; eg: 2024-01-01T00:00:00.000Z

    latitude doublerequired

    Latitude at which photo was taken.

    longitude doublerequired

    Longitude at which photo was taken.

Responses​

Photo object created by the upload.

Schema

    userId string

    Id of the owner

    photoUrl string

    URL of the photo

    deviceIdentifier string

    Device identifier of the device on which photo was taken

    deviceManufacturer string

    Manufacturer of the device on which photo was taken

    deviceModel string

    Model of the device on which photo was taken

    deviceOS string

    OS of the device on which photo was taken

    takenOn string

    The timestamp at which the photo was taken

    latitude double

    Latitude of the location at which photo was taken

    longitude double

    Longitude of the location at which photo was taken

Loading...