Name

rd_savepodcast — Rivendell Save Podcast C Library Function

Synopsis

#include <rivwebcapi/rd_savepodcast.h>
int RD_SavePodcast(hostname[],  
 username[],  
 passwd[],  
 ticket[],  
 cast_id,  
 filename[],  
 user_agent[]); 
const char hostname[];
const char username[];
const char passwd[];
const char ticket[];
const unsigned cast_id;
const char filename[];
const char user_agent[];
 

Description

RD_SavePodcast is the function to use to copy finished RSS item audio to the Rivendell audio store.

Table 1. RD_SavePodcast function call fields

FIELD NAME FIELD TYPE MEANING REMARKS
hostname Character Array Name Of Rivendell DB Host Mandatory When NO Ticket Provided
username Character Array Rivendell User Name Mandatory
passwd Character Array Rivendell User Password Mandatory When NO Ticket Provided
ticket Character Array Rivendell Authentification Ticket Mandatory When NO User/Password Pair Provided.
cast_id unsigned integer ID of podcast item Mandatory
filename character array File Name for Source Audio Mandatory
user_agent Character Array User Agent Value put into HTTP request Optional (default is Rivendell-C-API/x.x.x)

RETURN VALUE

On success, zero is returned.

If a server error occurs a -1 is returned. If a client error occurs a specific error number is returned.

ERRORS

400 Missing Podcast ID

400 Missing filename

403 User Authentification Error.

404 Unauthorized or no such podcast

nnn Unknown Error Occurred.