Practical API Examples

import os, requests, pprint
BASE="https://api.hostedcloudvideo.com"
API=os.environ["API_KEY"]
r=requests.get(f"{BASE}/v1/authorizeV2",headers={"Authorization":f"Bearer {API}"})
pprint.pp(r.json())

<?php
$base='https://api.hostedcloudvideo.com';$api=getenv('API_KEY');
$ch=curl_init("$base/v1/authorizeV2");
curl_setopt_array($ch,[CURLOPT_HTTPHEADER=>["Authorization: Bearer $api"],
                      CURLOPT_RETURNTRANSFER=>true]);
echo curl_exec($ch);

curl -H "Authorization: Bearer <API_KEY>" \
  https://api.hostedcloudvideo.com/v1/authorizeV2

import os, requests, json
BASE="https://api.hostedcloudvideo.com";ACCT="<ACCOUNT_ID>"
r=requests.get(f"{BASE}/v1/accounts/{ACCT}/cameras",
               headers={"Authorization":f"Bearer {os.environ['API_KEY']}"})
print(json.dumps(r.json(),indent=2))

<?php
$base='https://api.hostedcloudvideo.com';$acct='<ACCOUNT_ID>';$api=getenv('API_KEY');
$ch=curl_init("$base/v1/accounts/$acct/cameras");
curl_setopt_array($ch,[CURLOPT_HTTPHEADER=>["Authorization: Bearer $api"],
                      CURLOPT_RETURNTRANSFER=>true]);
echo curl_exec($ch);

curl -H "Authorization: Bearer <API_KEY>" \
  https://api.hostedcloudvideo.com/v1/accounts/<ACCOUNT_ID>/cameras

import os, requests, json, datetime as dt
BASE="https://api.hostedcloudvideo.com";ACCT="<ACCOUNT_ID>"
since=(dt.datetime.utcnow()-dt.timedelta(days=1)).isoformat()+"Z"
url=f"{BASE}/v1/accounts/{ACCT}/health-history?start={since}"
r=requests.get(url,headers={"Authorization":f"Bearer {os.environ['API_KEY']}"})
print(json.dumps(r.json(),indent=2))

<?php
$base='https://api.hostedcloudvideo.com';$acct='<ACCOUNT_ID>';$api=getenv('API_KEY');
$since=urlencode(gmdate('c',time()-86400));
$ch=curl_init("$base/v1/accounts/$acct/health-history?start=$since");
curl_setopt_array($ch,[CURLOPT_HTTPHEADER=>["Authorization: Bearer $api"],
                      CURLOPT_RETURNTRANSFER=>true]);
echo curl_exec($ch);

curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.hostedcloudvideo.com/v1/accounts/<ACCOUNT_ID>/health-history?start=$(date -u -Iseconds -d '1 day ago')" 

import os, requests
BASE="https://api.hostedcloudvideo.com";CAM="<CAMERA_ID>"
payload={"name":"Front Door","timezone":"America/Toronto"}
r=requests.put(f"{BASE}/v1/cameras/{CAM}",
  headers={"Authorization":f"Bearer {os.environ['API_KEY']}",
           "Content-Type":"application/json"},json=payload)
print(r.status_code)

<?php
$base='https://api.hostedcloudvideo.com';$cam='<CAMERA_ID>';$api=getenv('API_KEY');
$data=json_encode(['name'=>'Front Door','timezone'=>'America/Toronto']);
$ch=curl_init("$base/v1/cameras/$cam");
curl_setopt_array($ch,[CURLOPT_CUSTOMREQUEST=>'PUT',
  CURLOPT_HTTPHEADER=>["Authorization: Bearer $api",'Content-Type: application/json'],
  CURLOPT_POSTFIELDS=>$data,CURLOPT_RETURNTRANSFER=>true]);
echo curl_exec($ch);

curl -X PUT -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Front Door","timezone":"America/Toronto"}' \
  https://api.hostedcloudvideo.com/v1/cameras/<CAMERA_ID>

import os, requests, datetime as dt, pathlib
BASE,CAM="https://api.hostedcloudvideo.com","<CAMERA_ID>"
HEAD={"Authorization":f"Bearer {os.environ['API_KEY']}"}
start,end=dt.datetime(2025,5,1,8),dt.datetime(2025,5,1,18)
t=start
while t<=end:
  ts=t.isoformat()+"Z"
  img=requests.get(f"{BASE}/v1/cameras/{CAM}/snapshot?time={ts}",headers=HEAD).content
  pathlib.Path(f"snap_{ts}.jpg").write_bytes(img)
  t+=dt.timedelta(hours=1)

<?php
$base='https://api.hostedcloudvideo.com';$cam='<CAMERA_ID>';$api=getenv('API_KEY');
for($t=strtotime('2025-05-01 08:00 UTC');$t<=strtotime('2025-05-01 18:00 UTC');$t+=3600){
  $ts=urlencode(gmdate('c',$t));
  $ch=curl_init("$base/v1/cameras/$cam/snapshot?time=$ts");
  curl_setopt_array($ch,[CURLOPT_HTTPHEADER=>["Authorization: Bearer $api"],
                        CURLOPT_RETURNTRANSFER=>true]);
  file_put_contents("snap_$ts.jpg",curl_exec($ch));
  curl_close($ch);
}

curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.hostedcloudvideo.com/v1/cameras/<CAMERA_ID>/snapshot?time=2025-05-01T12:00:00Z" \
  -o noon.jpg

import os, requests, datetime as dt
UP,CAM="https://upload.hostedcloudvideo.com","<CAMERA_ID>"
payload={"start":dt.datetime.utcnow().isoformat()+"Z",
         "end":(dt.datetime.utcnow()+dt.timedelta(seconds=10)).isoformat()+"Z",
         "types":{"custom":[{"types":["pointOfSale"],"actions":["Paid","Refund"],
           "boundingBox":{"width":100,"height":200,"left":300,"top":400},
           "freeformAttributes":{"storeId":"789","city":"Tampa Bay"}}]}}
r=requests.post(f"{UP}/notify/custom/{CAM}",
  headers={"Authorization":f"Bearer {os.environ['API_KEY']}",
           "Content-Type":"application/json"},json=payload)
print(r.status_code)

<?php
$up='https://upload.hostedcloudvideo.com';$cam='<CAMERA_ID>';$api=getenv('API_KEY');
$payload=["start"=>gmdate('c'),"end"=>gmdate('c',time()+10),
          "types"=>["custom"=>[["types"=>["pointOfSale"],"actions"=>["Paid","Refund"],
            "boundingBox"=>["width"=>100,"height"=>200,"left"=>300,"top"=>400],
            "freeformAttributes"=>["storeId"=>"789","city"=>"Tampa Bay"]]]]];
$ch=curl_init("$up/notify/custom/$cam");
curl_setopt_array($ch,[CURLOPT_HTTPHEADER=>["Authorization: Bearer $api","Content-Type: application/json"],
                      CURLOPT_POST=>true,CURLOPT_POSTFIELDS=>json_encode($payload),
                      CURLOPT_RETURNTRANSFER=>true]);
echo curl_exec($ch);

curl -X POST -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d @payload.json \
  https://upload.hostedcloudvideo.com/notify/custom/<CAMERA_ID>