VINOVO

API Credentials

You can find your API token under settings on the dashboard ( https://vinovo.si/dash/settings )

Rate Limit

API requests are rate limited to 10 per second

RESPONSE

{
  "status": 429,
  "msg": "Too many requests",
}

ACCOUNT

Account Information

Get basic info of your account

GET

https://api.vinovo.si/api/account/info?key={your_api_token}

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2024-01-11 14:25:09",
  "status": 200,
  "result": {
      "email": "[email protected]",
      "balance": "0.00000",
      "storage_used" :"24186265",
  }
}

Account Statistics

Get download and earnings statistics (default last 7 days)

GET

https://api.vinovo.si/api/account/stats?key={your_api_token}

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
last	Last x days report
from_date	From date ( YYYY-MM-DD )
to_date	To date ( YYYY-MM-DD )

RESPONSE

{
  "msg": "OK",
  "server_time": "2024-01-11 14:25:09",
  "status": 200,
  "result": [
    {
      "profit_views": "0.00000",
      "downloads": "0",
      "views": "0",
      "day": "2017-08-11",
      "profit_total": "0.00000"
    },
    {
      "profit_views": "0.00000",
      "downloads": "0",
      "views": "0",
      "day": "2017-08-12",
      "profit_total": "0.00000"
    }
  ]
}

Abuse List

Get abuse files list (500 results per page)

GET

https://api.vinovo.si/api/abuse/list?key={your_api_token}

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
per_page	Results per page (default 500)
page	Page Number

RESPONSE

{
  "msg": "OK",
  "server_time": "2024-01-11 14:25:09",
  "status": 200,
  "result": [
    {
      "reported_on": "2024-01-11 14:25:09",
      "file_code": "abc",
      "fld_id": "0",
      "disabled_on": "2024-01-11 17:25:09"
    }
  ]
}

Inactive List

Get deleted inactive files list (500 results per page)

GET

https://api.vinovo.si/api/inactive/list?key={your_api_token}

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
per_page	Results per page (default 500)
page	Page Number

RESPONSE

{
  "msg": "OK",
  "server_time": "2024-01-11 14:25:09",
  "status": 200,
  "result": [
	{
      "file_code": "abc",
      "fld_id": "0",
      "disabled_on": "2024-01-11 17:25:09"
    }
  ]
}

UPLOAD

Video Upload

Upload videos from your device

GET UPLOAD URL

A new URL must be requested for each upload

GET

https://api.vinovo.si/api/upload/server?key={your_api_token}

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2024-01-11 14:20:09",
  "status": 200,
  "result": "https://vincdn.net/upload/abc"
}

UPLOAD

POST

{UPLOAD URL}

PARAMETER	DESCRIPTION	REQUIRED
api_key	Your API token	Yes
file	Local file	Yes
fld_id	Folder ID

UPLOAD EXAMPLE

curl -X POST -F 'api_key={your_api_key}' -F '[email protected]' https://vincdn.net/upload/abc

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": [
    {
      "embed_url": "https://example.com/e/abc",
      "download_url": "https://example.com/d/abc",
      "filecode": "abc",
      "title": "test_file"
    }
  ]
}

Copy or Clone

Copy / Clone any file on the platform

GET

https://api.vinovo.si/api/file/clone?key={your_api_token}&file_code=abc

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
file_code	File code	Yes
fld_id	Folder ID to download file into

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": {
    "embed_url": "https://example.com/e/abc",
    "download_url": "https://example.com/d/abc",
    "filecode": "abc"
  }
}

REMOTE UPLOAD

Add URL

Upload file from url

GET

https://api.vinovo.si/api/upload/url?key={your_api_token}&url=https://example.com/video.mp4

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
url	File URL	Yes
fld_id	Folder ID to download file into
new_title	New file title

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": {
    "embed_url": "https://example.com/e/abc",
    "download_url": "https://example.com/d/abc",
    "filecode": "uzn191zlw6z0tw"
  },
  "total_slots": 100,
  "used_slots": 0
}

Remote Upload List

Remote Upload List & Status

GET

https://api.vinovo.si/api/urlupload/list?key={your_api_token}

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": [
    {
      "bytes_total": "0",
      "created": "2023-02-10 02:10:17",
      "remote_url": "https://example.com/video.mp4",
      "status": "pending|working|complete|error",
      "file_code": "uzn191zlw6z0tw",
      "bytes_downloaded": "0",
      "folder_id": "0"
    }
  ]
}

Remote Upload Status

Get file id remote upload status

GET

https://api.vinovo.si/api/urlupload/status?key={your_api_token}&file_code=uzn191zlw6z0tw

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
file_code	File code	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": [
    {
      "bytes_total": "0",
      "created": "2023-02-10 02:10:17",
      "remote_url": "https://example.com/video.mp4",
      "status": "pending|working|complete|error",
      "file_code": "uzn191zlw6z0tw",
      "bytes_downloaded": "0",
      "folder_id": "0"
    }
  ]
}

