Get read details

Description

Returns all the details of a read. A "read" is the recording submitted by a voice actor for any given project.

Response example

{
  "reads":[
    {
      "id":"1",
      "talentID":false,
      "status":"reviewable",
      "project":"2",
      "urls":{
        "part001":{
          "default":"https:\/\/voicebunny.s3.amazonaws.com\/dev\/2_aa70601bd0c0c323872c2d81e93f369f.mp3?h=1",
          "original":"https:\/\/voicebunny.s3.amazonaws.com\/dev\/2_e8861ad42488c482426bc6ae59437b79.wav?h=1"
        }
      },
      "revisions":[
        {
          "id":"1",
          "status":"revisionCanceled",
          "url":"https:\/\/api.voicebunny.com\/reads\/1\/revision\/1"
        }
      ],
      "created":1327403069
    }
  ],
  "timestamp":1571315372
}
<?xml version="1.0" encoding="UTF-8"?>
<reads>
  <read>
    <id>1</id>
    <talentID>0</talentID>
    <status>reviewable</status>
    <project>2</project>
    <urls>
      <part>
        <default>https://voicebunny.s3.amazonaws.com/dev/2_aa70601bd0c0c323872c2d81e93f369f.mp3?h=1</default>
        <original>https://voicebunny.s3.amazonaws.com/dev/2_e8861ad42488c482426bc6ae59437b79.wav?h=1</original>
      </part>
    </urls>
    <revisions>
      <id>1</id>
      <status>revisionCanceled</status>
      <url>https://api.voicebunny.com/reads/1/revision/1</url>
    </revisions>
    <created>1327403069</created>
  </read>
  <timestamp>1571315372</timestamp>
</reads>

Errors

  • 5003: No results were found.

Code example

@Grab(group='org.codehaus.groovy.modules.http-builder', module='http-builder', version='0.5.2' )

import groovyx.net.http.*
import groovy.json.*
import static groovyx.net.http.ContentType.*
import static groovyx.net.http.Method.*

http = new HTTPBuilder('https://api.voicebunny.com')
http.handler.success = {response, json -> return json}
http.handler.failure = {response, json -> throw new RuntimeException(json.error.code + ' ' + json.error.message)}
def voicebunnyUser = 'xxXXxx'
def voicebunnyToken = 'xxxxXXXXxxxxXXXX'
def readId = 'x'
http.auth.basic voicebunnyUser, voicebunnyToken
def read = http.get(path: 'reads/' + readId, requestContentType: URLENC)
import java.io.*;
import java.net.*;
import org.apache.commons.codec.binary.Base64;

public class Voicebunny {

    private String user = "xxXXxx";

    private String token = "xxxxXXXXxxxxXXXX";

    private String encodedAuthorization = "";

    private String host = "https://api.voicebunny.com";

    public Voicebunny() {
        String userpassword = user + ":" + token;
        encodedAuthorization = Base64.encodeBase64String(userpassword.getBytes());
    }

    public static void main(String[] args) throws IOException {
        Voicebunny vb = new Voicebunny();
        System.out.println(vb.getRead("readId"));
    }

    private String getRead(String id) throws ProtocolException, IOException {
        return get("reads/" + id);
    }

    private String get(String resource) throws IOException, ProtocolException {
        URL url = new URL(host + "/" + resource);
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setRequestMethod("GET");
        connection.setRequestProperty("Authorization", "Basic " + encodedAuthorization);
        connection.connect();
        InputStream in = connection.getInputStream();
        BufferedReader reader = new BufferedReader(new InputStreamReader(in));
        StringBuffer sb = new StringBuffer();
        String line = "";
        while ((line = reader.readLine()) != null) {
            sb.append(line);
        }
        reader.close();

        return sb.toString();
    }

}
<?php
$readId = 'x';
$url_api = 'https://api.voicebunny.com/reads/' . $readId;
$opts = array(
	CURLOPT_URL => $url_api,
	CURLOPT_RETURNTRANSFER => TRUE,
	CURLOPT_INFILESIZE => -1,
	CURLOPT_TIMEOUT => 60,
	CURLOPT_SSL_VERIFYPEER => false,
	CURLOPT_HTTPGET => TRUE,
);
$curl = curl_init();
curl_setopt_array($curl, $opts);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
print_r($response);
?>
import requests
import simplejson
from requests.auth import HTTPBasicAuth

url = 'https://api.voicebunny.com'
api_id = 'XX'
api_key = "xxxxXXXXxxxxXXXX"
read_id = 'XX'
req = requests.get(url+'/reads/'+read_id,
    auth=HTTPBasicAuth(api_id, api_key),verify=False)
data = simplejson.loads(req.text)
response = data['reads']
require 'faraday'
require 'faraday_middleware'

@conn = nil
@api_id = "XX"
@api_key = "xxxxXXXXxxxxXXXX"
read_id = "X"
resp = nil

@conn = Faraday.new(:url =>("https://"+ @api_id+":"+@api_key +"@api.voicebunny.com"),:ssl => {:verify => false}) do |builder|
	builder.use Faraday::Request::Multipart
	builder.use Faraday::Request::UrlEncoded
	builder.use Faraday::Response::ParseJson
	builder.use Faraday::Adapter::NetHttp		  
end

resp = @conn.get '/projects/reads/'+read_id+'.json'
resp.body