Apply for a developer account

Apply for Enterprise acce

3. Develop webhook consumer app

Once you have received Account Activity API access, you need to develop, deploy and host a web app that will receive Twitter webhook events.

• Create a web app with a URL to use as your webhook to receive events. This is the endpoint deployed on your server to listen for incoming Twitter webhook events.
  • The URI path is completely up to you. This example would be valid: https://mydomain.com/service/listen
  • If you are listening for webhooks from a variety of sources, a common pattern is: https://mydomain.com/webhook/twitter
  • Note that the specified URL can not include a port specification (https://mydomain.com:5000/NoWorkie).
• As described in our Securing Webhooks guide,
  a first step is writing code that receives a Twitter Challenge Response
  Check (CRC) GET request and responds with a properly formatted JSON
  response.
• Register your webhook URL. You will make a POST request to a /webhooks.json?url= endpoint.
  When you make this request Twitter will issue a CRC request to your web
  app. When a webhook is successfully registered, the response will
  include a webhook id. This webhook id is needed later when making some requests to the Account Activity API.
• Twitter will send account webhook events to the URL you registered.
  Make sure your web app supports POST requests for incoming events. These
  events will be encoded in JSON. See HERE for example webhook JSON payloads.
• Once your web app is ready, the next step is adding accounts to
  receive activities for. When adding (or deleting) accounts you will make
  POST requests referencing the account id. See our guide on adding subscriptions for more information.

4. Validate setup

• To validate your app and webhook are configured correctly, favorite a
  Tweet posted by one of the Twitter accounts your app is subscribed to.
  You should receive a favorite_events via a POST request to your webhook URL for each Favorite your subscribers receive.

中文资料：

　　如何在Twitter开发者平台上注册自己的应用

　　瞎折腾之Webhooks

　　twitter APi的使用与twitter数据的应用

　　Twitter API中文文档

英文资料

　　Twitter Apps

　　ads api application

　　twitter engineering

　　twitter marketing

　　Stay up-to-date with Twitter developer platform news

　　understanding-discourse-trust-levels

　　Programmatically create and manage Twitter Ads campaigns.

广告相关

　　Campaign Management

　　Ads API Hierarchy and Terminology

　　Error Codes and Responses

　　Advertising API License Agreement

　　Pagination

　　Sorting

　　API reference index

　　products-overview

　　Twitter Ads API

　　advertiser api forums：https://twittercommunity.com/c/advertiser-api

　　Tutorials：Instructions and examples to help you get started

　　Twitter Dev in github

　　　　https://github.com/twitterdev

　　data-ads-sample

　　twitter-python-ads-sdk

　　twitter-ruby-ads-sdk

　　TwitterKitSample

　　analytics-tag-check

　　Twitter libraries

　　　　LinqToTwitter

　　　　　　LinqToTwitter

　　　　Spring.NET Social extension for Twitter

　　　　tweetinvi

　　　　　　We are in the process of verifying the compatibility of the library with the Twitter Ads API.

　　　　Crafted.Twitter

　　Libraries built for HTTP with OAuth that should also work with Twitter

　　　　.NET

• • DotNetOpenAuthby Andrew Arnott — an OpenID, OAuth and InfoCard library
  • hammock2 by @danielcrenna — an HTTP API client supporting OAuth authentication.
  • Spring.NET Socialby @SpringForNet — Spring.NET REST Client extension supporting OAuth authentication (docs) (examples)

　　Libraries built for the Twitter Platform

.NET

• LINQ2Twitter by @joemayo (examples)
• Spring.NET Social extension for Twitter by SpringSource — A Spring.NET Social extension with connection support and an API binding for Twitter.
• TweetSharp by @danielcrenna — A .net library for Twitter API access
• Tweetinvi maintained by Linvi — a Twitter .Net C# API which has for mission to simplify the development of application for Twitter in C#. The streaming API has been used on research projects and collected around 3.2 million Tweets a day. The Twitter API has been created to be easy to implement new functionality and currently provide access to most of the functionalities. (documentation)
• Crafted.Twitter by @martbrow — A caching compatible solution - with implementations for both ASP.Net Web Forms and MVC. Making it easy to include Tweets in your website.

　　Advertise on the Twitter network

Twitter’s Ads API endpoints provide developers a programmatic way to create and manage Twitter Ads campaigns. In addition, these endpoints provide a means to access features like Audiences, Creatives, Targeting, etc. Our tutorials page contains all the necessary information around the Ads entity hierarchy as well as a basic getting started guide.

Apply for Ads API access

In order to be able to use any of the Ads API endpoints, first create a Twitter app and apply for access here. Feel free to play around in our sandbox environment as well.

Check out our SDKs

The Python and Ruby SDKs provide a frictionless means to integrate with the Ads API directly in your application.

If you’re an expert on the Ads API feel free to help out others as well! Questions? See our developer forums.

　　Tweet objects

　　Introduction to Tweet JSON

工具：

　　Using Twurl

Tweets

　　Post, retrieve and engage with Tweets

　　timezones

　　Rate Limiting

　　Tweet objects

获取TwitterAPI keys
• 注册一个Twitter账号
• 到https://apps.twitter.com/登入twitter账号
• 点击“Create New App”，新建你自己的应用
• 填写应用信息表单, 然后点击“Create your Twitter application”生成你的twitter应用
• 在“keys and Access Tokens”界面, 点击“API keys”, 然后记录你的“API key” 和"API secret".
• 在“keys and Access Tokens”界面点击“Create my access token”, 记录你的"Access token" and "Access token secret".
这里我就不啰嗦一步一步截图了，按照上面一步一步做就行。但是只里面有一个坑，需要注意的：twitter在创建应用时，你的twitter账号一定要绑定你的手机，但是国内的手机运营商收不到验证码。这里好像可以用手机版twitter去绑定手机号（实测联通可以收到验证码，电信好像不可以，移动没试过）

使用TwitterAPI
这里我使用的twitter4J来调用twitter接口。
Twitter4j：http://twitter4j.org/en/index.html
在这里你下载twitter4j的zip包然后解压，将lib下面的这些jar包导入你的项目中。

twitter4j-core-source.jar包是自己打包的源码包，用来查看函数源码。
注：twitter4j的文档写的很不全，参考意义不是很大，你可以结合下载zip包中的examples文件夹中的例子还可以看twitter官网的Twitter REST APIs：https://dev.twitter.com/rest/public
twitter4j是的使用需要FQ代理，还有当你设置好以后，有可能会碰到链接拒绝（看你用的什么代理），因为eclipse默认走的是ipv6协议，具体解决方法可以参考我这篇文章：
http://blog.csdn.net/u013817676/article/details/51906754

Application not approved

Initial Setup

As a developer, there are several steps that you will need to take in order to begin using the Direct Messages services.

Step 1 - Create a Twitter app.

• Create an app on the "Apps" page of your approved developer account. If you are creating the app on behalf of your company, it is recommended you create the app with a corporate Twitter account.
• Enable “Read, Write and Access direct messages” on the permissions tab of your app page.
• On the "Keys and Tokens" tab, take note of your app's Consumer Key (API Key) and Consumer Token (API Secret).
• On the same tab, generate your app's Access Token and Access Token Secret. You will need these Access Tokens to register your webhook URL, which is where Twitter will send account events.
• If you are unfamiliar with Twitter Sign-in and how user contexts work with the Twitter API review Obtaining Access Tokens. As you add accounts for which to receive events, you will subscribe them using that account's access tokens.
• Take note of your app's numeric ID, as seen in the "Apps" page of the developer portal. When you apply for Account Activity API access, you'll need this app ID.

Step 2 - Get access to Account Activity API

After creating a Twitter app, the next step is applying for Account Activity API access.

Premium

To access the Sandbox or Paid Premium Account Activity API tiers, you need to set up a developer account. If you have not applied for a developer account yet, please do so at the following link:

Apply for developer account

Once you have a developer account, then you are ready to set up
your access to the Premium Account Activity API. You will need a Twitter
app to attach to your Account Activity API dev environment.

1. Login and navigate to the Dev Environments page.
2. Click 'Set up dev environment,' name your environment, and specify a Twitter app ID for the environment. The environment name you chose will replace the :env_name
   token in our example premium endpoint URLs. For example, if you use the
   'prod' environment name, your URL pattern would be 
   https://api.twitter.com/1.1/account_activity/all/prod/webhooks.

Step 3 - Develop webhook consumer app

If you would like to use a script with a visual dashboard to get set
up with your account activities, you should check out the Twitter
Dev-supported Account Activity Dashboard.

• Once you have received Account Activity API access, you need to
  develop, deploy and host a web app that will receive Twitter webhook
  events.
• Create a web app with a URL to use as your webhook to receive
  events. This is the endpoint deployed on your server to listen for
  incoming Twitter webhook events.
  • The URI path is completely up to you. This example would be valid: https://mydomain.com/service/listen
  • If you are listening for webhooks from a variety of sources, a common pattern is: https://mydomain.com/webhook/twitter
  • Note that the specified URL can not include a port specification (https://mydomain.com:5000/NoWorkie).
• As described in our Securing Webhooks guide,
  a first step is writing code that receives a Twitter Challenge Response
  Check (CRC) GET request and responds with a properly formatted JSON
  response.
• Register your webhook URL. You will make a POST request to
  a /webhooks.json?url= endpoint. When you make this request Twitter will
  issue a CRC request to your web app. When a webhook is successfully
  registered, the response will include a webhook id. This webhook id is
  needed later when making some requests to the Account Activity API.
• Twitter will send account webhook events to the URL you registered.
  Make sure your web app supports POST requests for incoming events. These
  events will be encoded in JSON. See HERE for example webhook JSON payloads.
• Once your web app is ready, the next step is adding accounts to
  receive activities for. When adding (or deleting) accounts you will make
  POST requests referencing the account id. See our guide on adding subscriptions for more information.
• To validate your app and webhook are configured correctly, favorite a
  Tweet posted by one of the Twitter accounts your app is subscribed to.
  You should receive a Favorite event via a POST request to your webhook
  URL for each Favorite your subscribers receive.

Step 4 - Obtain User Permission

In order to perform write actions (create Tweets or messages) on
behalf of another account or to read private information from that
account, you will need to obtain access tokens. Access tokens provide
the user context when using the Twitter API.

Basic Definitions

• User - A Twitter @user. All write actions on the Twitter API require
  the context of a user. Chatbots exist on Twitter accounts and are not
  their own entity. The account the chatbot exists on is a user. Customers
  interacting with the chatbot are also users. All messages sent on
  Twitter are between two user entities.
• App - A Twitter app is created in your approved developer account. An app is always owned by a single user. The app provides the base context for using the Twitter API.

How are tokens generated? Two scenarios:

1. User owns the app / Single User - If the user is the owner of the
   app, they can generate access tokens on the “Keys and Tokens” tab in an
   app's "Details" section within the from the "Apps" page in the developer portal. Click the “Create” button on the bottom of the page.
2. User does not own the app / Multiple Users - If your app is going to
   consume Account Activity events on behalf of multiple users, each user
   must authenticate with your app to grant permission. To achieve this you
   must have a web app that implements Twitter Sign-in.

At this point in the process, you should have all of the necessary information to set up an application in the developer portal,
perform the initial Challenge Response Check to secure your endpoint,
and obtain access tokens in order to publish content on both your own
application and on behalf of others who have given explicit permission.
Now let's take a look at the different endpoints we will be using in our
app.

Step 5 - Understanding how the endpoints fit together

To make experiences conversational we provide Direct Message data in
real time via webhooks which includes metadata about the features in
that experience. Additionally, we have REST endpoints to create
messages, get welcome messages and custom profile data, and manage these
features. Understanding the basic flow below will help you set up your
own app based on the sampleapp you cloned in step 3.

Direct Messages

• Data about Direct Messages (sent and received) is provided to
  developers in real-time via their Account Activity API webhook setup
  • Register a webhook URL for the APP:
    • API call to POST account_activity/all/:env_name/webhooks
    • Developers can only register 1 URL per environment
  • Developer will ask the user to authorize the app via Twitter Sign-in to generate valid access tokens.
  • Add a new subscription (enable the app to receive Direct Messages on behalf of the user via the registered webhook)
    • API call to POST account_activity/all/:env_name/subscriptions
    • User needs to have a valid access token with the app (step 4)
  • Validate your webhooks URL using the PUT account_activity/all/:env_name/webhooks endpoint
  • Retrieve your webhook configuration using the GET account_activity/all/:env_name/webhooks endpoint
• Get all Direct Messages sent and received in the last 30 days using the GET direct_messages/events/list endpoint
• Get a single Direct Message based on the ID using the GET direct_messages/events/show endpoint, there’s no time restriction on this endpoint
• Send a message using POST direct_messages/events/new (message_create)
  • This endpoint is referenced in the send-direct-message script here

Welcome Messages

• Create a new welcome message using POST direct_messages/welcome_messages/new
  • This endpoint is referenced in the create-welcome-message script here
• Create a new rule for welcome messages using POST direct_messages/welcome_messages/rules/new
  • This endpoint is referenced in this script here

Subscription Endpoints

• Delete a subscriptions using DELETE account_activity/webhooks/:webhook_id/subscriptions
  • This endpoint is referenced in this script
• Get your current webhook configuration using GET account_activity/webhooks
  • This endpoint is referenced in this script

Debugging Tools

Below is a list of debugging tools you may find useful when building your application:

• Postman - Build mock requests
• Ngrok - Test the code on your local machine
• Runscope - Enables a developer to see how the flow of the API works