Мы обновили документацию, актуальная версия страницы доступна по ссылке: Звуковые файлы (/sound/)

При загрузке файлов через метод POST следует установить заголовок Content-Type в значение multipart/form-data с указанием параметра boundary, который содержит последовательность символов, разделяющую части тела запроса. Параметры звукового файла и сам файл передаются как поля формы. Во всех остальных методах, в том числе и обновлении информации о звуковом файле, следует использовать обычный Content-Type: application/json и передавать информацию в JSON-формате.

Стоит отметить, что в большинстве случаев различные библиотеки для работы с веб-ресурсами генерируют тело запроса и заголовок Content-Type с параметром boundary автоматически.

Request URL: https://hostname.domain/api/ver1.0/client/@me/sound/
Request Method: POST
Authorization: Bearer token
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryRJjeZXUAAoerF744
Host: hostname.domain
------WebKitFormBoundaryRJjeZXUAAoerF744
Content-Disposition: form-data; name="file"; filename="test_sound.wav"
Content-Type: audio/wav


------WebKitFormBoundaryRJjeZXUAAoerF744
Content-Disposition: form-data; name="title"

Файл приветствия
------WebKitFormBoundaryRJjeZXUAAoerF744--

user@host$ curl -i -X POST -F file=@hello.wav -F"title=мой файл приветствия" -H"Authorization: Bearer TSyAxXtAsbE9Kl0iAVGG6LmnfEte8X" https://host.domain/api/ver1.0/client/@me/sound/
HTTP/1.1 100 Continue
HTTP/1.1 201 CREATED
Server: nginx/1.8.0
Date: Tue, 11 Aug 2015 09:50:41 GMT
Content-Type: application/json
Content-Length: 150
Connection: keep-alive
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, PATCH, OPTIONS
Access-Control-Allow-Headers: Content-Type, api_key, Authorization
{"id": 51, "client_id": 12, "title": "мой файл приветствия", "dealer_id": null, "filename": "84594e4f-e1a8-4b48-a613-38264fe60201.wav"}

#!/usr/bin/python
# -*- coding: utf-8 -*-

import requests
import json

# Установка параметров
API_HOST = "https://hostname.domain"
APP_ID = "APP_ID"
APP_SECRET = "APP_SECRET"
REDIRECT_URI = ""

# Получение авторизации
body = {
    'grant_type': 'client_credentials',
    'client_id': APP_ID,
    'client_secret': APP_SECRET,
}

request_url = "{host}/oauth/token".format(host=API_HOST)
response = requests.post(request_url, data=body, verify=False)

if response.status_code == 200:
    # Получение токена доступа
    access_token = response.json()['access_token']
elif response.status_code == 401:
    print 'Ошибка авторизации: {error}'.format(error=response.json()['error'])
    exit(1)
else:
    print 'Неизвестная ошибка'
    exit(2)

# Установка заголовка авторизации
headers = {
    'Authorization': 'Bearer {access_token}'.format(access_token=access_token)  # Заголовок авторизации
}

files = {'file': open('test_file.wav', 'rb')}
data = {'title': 'Файл приветствия'}

request_url = "{host}/api/ver1.0/client/@me/sound/".format(host=API_HOST)
response = requests.post(request_url, files=files, data=data, headers=headers)
if response.status_code == 201:
    file_info = response.json()
    print file_info
else:
    print response.text