go>> python-bandwidth>> 返回
项目作者： Bandwidth

项目描述 ：
Public API for interfacing with Bandwidth from Python
高级语言： Python
项目地址: git://github.com/Bandwidth/python-bandwidth.git
创建时间： 2016-10-18T13:23:19Z
项目社区：https://github.com/Bandwidth/python-bandwidth
开源协议：MIT License
下载


Bandwidth Python API

Deprecation Notice

This project is deprecated. Please go to https://github.com/Bandwidth/python-sdk

Build Status Can I Use Python 3?Documentation Status

Client library for the Bandwidth App Platform

Full Reference

dev.bandwidth.com/python-bandwidth

Requirements

Installation

  1. pip install bandwidth-sdk

Usage

Client Initialization

  1. import bandwidth
  2. voice_api = bandwidth.client('voice', 'u-user', 't-token', 's-secret')
  3. messaging_api = bandwidth.client('messaging', 'u-user', 't-token', 's-secret')
  4. account_api = bandwidth.client('account', 'u-user', 't-token', 's-secret')
  6. ## Or import each individually for better IDE integration::
  8. from bandwidth import messaging, voice, account
  9. messaging_api = messaging.Client('u-user', 't-token', 's-secret')
  10. voice_api = voice.Client('u-user', 't-token', 's-secret')
  11. account_api = account.Client('u-user', 't-token', 's-secret')

Each of these code sample assumes that you have already initialized a client

Search and order phone number

  1. numbers = account_api.search_available_local_numbers(area_code = '910', quantity = 3)
  2. print(numbers[0]['number'])
  3. ## +19104440230
  5. my_number = account_api.order_phone_number(numbers[0]['number'])
  7. print(my_number)
  8. #n-rnd5eag33safchqmrj3q

Send Text Message

  1. message_id = api.send_message(from_ = '+1234567980',
  2.                               to = '+1234567981',
  3.                               text = 'SMS message')
  4. print(message_id)
  5. # m-messageId

Send Picture Message

  1. message_id = api.send_message(from_ = '+1234567980',
  2.                               to = '+1234567981',
  3.                               text = 'MMS message',
  4.                               media=['http://cat.com/cat.png'])
  5. print(message_id)
  6. # m-messageId

Fetch information about single message

  1. my_message = api.get_message('m-messageId')
  2. print(my_message[state])
  3. ## received

Create an outbound call

  1. call_id = api.create_call(from_ = '+1234567890',
  2.                           to = '+1234567891',
  3.                           callback_url = "http://yoursite.com/calls")
  4. print(call_id)
  5. ## c-abc123

Get information on single call

  1. my_call = api.get_call('c-abc123')
  2. print(my_call)
  3. ## {   'callback_url'         : 'http://yoursite.com/calls',
  4. ##     'direction'           : 'out',
  5. ##     'events'              : 'https://api.catapult.inetwork.com/v1/users/u-abc/calls/c-abc123/events',
  6. ##     'from'                : '+1234567890',
  7. ##     'id'                  : 'c-abc123',
  8. ##     'recording_enabled'    : False,
  9. ##     'recording_file_format' : 'wav',
  10. ##     'recordings'          : 'https://api.catapult.inetwork.com/v1/users/u-abc/calls/c-abc123/recordings',
  11. ##     'startTime'           : '2017-01-26T16:10:11Z',
  12. ##     'state'               : 'started',
  13. ##     'to'                  : '+1234567891',
  14. ##     'transcription_enabled': False,
  15. ##     'transcriptions'      : 'https://api.catapult.inetwork.com/v1/users/u-abc/calls/c-abc123/transcriptions'}

Retrieving list of calls

  1. call_list = api.list_calls(to = '+19192223333', size = 2)
  2. print(list(call_list))