To Run Advertisement Campaign

Below are the API set anyone can use to broadcast their Advertisment with in Pando Networks.

Step-1 To Post Advertisment.

By using this API licence owner can broadcast their advertiment in Pando Networks.

Create Job For Advertisment

POST https://testnet.rtservices.pandoproject.org/apis/campaign

This api is used for post Advertisement for RT-Mobile

Request Body

Name	Type	Description
purposeCode*	5	This purpose code -5 set for RT-Mobile services.
campaignName*	Name	Campaign Title
url*	"https//:"	Ads Redirection Url
description*	"xyz"	Description About Campaign
owner*	aaa992929-2292	Wallet Address of Campign owner
securityKey*	public	public,key,domain(Type of security)
domain	String	only paas when security is domain based
fromTimestamp*	2023-05-17T10:19:00.000Z	Time to start Visibility Ads
toTimestamp*	2023-05-18T10:19:00.000Z	Time to stop Visiblilty Ads
fromCountry*	india	from which country we are posting ads
toCountry*	France	Ads Target Company
booster*	True/False	if true then only Target country will see Ads with high priority or In case of False All country have visiblity

200: OK Possible outcome mentioned Below

Url ,Sessionkey and Campaign id is important for further use (step 2)api

400: Bad Request "message": "Please pass required fields in request body"

in case of mandatory field is empty

401: Unauthorized "Your license key has been expired"

In case of purpose code is blank or Invalid Bearer Token

R
{
    "message": "Please upload banner or video for this ad detail",
    "data": {
        "url": "testing1.pandoprojectdata.org",
        "sessionKey": "8f9dd6be-c1b0-4b76-bec7-2d6c00cff3c1",
        "status": true,
        "campaignId": "64aa2f932812a2179bb15124"
    },
    "status": 200
}

Step-2 To Upload Banner for Advertisment in RTpro.

By using this API licence user can upload banner

in this step we are using Url and session key from step -1 Response.

we are uploading Banner in this api

POST https://testing1.pandoprojectdata.org/fileupload

Request Body

Name	Type	Description
sessionKey*	String	Recived from step-1
files*	String	File which we want to upload

200: OK { "message": "your file(s) is successfully uploaded", "responseArray": [ { "fileId": "64aa3164bb118a9e4e5ff741", "fileName": "Group 2898234d841c3d-4947-4795-abbc-eea8d2976bc61688875364235.png", "fileSize": 79680, "originalName": "Group 289823.png" } ] }

401: Unauthorized "message": "Invalid Request!"

{
    "message": "your file(s) is successfully uploaded",
    "responseArray": [
        {
            "fileId": "64aa3164bb118a9e4e5ff741",
            "fileName": "Group 2898234d841c3d-4947-4795-abbc-eea8d2976bc61688875364235.png",
            "fileSize": 79680,
            "originalName": "Group 289823.png"
        }
    ]
}

Step-3 To Create Download Url for Ads by using RTpro.

By using this API licence user can Create download Url

in this step we are using Url and session key and fileid from Step -1 and Step -2 Response.

Download url will generate using this api.

GET Url/filedownload?fileId=&sessionKey=

Request Body

Name	Type	Description
fileId*	String
sessionKey*	String

200: OK Image Banner will show

Both field is valid and url is correct

401: Unauthorized "message": "Something went wrong"

If any is invalid or Wrong

Step-4 To add download url in ads Api.

By using this API licence user can upload ads

in this step we are using Url and session key and fileid from Step -1 and Step -3 Response.

Add file url

POST https://Testnet.rtservices.pandoproject.org/apis/upload

in which we upload download url in video url field.

Request Body

Name	Type	Description
purposeCode*	5	its mandatory code for Ads upload
url*	download url	Url Recived from Step-3
campaignId*	String	Recived from stepn-1 Api

200: OK your Camapign is successfully post for Approval

401: Unauthorized invalid Request

To Get Random Advertisment

By using this API we can get the random advertisment to further show in our application.

To Get Adverstisement detail on basis of country Latitude and longitude wise

GET https://Testnet.rtservices.pandoproject.org/apis/randomCampaign?latitude=&longitude=

if we not pass any body field then we will see non Booster ads by default.

Request Body

Name	Type	Description
latitude*	51.5072
longitude*	0.1276

200: OK Ads Detail will show

401: Unauthorized "message": "Authentication Failed. Token Expired or Malformed Token"

in case of Invalid Token

500: Internal Server Error "message": "Failed to get location on the basis of longitude and latitude"

mismatch Lat and long Deatil