RD_SavePodcast
7
October 2020
Rivendell C Library Manual

# rd_savepodcast

Rivendell Save Podcast C Library Function
Fred
Gleason
fredg@paravelsystems.com
Rivendell C Library Author

          #include <rivwebcapi/rd_savepodcast.h>

          int RD_SavePodcast
          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.

### 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.