net3000.facebook 1.0.0

Net3000.Facebook

Overview

The Net3000.Facebook library provides comprehensive integration with the Facebook Graph API for Net3000 solutions. This library enables social media management, content posting, page administration, and Facebook data retrieval.

Features

• Content Management: Post content, images, and videos to Facebook pages
• Page Administration: Manage Facebook pages and retrieve page information
• Social Media Analytics: Access Facebook insights and post statistics
• Media Handling: Upload and manage images and videos
• Review Management: Retrieve and manage Facebook page reviews
• Event Management: Handle Facebook events and event data

Installation

dotnet add package net3000.facebook

Dependencies

• net3000.common (v9.0.11)
• net3000.common.models (v1.0.7)
• System.IdentityModel.Tokens.Jwt (v8.14.0)

Configuration

Add your Facebook API credentials to your configuration:

{
  "Facebook": {
    "Id": "your-facebook-app-id",
    "Secret": "your-facebook-app-secret",
    "Version": "v18.0"
  }
}

Usage

Basic Setup

using net3000.facebook;

// Initialize the service
var facebookService = new lib(configuration);
facebookService.accessToken = "your-page-access-token";
facebookService.currentPageId = "your-page-id";

Posting Content

// Post text content to Facebook
facebookService.message = "Hello from Net3000!";
facebookService.postToId = "your-page-id";
var result = facebookService.addPost();

// Post with images
facebookService.title = "Image Post";
facebookService.message = "Check out this image!";
var file = new postFile();
file.byteArray = imageBytes;
facebookService.files = new List<postFile> { file };
var result = facebookService.postToFeed("Image Post", "Check out this image!", imageList);

Retrieving Page Data

// Get page accounts
var accounts = facebookService.getAccounts();

// Get page albums
var albums = facebookService.getAlbums();

// Get page reviews
var reviews = facebookService.getReviews();

API Reference

lib (Main Service Class)

Main service class for Facebook Graph API integration.

Properties

• accessToken - Facebook page access token
• currentPageId - Current Facebook page ID
• currentPageName - Current Facebook page name
• postToId - Target page ID for posts
• message - Post message content
• title - Post title
• files - List of files to upload

Methods

• addPost() - Add a new post to Facebook feed
• addNote() - Add a note to Facebook
• getAccounts() - Get Facebook page accounts
• getAlbums() - Get page photo albums
• getImagesForAlbum() - Get images from a specific album
• getFeed() - Get page feed posts
• getPostDetails() - Get detailed post information
• postToFeed() - Post content with images to feed
• getReviews() - Get page reviews
• getEvents() - Get page events
• UploadImageToFacebookPage() - Upload images to Facebook

Models

• facebookPage - Facebook page information
• albums - Album data structure
• imagedata - Image data structure
• FacebookFeed - Feed data structure
• FacebookPost - Post data structure
• postResponse - Response from posting operations
• reviewItem - Review data structure
• events - Event data structure

Error Handling

The library provides comprehensive error handling with detailed error messages from the Facebook Graph API. All methods return apiResponse<T> objects with success/failure status and detailed error information.

Rate Limiting

The library respects Facebook Graph API rate limits and includes proper error handling for rate limit exceeded responses.

Authentication

• Requires Facebook App ID and Secret for API access
• Uses Page Access Tokens for page-specific operations
• Supports both short-lived and long-lived access tokens

Testing

Use Facebook's test environment for development:

• Create a Facebook App in Developer Mode
• Use test pages and test users
• Test API endpoints with limited data

License

This library is proprietary to Net3000. Usage is restricted to Net3000.ca solutions and authorized affiliates. Redistribution, sublicensing, or integration with third-party products outside the Net3000 ecosystem is prohibited without written consent from Net3000.

Support

For support and questions, contact the Net3000 development team or visit net3000.ca.

Changelog

v1.0.0

• Initial release with Facebook Graph API integration
• Content posting and page management capabilities
• Image and video upload functionality
• Review and analytics data retrieval