gogram

package module
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 7, 2022 License: MIT Imports: 10 Imported by: 0

README

Go Instagram Basic Display API

Docs: Instagram Basic Display API

Installation
go get -u github.com/rostyslavio/go-instagram-basic-display-api

Get Access Tokens and Permissions

Step 1: Get Authorization
package main

import (
	gogram "github.com/rostyslavio/go-instagram-basic-display-api"
	"log"
)

func main() {
	config := gogram.Config{
		ClientId: "INSTAGRAM_BASIC_DISPLAY_APP_ID",
		ClientSecret: "INSTAGRAM_BASIC_DISPLAY_APP_SECRET",
		RedirectUri: "INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI",
	}
	redirect, _ := gogram.NewGogram().Config(config).GetAuthorizeRedirect()

	//log.Printf(redirect)
}
Step 2: Exchange the Code For a Token
package main

import (
	"encoding/json"
	gogram "github.com/rostyslavio/go-instagram-basic-display-api"
	"log"
)

type AccessToken struct {
	AccessToken string `json:"access_token"`
	UserId int `json:"user_id"`
}

func main() {
	config := gogram.Config{
		ClientId: "INSTAGRAM_BASIC_DISPLAY_APP_ID",
		ClientSecret: "INSTAGRAM_BASIC_DISPLAY_APP_SECRET",
		RedirectUri: "INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI",
	}
	response, err := gogram.NewGogram().Config(config).GetAccessToken("Query('code')")
	if err != nil {
		log.Fatal(err)
	}
	
	var accessToken AccessToken
	json.Unmarshal([]byte(response), &accessToken)
	
	//log.Printf(response)
}

Get User Profiles and User Media

Get a User’s Profile
package main

import (
	"encoding/json"
	gogram "github.com/rostyslavio/go-instagram-basic-display-api"
	"log"
)

type User struct {
	Id string `json:"id"`
	Username int `json:"username"`
}

func main() {
	config := gogram.Config{
		ClientId: "INSTAGRAM_BASIC_DISPLAY_APP_ID",
		ClientSecret: "INSTAGRAM_BASIC_DISPLAY_APP_SECRET",
		RedirectUri: "INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI",
	}
	response, err := gogram.NewGogram().Config(config).GetUserProfile("ACCESS_TOKEN", []string{"id", "username"})
	if err != nil {
		log.Fatal(err)
	}
	
	var user User
	json.Unmarshal([]byte(response), &user)
	
	// log.Printf(response)
}
Get a User’s Media
package main

import (
	"encoding/json"
	gogram "github.com/rostyslavio/go-instagram-basic-display-api"
	"log"
)

type MediaData struct {
	Id string `json:"id"`
	MediaType string `json:"media_type"`
	MediaUrl string `json:"media_url"`
	ThumbnailUrl *string `json:"thumbnail_url"`
}

type Medias struct {
	Data []MediaData `json:"data"`
}

func main() {
	config := gogram.Config{
		ClientId: "INSTAGRAM_BASIC_DISPLAY_APP_ID",
		ClientSecret: "INSTAGRAM_BASIC_DISPLAY_APP_SECRET",
		RedirectUri: "INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI",
	}
	accessToken := "ACCESS_TOKEN"
	response, err := gogram.NewGogram().Config(config).GetUsersMedia(accessToken, []string{"id", "media_type", "media_url", "thumbnail_url"})
	if err != nil {
		log.Fatal(err)
	}
	
	var medias Medias
	json.Unmarshal([]byte(response), &medias)
	
	//s, _ := json.MarshalIndent(medias, "", "  ")
	//log.Printf(string(s))
}
Get a User’s Media (Paging)
package main

import (
	"encoding/json"
	gogram "github.com/rostyslavio/go-instagram-basic-display-api"
	"log"
)

type MediaData struct {
	Id           string  `json:"id"`
	MediaType    string  `json:"media_type"`
	MediaUrl     string  `json:"media_url"`
	ThumbnailUrl string `json:"thumbnail_url"`
}

type Medias struct {
	Data   []MediaData `json:"data"`
	Paging Paging      `json:"paging"`
}

type Paging struct {
	gogram.Next `json:"next"`
}

