メニュー

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?

REST API: API キー

You access the Twilio API using API keys that represent the required credentials. These keys:

  • Authenticate to the REST API
  • Create and revoke Access Tokens

See this document for more information about your request to Twilio's REST API, or read our article on Access Tokens to learn more.

API Keys can be provisioned and revoked through the REST API or the Twilio Console. This provides a powerful and flexible primitive for managing access to the Twilio API.

For example, you might issue separate API Keys to different developers or to different subsystems within your application.

Since API Keys can be independently revoked, you have complete control of the lifecycle of your API credentials.

If your use case requires API Keys to access the /Accounts or /Keys endpoint, a Master Key needs to be used. This can be created in the Console.

Key properties

Names in PHP format
sid
sid<SK> Not PII

このAPIキーを識別する 34 文字の文字列です。APIをを認証する際、ベーシック認証としてuserを利用します。

friendlyName
文字列 PII MTL: 30 DAYS

このリソースを説明する文字列です。アプリケーションで選択されています。64 文字まで設定できます。

dateCreated
date_time<rfc2822> Not PII

このAPIキーの作成された日時で、RFC 2822タイムスタンプで表されます。

dateUpdated
date_time<rfc2822> Not PII

このAPIキーがもっとも最近更新された日時で、RFC 2822タイムスタンプで表されます。

Fetch a Key resource

GET
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Keys/{Sid}.json

Returns a representation of the API Key, including the properties below.

For security reasons the Secret field is ONLY returned when the API Key is first created – never when fetching the resource.

例 1
        
        
        
        
        Note that the API Key's Secret field is redacted in the output of this example. As noted above, Secret fields are only returned when the API Key is first created.

        Fetch an API Key

        Note that the API Key's Secret field is redacted in the output of this example. As noted above, Secret fields are only returned when the API Key is first created.
        例 2
              
              
              
              
              An example fetching of an API Key.

              Fetch an API Key

              An example fetching of an API Key.

              Read a Key resource

              GET
              https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Keys.json

              Returns a list of API Keys in this account, sorted by DateUpdated.

              The list includes all API Keys. It also includes paging information.

              例 1
                    
                    
                    
                    
                    Retrieve all the API Keys in an account

                    Read a Key resource

                    Retrieve all the API Keys in an account

                    Update a Key resource

                    post
                    https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Keys/{Sid}.json

                    Attempts to update the fields of an API Key instance.

                    If successful, it returns the updated resource representation. The response will be identical to that of the HTTP GET (fetch).

                    パラメーター
                    Names in PHP format
                    friendlyName
                    オプション
                    post 文字列 PII MTL: 30 DAYS

                    このリソースを説明する文字列です。アプリケーションで選択されています。64 文字まで設定できます。

                    例 1
                          
                          
                          
                          

                          Delete a Key Resource

                          削除する
                          https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Keys/{Sid}.json

                          Deletes an API Key. This revokes its authorization to authenticate to the REST API and invalidates all Access Tokens generated using its secret.

                          削除に成功すると、本文(Body)のない HTTP 204 レスポンスを返します。

                          You may only delete Keys by authenticating with the account's AccountSid and AuthToken or API Keys that have the master key flag set in the console.

                          例 1
                                
                                
                                
                                

                                ヘルプが必要ですか?

                                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.