github.com/EthiliSundaravel/w6_go_twitter_api

Twitter API Go Application

A simple Twitter API application built in Go, allowing users to post and delete tweets through HTTP endpoints.

Table of Contents

• Introduction
• Setup Instructions
  • Create a Twitter Developer Account
  • Generate API Keys
  • Run the Program
• Program Details
  • Posting a Tweet
  • Deleting a Tweet
• Error Handling
• Conclusion

Introduction

This application demonstrates how to interact with the Twitter API using Go. It allows users to post and delete tweets via HTTP endpoints. The assignment teaches authentication with the Twitter API, handling errors gracefully, and creating a simple web server in Go.

Setup Instructions

1. Create a Twitter Developer Account

• Go to the Twitter Developer Platform.
• Sign in with your Twitter account and follow the prompts to create a developer account.

2. Generate API Keys

• Once your account is set up, go to the Twitter Developer Portal.
• Create a new project and an app within that project.
• Under the "Keys and tokens" tab, you will find your API Key, API Key Secret, Access Token, and Access Token Secret.

3. Run the Program

1. Install Go from the official site.
2. Clone this repository or download the source code.
3. Replace the placeholders for Twitter API credentials in the code with your actual credentials.
4. Run the application using:

   go run main.go
   

Program Details

Posting a Tweet

• The /tweet endpoint accepts a POST request with a JSON body containing a message field. Example request:

  curl -X POST http://localhost:8080/tweet -H "Content-Type: application/json" -d '{"message": "Hello from Twitter API via localhost!"}'
  

• Successful response:

  {
      "id": 1234567890,
      "text": "Hello from Twitter API via localhost!"
  }
  

Deleting a Tweet

• The /delete endpoint deletes the most recent tweet from the user's timeline. Example request:

  curl -X POST http://localhost:8080/delete
  

• Successful response:

  {
      "id": 1234567890,
      "text": "Hello from Twitter API via localhost!"
  }
  

Error Handling

• The application handles various Twitter API errors and sends JSON responses with meaningful error messages.
• Errors include invalid credentials, rate limits, and invalid tweet IDs. Each error is returned with a specific status code and message.

Conclusion

This application serves as a basic introduction to working with the Twitter API using Go, demonstrating how to post and delete tweets while handling errors effectively.