Remote Upload Slots

Get remote upload slots information

GET

https://api.vinovo.si/api/urlupload/slots?key={your_api_token}

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "total_slots": 100,
  "used_slots": 10
}

Remote upload actions

Perform various actions on remote upload

GET

https://api.vinovo.si/api/urlupload/actions?key={your_api_token}&clear_all=1

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
restart_errors	Restart all errors
clear_errors	Clear all errors
clear_all	Clear all complete transfers
delete_code	Delete a transfer (file_code)

RESPONSE

{
  "msg": "Errors restarted",
  "server_time": "2023-02-10 02:10:17",
  "status": 200
}

MANAGE FOLDERS

Create Folder

Create a folder

GET

https://api.vinovo.si/api/folder/create?key={your_api_token}&name=Samples

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
name	Name of the folder	Yes
parent_id	Parent folder ID

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": {
    "fld_id": "1234567"
  }
}

Rename Folder

Rename a folder

GET

https://api.vinovo.si/api/folder/rename?key={your_api_token}&fld_id=1234567&name=NewName

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
fld_id	Folder ID	Yes
name	Folder new name	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": "true"
}

List Folders & Files

List all folders and files

GET

https://api.vinovo.si/api/folder/list?key={your_api_token}&fld_id=1234567

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
page	Page number
per_page	Files per page (Maximum 200)
fld_id	Folder ID	Yes
only_folders	To list only folders (0 or 1)

RESPONSE

{
    "msg":"OK",
	"server_time":"2023-10-17 07:31:01",
    "status":200,
    "result":{
        "folders":[
            {
            "name":"New Folder 2",
            "fld_id":"12345678"
            },
        ],
        "files": [
              {
                "download_url": "https://example.com/d/abc",
                "single_img": "https://example.com/img/abc.jpg",
                "file_code": "abc",
                "canplay": 1,
                "length": "111",
                "views": "1",
                "uploaded": "2023-02-10 02:10:17",
                "fld_id": "0",
                "title": "video1"
              }
        ]
    }
}

List Files

List files only

GET

https://api.vinovo.si/api/file/list?key={your_api_token}

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
page	Page number
per_page	Files per page (Maximum 200)
search_term	Search file name
fld_id	Folder ID
created	Show files uploaded older than timestamp (Eg: 2021-10-07 03:15:19) Or specify an number to return files uploaded older than X minutes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": {
    "files": [
      {
        "download_url": "https://example.com/d/abc",
        "single_img": "https://example.com/img/abc.jpg",
        "splash_img": "https://example.com/splash/abc.jpg",
        "file_code": "abc",
        "canplay": 1,
        "length": "111",
        "views": "1",
        "uploaded": "2023-02-10 02:10:17",
        "fld_id": "0",
        "title": "video1"
      }
    ],
    "total_pages": 1,
    "results_total": "1",
    "results": 1
  }
}

File Status

Check status of your files

GET

https://api.vinovo.si/api/file/check?key={your_api_token}&file_code=abc,abc2

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
file_code	File code (comma separated)	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": [
    {
      "status": "Active",
      "filecode": "abc1"
    },
    {
      "status": "Not found",
      "filecode": "abc2"
    }
  ]
}

File Info

Get file info

GET

https://api.vinovo.si/api/file/info?key={your_api_token}&file_code=abc,abc2

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
file_code	File code (comma separated)	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": [
    {
      "single_img": "https://example.com/img/abc.jpg",
      "splash_img": "https://example.com/splash/abc",
      "status": 200|pending|working|error|removed,
      "filecode": "abc",
      "canplay": 1,
      "size": "111",
      "views": "0",
      "length": "111",
      "folder": 0,
      "uploaded": "2023-02-10 02:10:17",
      "last_view": "2023-02-10 02:22:17",
      "title": "video1"
    },
    {
      "status": "Not found",
      "filecode": "abc2"
    }
  ]
}

File Image

Get file splash, single or thumbnail image

GET

https://api.vinovo.si/api/file/image?key={your_api_token}&file_code=abc

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
file_code	File code (comma separated)	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": [
    {
      "filecode": "abc",
      "single_img": "https://example.com/img/abc.jpg",
      "thumb_img": "https://example.com/thumb/abc.jpg",
      "splash_img": "https://example.com/splash/abc.jpg"
    }
  ]
}

File Rename

Rename a file

GET

https://api.vinovo.si/api/file/rename?key={your_api_token}&file_code=abc&title=video2

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
file_code	File code	Yes
title	New file title	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": "true"
}

File Move

Rename a file

GET

https://api.vinovo.si/api/file/move?key={your_api_token}&file_code=abc&fld_id=1234567

PARAMETER	DESCRIPTION	REQUIRED
key	Your API token	Yes
file_code	File code	Yes
fld_id	Folder ID to move the file to (set 0 for / directory)	Yes

RESPONSE

{
  "msg": "OK",
  "server_time": "2023-02-10 02:10:17",
  "status": 200,
  "result": "true"
}