func main() {
	config := gogram.Config{
		ClientId: "INSTAGRAM_BASIC_DISPLAY_APP_ID",
		ClientSecret: "INSTAGRAM_BASIC_DISPLAY_APP_SECRET",
		RedirectUri: "INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI",
	}
	accessToken := "ACCESS_TOKEN"
	response, err := gogram.NewGogram().Config(config).GetUsersMedia(accessToken, []string{"id", "media_type", "media_url", "thumbnail_url"})
	if err != nil {
		log.Fatal(err)
	}

	var medias Medias
	json.Unmarshal([]byte(response), &medias)

	// Get next page
	response, err = medias.Paging.Next.GetUsersMedia()
	if err != nil {
		log.Fatal(err)
	}
	
	json.Unmarshal([]byte(response), &medias)

	// s, _ := json.MarshalIndent(medias, "", "  ")
	// log.Print(string(s))
}
Get Album Contents
package main

import (
	"encoding/json"
	gogram "github.com/rostyslavio/go-instagram-basic-display-api"
	"log"
)

type MediaData struct {
	Id string `json:"id"`
	MediaType string `json:"media_type"`
	MediaUrl string `json:"media_url"`
	ThumbnailUrl *string `json:"thumbnail_url"`
}

type Album struct {
	Data []MediaData `json:"data"`
}

func main() {
	config := gogram.Config{
		ClientId: "INSTAGRAM_BASIC_DISPLAY_APP_ID",
		ClientSecret: "INSTAGRAM_BASIC_DISPLAY_APP_SECRET",
		RedirectUri: "INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI",
	}
	accessToken := "ACCESS_TOKEN"
	response, err := gogram.NewGogram().Config(config).GetAlbumContents(
		17909521286425942,
		accessToken,
		[]string{"id", "media_type", "media_url", "thumbnail_url"},
	)
	if err != nil {
		log.Fatal(err)
	}

	var album Album
	json.Unmarshal([]byte(response), &album)
	
	//s, _ := json.MarshalIndent(album, "", "  ")
	//log.Printf(string(s))
}

Long-Lived Access Tokens

Get a Long-Lived Token
package main

import (
	"encoding/json"
	gogram "github.com/rostyslavio/go-instagram-basic-display-api"
	"log"
)

type LongLivedToken struct {
	AccessToken string `json:"access_token"`
	TokenType string `json:"token_type"`
	ExpiresIn int `json:"expires_in"`
}

func main() {
	config := gogram.Config{
		ClientId: "INSTAGRAM_BASIC_DISPLAY_APP_ID",
		ClientSecret: "INSTAGRAM_BASIC_DISPLAY_APP_SECRET",
		RedirectUri: "INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI",
	}
	shortLivedAccessToken := "ACCESS_TOKEN"
	response, err := gogram.NewGogram().Config(config).GetLongLivedToken(shortLivedAccessToken)
	if err != nil {
		log.Fatal(err)
	}

	var longLivedToken LongLivedToken
	json.Unmarshal([]byte(response), &longLivedToken)
	
	//s, _ := json.MarshalIndent(longLivedToken, "", "  ")
	//log.Printf(string(s))
}
Refresh a Long-Lived Token
package main

import (
	"encoding/json"
	gogram "github.com/rostyslavio/go-instagram-basic-display-api"
	"log"
)

type LongLivedToken struct {
	AccessToken string `json:"access_token"`
	TokenType string `json:"token_type"`
	ExpiresIn int `json:"expires_in"`
}

func main() {
	config := gogram.Config{
		ClientId: "INSTAGRAM_BASIC_DISPLAY_APP_ID",
		ClientSecret: "INSTAGRAM_BASIC_DISPLAY_APP_SECRET",
		RedirectUri: "INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI",
	}
	longLivedAccessToken := "ACCESS_TOKEN"
	response, err := gogram.NewGogram().Config(config).RefreshLongLivedToken(longLivedAccessToken)
	if err != nil {
		log.Fatal(err)
	}

	var longLivedToken LongLivedToken
	json.Unmarshal([]byte(response), &longLivedToken)
	
	//s, _ := json.MarshalIndent(longLivedToken, "", "  ")
	//log.Printf(string(s))
}

Deauthorize & Data Deletion Requests

Using a Signed Request
app.Post("/instagram/deauthorize", instagram.Logout())
app.Post("/instagram/deletion", instagram.Logout())
...

type SignedRequest struct {
    SignedRequest string `json:"signed_request" xml:"signed_request" form:"signed_request"`
}

