メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Programmable Wireless: REST API

Twilio's Programmable Wireless REST API enables you to manage the connectivity of real-world wireless devices using a Twilio SIM.

Using this REST API, you can exchange simple machine-to-machine messages with SMS-capable devices, obtain Data Session information for a SIM, manage Rate Plan instances, manage Sim instances, and obtain SIM Usage Records.

ベースURL

リファレンスドキュメントの URL はすべて、次のベース URL を使用しています。

https://wireless.twilio.com/v1

The Twilio Wireless REST API is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported. All responses are provided in JSON format.

You don't need to use the `.json` file extension in API request URIs.

Wireless API Authentication

HTTP requests to the REST API are protected with HTTP Basic authentication. To learn more about how Twilio handles authentication, see our security documentation. You use your Twilio account SID as the username and your auth token as the password for HTTP Basic authentication.

curl -G https://wireless.twilio.com/v1/Sims \
-u '{Account Sid}:{Auth Token}'

You can find your Account Sid and Auth Token in the Console.

To learn more about authentication and interaction with the Twilio REST API, see our documentation for requests to the API and Twilio's response.

Twilio server-side SDKs (Helper Libraries)

You can learn how to use the Twilio server-side SDKs (Helper Libraries) with Programmable Wireless in a variety of popular server-side programming languages on the SDKs section of the Twilio Docs.

非同期のリソース

Certain operations in the Wireless REST API – such as changing the status of a SIM – can take considerable time to complete (anywhere from a few seconds to a minute or more). These operations will return an intermediate synchronous HTTP response - 202 Accepted- while the action completes in the background.

同期的に処理されるリクエストでは、リクエストの完了時に通知を行うための、Twilioに対するコールバックURLを指定できます。 コールバックはお好みに応じて、HTTP POSTまたはGETで開発者のサーバーに送信されます。 コールバックリクエストに付随して送信されるパラメーター、またはクエリー文字列パラメーターを通じて、非同期の結果が知らされます。 コールバックリクエストの形式は、各関連REST APIリソースでドキュメント化されています。

If your initial request completes synchronously, a 200 OK, 201 Created, or 204 No Content response will be returned and you should not expect an asynchronous callback, even if a callback URL was specified.

An event will be posted to your account's Debugger in the Console with error details if Twilio does not receive a success response from your callback URL.

リソース

The following lists the resources exposed by the Wireless REST API.

リソース 概要
コマンド コマンドはマシーンからマシーンへのSMSメッセージを表します。
SIM Data Sessions The SIM Data Sessions list resource returns Data Session information for a SIM over no more than a 30 day period, presented as an aggregated list.
料金プラン 料金プランは、これに関連づけられた任意の数のSIMに適用される機能と制限を表します。
SIM Simインスタンスは、無線ネットワークに接続する機能を持った物理的なSIM(Subscriber Indentity Module=購読者識別モジュール)を表します。
使用記録 SIMのUsage Recordsリストリソースを使用すると、クエリーフィルターを指定することで複数の尺度からSIMの使用状況をクエリーできます。
Rate this page:

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.