You can also view
You are viewing documentation for version 14.
This is the most recent stable release!
Create App
You can use the REST API to create Apps programatically.Request
POST https://cameratag.com/api/v14/apps.json
Parameters
Below is a list of parameters that this endpoint accepts.
Parameter | Accepted Values | Description | Required |
---|---|---|---|
api_key | a valid user api_key | All App endpoints require authentcation | Required |
name | * | The name of your application | Required |
region | us, eu, ap, sa | The name of the region in which you would like CameraTag to store your assets. (defaults to "us" if blank) | Required |
use_domain_auth | true / false | Turn on / off domain-based security | Optional |
domains[] | * | The authorized domain(s) for your app. To select more than one pass multiple domains[] params | Optional |
use_webhook | true, false | Turn on / off webhooks | Optional |
callback_trigger | processed, approved, rejected, featured | CameraTag will perform the callback after assets reach a specific state | Optional |
callback_url | * | A URL for the server callback functionality. | Optional |
use_email | true, false | Turn on / off Email notifications | Optional |
email_trigger | processed, approved, rejected, featured | CameraTag send an email after assets reach a specific state | Optional |
notification_email | * | An email to receive asset notifications | Optional |
publish_signature_required | true, false | require a valid signature for publishing of new assets | Optional |
playback_signature_required | true, false | require a valid signature for playback | Optional |
wall_privacy | none, all, whitelist, blacklist | Determines which assets are shown in videowalls connected to this app. | Optional |
use_ftp | true, false | Turn on / off FTP syndication | Optional |
ftp_trigger | processed, approved, rejected, featured | CameraTag will syndicate assets to your FTP account after they have reached the specified state | Optional |
ftp_server | * | A FTP server for FTP syndication | Optional |
ftp_username | * | A FTP user name for FTP syndication | Optional |
ftp_password | * | ftp_password | Optional |
ftp_directory | * | A FTP directory for FTP syndication | Optional |
ftp_protocol | ftp, sftp | Optional | |
use_s3 | true, false | Turn on / off S3 syndication | Optional |
s3_trigger | processed, approved, rejected, featured | CameraTag will syndicate assets to S3 after they have reached the specified state | Optional |
bucket_name | * | The name of your S3 Bucket (for S3 Syndication) | Optional |
s3_directory | * | An optional subdirectry into which assets should be placed | Optional |
s3_privacy | public-read, private, authenticated-read | The privacy settings for assets created in your S3 bucket | Optional |
s3_use_sse | true, false | Use server side encryption on S3 | Optional |
s3_key | * | An AWS Key with access to create objects and set ACLs | Optional |
s3_secret | * | An AWS Secret with access to create objects and set ACLs | Optional |
use_youtube | true, false | Turn on / off YouTube syndication | Optional |
youtube_trigger | processed, approved, rejected, featured | CameraTag will synicate assets after they have reached the sspecified state | Optional |
youtube_privacy | public, private | The privacy setting to videos created in your youtube account | Optional |
use_slack | true, false | Turn on / off Slack notifications | Optional |
slack_trigger | processed, approved, rejected, featured | CameraTag will notify your slack room after an asset reaches the specified state | Optional |
slack_url | * | The URL provided by the Slack webhook add-on | Optional |
slack_channel | * | The channel you would like us ti post to (starts with a #) | Optional |
Example Response
{ "uuid": "63f9c870-72c4-0130-04c5-123139045d73", "name": "Homepage", "callback_url": "http://postb.in/4c5DrNQy", "notification_email": "chris@cameratag.com", "bucket_name": "cameratagtest", "crop_length": null, "s3_privacy": "public-read", "s3_directory": "terst", "s3_use_sse": false, "publish_signature_required": false, "playback_signature_required": false, "ftp_server": "danzig-media.smartfile.com", "ftp_username": "cdanzig", "ftp_password": "424D.86K/7N?949iyp9;CJ{}=CL{w,Y+", "ftp_directory": "cameratag/directory/", "use_ftp": false, "use_s3": false, "use_youtube": true, "ftp_trigger": "processed", "email_trigger": "processed", "s3_trigger": "processed", "youtube_trigger": "processed", "wall_privacy": "whitelist", "photo_width": 640, "photo_height": 480, "media_factories": [ { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 8, "uuid": null, "name": "720p", "width": 1280, "height": 720, "area": 921600, "extension": "mp4", "length": "", "bitrate": null, "asset_class": "Video", "is_system": null, "created_at": "2017-05-07T07:22:58.000Z", "updated_at": "2017-06-02T02:33:11.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "camera", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 10, "uuid": null, "name": "vga_thumb", "width": 1280, "height": 720, "area": 921600, "extension": "jpg", "length": "", "bitrate": null, "asset_class": "Video", "is_system": true, "created_at": "2017-05-07T07:23:16.000Z", "updated_at": "2017-06-02T02:33:25.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "camera", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 11, "uuid": null, "name": "vga_filmstrip", "width": 1280, "height": 720, "area": 921600, "extension": "jpg", "length": 30, "bitrate": null, "asset_class": "Video", "is_system": true, "created_at": "2017-05-07T07:23:17.000Z", "updated_at": "2017-06-02T02:33:37.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "camera", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 82916, "uuid": null, "name": "vertical", "width": 720, "height": 1280, "area": 921600, "extension": "mp4", "length": "", "bitrate": null, "asset_class": "Video", "is_system": null, "created_at": "2019-04-16T13:20:00.000Z", "updated_at": "2019-04-16T13:20:00.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "camera", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 25, "uuid": null, "name": "waveform", "width": 2000, "height": 375, "area": 750000, "extension": "png", "length": null, "bitrate": null, "asset_class": "Audio", "is_system": true, "created_at": "2017-05-07T07:25:21.000Z", "updated_at": "2017-05-16T14:26:16.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "microphone", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 26, "uuid": null, "name": "negative_waveform", "width": 2000, "height": 375, "area": 750000, "extension": "png", "length": null, "bitrate": null, "asset_class": "Audio", "is_system": true, "created_at": "2017-05-07T07:25:21.000Z", "updated_at": "2017-05-16T14:26:16.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "microphone", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 27, "uuid": null, "name": "photo", "width": 640, "height": 480, "area": 307200, "extension": "jpg", "length": null, "bitrate": null, "asset_class": "Photo", "is_system": true, "created_at": "2017-05-07T07:25:21.000Z", "updated_at": "2017-05-16T14:26:16.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "photobooth", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 109876, "uuid": null, "name": "Giphy", "width": 640, "height": 480, "area": 307200, "extension": "gif", "length": "10", "bitrate": null, "asset_class": "Video", "is_system": null, "created_at": "2020-05-05T01:01:03.000Z", "updated_at": "2020-05-05T01:01:03.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": 12.0, "offset": 0.0, "source": "camera", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 134277, "uuid": null, "name": "user_stream", "width": 640, "height": 480, "area": 307200, "extension": "mp4", "length": null, "bitrate": null, "asset_class": "Video", "is_system": true, "created_at": "2020-07-01T10:57:42.000Z", "updated_at": "2020-07-01T10:57:42.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "room", "media_source": "composite", "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 134278, "uuid": null, "name": "user_thumb", "width": 640, "height": 480, "area": 307200, "extension": "jpg", "length": null, "bitrate": null, "asset_class": "Video", "is_system": true, "created_at": "2020-07-01T10:57:42.000Z", "updated_at": "2020-07-01T10:57:42.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "room", "media_source": "composite", "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 134279, "uuid": null, "name": "user_filmstrip", "width": 640, "height": 480, "area": 307200, "extension": "jpg", "length": 30, "bitrate": null, "asset_class": "Video", "is_system": true, "created_at": "2020-07-01T10:57:42.000Z", "updated_at": "2020-07-01T10:57:42.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "room", "media_source": "composite", "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 92166, "uuid": null, "name": "Original", "width": null, "height": null, "area": null, "extension": null, "length": null, "bitrate": null, "asset_class": "Video", "is_system": null, "created_at": "2019-11-25T14:49:10.000Z", "updated_at": "2019-11-25T14:49:10.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "camera", "media_source": null, "auto_rotate": true }, { "camera_id": "63f9c870-72c4-0130-04c5-123139045d73", "id": 24, "uuid": null, "name": "mp3", "width": null, "height": null, "area": null, "extension": "mp3", "length": null, "bitrate": null, "asset_class": "Audio", "is_system": true, "created_at": "2017-05-07T07:25:21.000Z", "updated_at": "2017-05-07T07:25:21.000Z", "fg_color": null, "deleted_at": null, "language": null, "fps": null, "offset": null, "source": "microphone", "media_source": null, "auto_rotate": true } ], "domains": [ ] }