func Logout() fiber.Handler {
	return func(c *fiber.Ctx) error {
		// parse body
		sr := new(SignedRequest)

		if err := c.BodyParser(sr); err != nil {
			return err
		}

		// parse signed request
		config := gogram.Config{
			ClientId: src.Getenv("INSTAGRAM_BASIC_DISPLAY_APP_ID"),
			ClientSecret: src.Getenv("INSTAGRAM_BASIC_DISPLAY_APP_SECRET"),
			RedirectUri: src.Getenv("INSTAGRAM_BASIC_DISPLAY_REDIRECT_URI"),
		}
		data, _ := gogram.NewGogram().Config(config).ParseSignedRequest(sr.SignedRequest)

		// fmt.Println(data)

		return c.SendString("ok")
	}
}

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ValidMAC 

func ValidMAC(message, messageMAC, key []byte) bool

Types

type Config 

type Config struct {
	ClientId     string
	ClientSecret string
	RedirectUri  string
}

type GogramClient 

type GogramClient struct {
	// contains filtered or unexported fields
}

GogramClient is the main struct of the package

func NewGogram 

func NewGogram() *GogramClient

func (*GogramClient) Config 

func (client *GogramClient) Config(config Config) *GogramClient

Config is needed to success api work

func (*GogramClient) GetAccessToken 

func (client *GogramClient) GetAccessToken(code string) (response string, err error)

GetAccessToken https://developers.facebook.com/docs/instagram-basic-display-api/guides/getting-access-tokens-and-permissions#step-2--exchange-the-code-for-a-token

func (*GogramClient) GetAlbumContents 

func (client *GogramClient) GetAlbumContents(mediaId int, accessToken string, fields []string) (response string, err error)

GetAlbumContents https://developers.facebook.com/docs/instagram-basic-display-api/guides/getting-profiles-and-media#get-album-contents https://developers.facebook.com/docs/instagram-basic-display-api/reference/media#fields

func (*GogramClient) GetAuthorizeRedirect 

func (client *GogramClient) GetAuthorizeRedirect() (uri string, err error)

GetAuthorizeRedirect https://developers.facebook.com/docs/instagram-basic-display-api/guides/getting-access-tokens-and-permissions#step-1--get-authorization

func (*GogramClient) GetLongLivedToken 

func (client *GogramClient) GetLongLivedToken(shortLivedAccessToken string) (response string, err error)

GetLongLivedToken https://developers.facebook.com/docs/instagram-basic-display-api/guides/long-lived-access-tokens#get-a-long-lived-token

func (*GogramClient) GetMediaData 

func (client *GogramClient) GetMediaData(mediaId int, accessToken string, fields []string) (response string, err error)

GetMediaData https://developers.facebook.com/docs/instagram-basic-display-api/guides/getting-profiles-and-media#get-media-data https://developers.facebook.com/docs/instagram-basic-display-api/reference/media#fields

func (*GogramClient) GetUserProfile 

func (client *GogramClient) GetUserProfile(accessToken string, fields []string) (response string, err error)

GetUserProfile https://developers.facebook.com/docs/instagram-basic-display-api/guides/getting-profiles-and-media#get-a-user-s-profile https://developers.facebook.com/docs/instagram-basic-display-api/reference/user#fields

func (*GogramClient) GetUsersMedia 

func (client *GogramClient) GetUsersMedia(accessToken string, fields []string) (response string, err error)

GetUsersMedia https://developers.facebook.com/docs/instagram-basic-display-api/guides/getting-profiles-and-media#get-a-user-s-media https://developers.facebook.com/docs/instagram-basic-display-api/reference/media#fields

func (*GogramClient) ParseSignedRequest 

func (client *GogramClient) ParseSignedRequest(sr string) (response string, err error)

ParseSignedRequest https://developers.facebook.com/docs/games/gamesonfacebook/login#parsingsr https://developers.facebook.com/docs/instagram-basic-display-api/getting-started#deauthorize-callback-url https://developers.facebook.com/docs/instagram-basic-display-api/getting-started#data-deletion-request-callback-url

func (*GogramClient) RefreshLongLivedToken 

func (client *GogramClient) RefreshLongLivedToken(longLivedAccessToken string) (response string, err error)

RefreshLongLivedToken https://developers.facebook.com/docs/instagram-basic-display-api/guides/long-lived-access-tokens#refresh-a-long-lived-token

type Next 

type Next string

Next type for paging

func (Next) GetUsersMedia 

func (endpoint Next) GetUsersMedia() (response string, err error)

GetUsersMedia (Paging)

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.