Updated on 2025-11-13 GMT+08:00

Performing Instagram Handshake Authentication

Scenario

This interface is invoked to perform social media handshake authentication.

Method

GET

URI

https://Domain name/apiaccess/api/instagram/message/{chanId}?hub.mode=subscribe& hub.verify_token=****& hub.challenge=****** (For example, the domain name is service.besclouds.com.)

In the URI, {chanId} indicates the channel ID, which is optional.

Table 1 URI parameters

No.

Parameter

Type

Mandatory or Not

Description

1

hub.mode

String

Yes

The value is automatically generated by Instagram. For the subscription type, the value must be subscribe.

2

hub.verify_token

String

Yes

Handshake authentication token, which is obtained from the API Fabric

3

hub.challenge

Integer

Yes

Authentication ID generated by Instagram. The value is automatically generated by Instagram.

Request Description

Request body parameters: none

Response Description

  • Status code: 200
Table 2 Response body parameter

No.

Parameter

Type

Mandatory or Not

Description

1

challenge

String

Yes

Authentication ID of Instagram

  • Status code: 400

    Incorrect request. Check the request path and parameters.

  • Status code: 401

    Unauthorized operation. 1. Check whether you have purchased related services. 2. Contact customer service to check the status of your account.

  • Status code: 404

    The requested content is not found. Check the request path.

  • Status code: 500

    Business failure. Check the values of parameters in the request.

Error Codes

None

Example

Request parameters:

None

Response parameters:

"1158201444"