Welcome to the Resont developer

These documentoin have been collected for your ease of use of the features and facilities of resont, as well as to develop and complete your products using the platforms created by resont.

If you have any questions, contact the technical team of Resont in the support tickets section so that the technical colleagues will answer your questions as soon as possible.

Start

Please keep these things in mind before starting work:

• Resont webservice is written in REST.
• To receive the Token, refer to the token authentication section.
• If you need OAuth2, be sure to fill out the form on This page so that we can contact you and make the necessary arrangements.
• If you have any questions, contact the technical team of Resont in the support tickets section so that the technical colleagues will answer your questions as soon as possible.

All Navinhub Webservices require an authentication section. Please complete the authentication process before use.

API Detail

When using Resont API, you must specify the desired version in the request link. The version with suffix v and its number is sent in the link. For example, if you intend to use version 1, the value v1 is sent in the request link.

The api link based on authentication methods is as follows

• token if using a token, the request link is https://api.resont.com/token/v{version}.
  Currently, the latest version is v1 and its link is https://api.resont.com/token/v1
• OAuth If using OAuth, the request link is https://api.resont.com/v{version}
  Currently, the latest version is v1 and its link is https://api.resont.com/v1

Field expansion

You can use the Field expansion feature for convenience and merging multiple requests.

The value of this file must be sent with the name with in the request. You can enter several fields in the request. These values must be separated from each other with Comma(,)

You can also use this value nested, in which case it should be sent in parent(child,...) format.

For example, in the Comment section, you can use the fields mentioned on the page. In this example, the sample value of with is like with=account,socialUser,accountPost.

In the example above, you can also send the meta value, which is a Field expansion in the Account section, like with=account(meta),socialUser,accountPost.

File upload

Uploading to Webservices that require file uploading should be sent as multipart/form-data.

Pagination

If there is a large number of outputs in a Webservice, the output is sent as pagination.

This output is in the form of a Paginate object, which contains 2 data fields containing requested and paging information with the following specifications.

• total: total number of items
• page: current page number
• totalPage: total page number
• next: next page address
• prev: previous page address

You can send your desired page number in the desired request with page input. Or calculate the link of next and previous pages with the help of prev and next fields.

Cursor pagination

If there is a large number of outputs in a Webservice, the output is sent as pagination with reference.

The main difference of this pagination is the absence of page numbers. In this pagination, depending on the type of Webservice in the request, it is determined whether the data should be sent before or after.

This output is in the form of a CursorPagination object that contains 2 data fields containing requested information and paging with the following specifications.

• total: total number of items
• after: next page address
• before: last page address

You can send your desired page number in the desired request with after or before entry.

Or calculate the link of the next and previous pages with the help of the after and before fields.

Be careful, in the requests that include before, the data may be more than the allowed number. The data is sent from the beginning and the rest of the data is received with the help of the after field. In this case, both after and before fields are sent.

Errors

Resont Webservice is sen`t in the form of an array with error index in various error requests, whose format is ErrorResponse.

Also, in case of an error, the value of http status is sent in the form of the following table.

Authentication

Authentication in Resont is in two forms: token and OAuth2.

In token mode, you can get your token simply by visiting the user panel.

In OAuth2 mode, it is necessary to send a request and receive it after the necessary coordination.

To receive OAuth2, please complete this form.

Token

If you need authentication through a token, you must send the token value in the form of a query string with the name token in the requests.

If you have a personal application or website and you intend to use Resont services for yourself to receive tokens, please click here.

The request link with the help of token is https://api.resont.com/token/v1/account. For example, to receive accounts, the requested link is as follows:

https://api.resont.com/token/v1/account?token={token}

OAuth

The authentication process is based on oAuth2, you need client_id and client_secret to use Resont service.

The following definitions can help you better understand the concepts.

• User: A person who has an account on the Novin Hub site.
• Service: a website or application that intends to use Novin Hub's api.
• Client id: It is the ID of the user's service, which is created when the service is created in the Resont.
• Client secret: It is a secret key that is created when the service is created in the Resont.
• Access token: Token received from user authentication and verification. Currently, the life of this token is one month.
• Scope: Access required by the service in the user's account, which is separated by a space character.
• Refresh token: token to receive a new access token. Currently, the life of this token is 1 year.
• Redirect uri: the link back to the source service (the link can be sent as a url or as a deep link)
• Authorization code: the code received when returning from the link to receive the access token

All requests should be sent to https://api.resont.com/web/. For example, to create a token, redirect the user to https:/api.resont.com/web/oauth/authorize.

Send user to Resont

To get a new token, direct the user to the following path.

After authentication and access confirmation by the user, the user will be sent to the redirect_url link. And the following values are sent as GET.

If the value of response_type is equal to code:

If the value of response_type is equal to token.

Receive access token

If you set the value of response_type to code when directing the user to the Resont, you need to send the code received in the return link to the following path to receive the access_token.

Receive a new token with Refresh token

If the access token has expired or you need a new token, get a new token by sending entries to the link below.

New request with received token

After receiving the access token, you can use the Novin Hub web service, whose documentation is in the developers. In the sent requests, send the token value with the name access_token in the request link as query params.

https://api.resont.com/v1/account?access_token={token}

List of available scopes:

• basic
• email
• mobile
• offline_access
• implicit_approve
• account
• post
• publish
• insights
• comment
• inbox

The authentication process is based on oAuth2 and you need client_id and client_secret to use it.

The following definitions can help you better understand the concepts.

• User: A person who has an account on Novin Hub site.
• Service: a website or application that intends to use Novin Hub's api.
• Client id: It is the ID of the user's service, which is created when the service is created in the Resont.
• Client secret: It is a secret key that is created when the service is created in the Resont.
• Access token: Token received from user authentication and verification. Currently, the life of this token is one month.
• Scope: Access required by the service in the user's account, which is separated by a space character.
• Refresh token: token to receive a new access token. Currently, the life of this token is 1 year.
• Redirect uri: the link back to the source service (the link can be sent as a url or as a deep link)
• Authorization code: the code received when returning from the link to receive the access token

All requests should be sent to https://api.resont.com/web/. For example, to create a token, redirect the user to https:/api.resont.com/web/oauth/authorize.

Send user to Resont

To get a new token, direct the user to the following path.

After authentication and access confirmation by the user, the user will be sent to the redirect_url link. And the following values ​​are sent as get.

If the value of response_type is equal to code.

If the value of response_type is equal to token.

Receive access token

If you set the value of response_type to code when directing the user to the Resont, you need to send the code received in the return link to the following path to receive the access_token.

Receive a new token with Refresh token

If the access token has expired or you need a new token, get a new token by sending entries to the link below.

New request with received token

After receiving the access token, you can use the Novin Hub web service, whose documentation is in the link https://resont.com/developers. In the sent requests, send the token value with the name access_token in the request link as query params.

https://api.resont.com/v1/account?access_token={token}

Apply OAuth

In Resont, two types of tokens are placed in the API, and the user token is always available in the profile settings section.

We need to coordinate with you for the OAuth token, and for this purpose, please complete the form below so that we can contact you as soon as possible.

webhook

Webhook is one of the methods by which web applications can communicate with each other. Using webhooks, third-party APIs can be used in the application development project. Webhooks make it possible to send real-time data from one application to another whenever an event occurs.

If you need to receive events during changes in the Resont, you can use webhook.

The data sent in json format is sent to the webhook_url link that was registered when the client_id was registered.

Receive Changes

To receive changes via webhook, there must be a valid Refresh token with offline_access access.

The structure of the sent value is as follows:

message_created type
Occurs when a new (direct) message is registered in the user's account.
payload value:
https://resont.com/developers#reference-Message
comment_created type
Occurs when a new comment is registered in the user's account https://resont.com/developers#reference-Comment

Accounts

With the help of this service, you can manage different social media accounts.

Accounts List

With the help of this service, you can get the list of all the desired user accounts.

You can also receive the following values ​​with the help of Field expansion by sending a parameter with with a value meta based on social networks.

Create Account

You can add a new account with the help of this service.

Account detail

With the help of this service, you can accountId get account details with ID.

Edit account

With the help of this service, you can accountId edit the account with ID.

Delete account

With the help of this service, you can delete the account with ID accountId.

Account groups

With the help of this service, you can group your social network accounts and place them in different groups. This grouping is used for faster selection when publishing content.

Account groups list

With the help of this service, you can get the list of all the desired user account groups.

Create account group

With the help of this service, you can add a new account group.

Account group detail

With the help of this service, you can get the details of the account group with ID accountGroupId.

Edit Account group

With the help of this service, you can accountGroupId edit the account group with ID.

delete account group

With the help of this service, you can delete the account group with ID accountGroupId.

Captions

With the help of this service, you can insert ready-made captions for your account and use them when posting.

Captions list

With the help of this service, you can get the list of all captions of the desired user.

Create caption

With the help of this service, you can add a new caption.

Caption detail

With the help of this service, you can get the description of the caption with the ID captionId.

Edit caption

With the help of this service, you can captionId edit the caption with ID.

Delete caption

With the help of this service, you can captionId delete the caption with ID.

Comments

With the help of this service, you can manage the comments received on social networks in a dashboard.

All features of viewing, responding and deleting are available, and Resont also provides you with more features such as creating tags and categories, receiving output files, etc.

Comments list

With the help of this service, you can get the list of comments of the desired user.

Comment detail

With the help of this service, you can commentId get comment details with ID.

Comment replies

With the help of this service, you can commentId get the list of comment responses with ID.

Reply to comment

With the help of this service, you can commentId add a new reply to a comment with an ID.

Like comment

With the help of this service, you can commentId add or remove likes to comments with ID.

Change comment tag

With the help of this service, you can commentId update the comment tags with ID.

Delete comment

With the help of this service, you can commentId delete the comment with ID.

comments subscribe

With the help of this service, you can activate the desired accounts to receive comments.

comments social user

With the help of this service, you can get the details of the user who sent the comment with the ID socialUserId.

Comment post detail

With the help of this service, you can get the details of the comment post with ID commentId.

Comment tags

With the help of this service, you can add tags to comments.

You can categorize comments using this feature.

Comment tags list

With the help of this service, you can get the list of all the comment tags of the desired user.

Create comment tag

With the help of this service, you can add a new comment tag.

Comment tag detail

With the help of this service, you can get the details of the comment tag with ID commentTagId

Edit Comment tag

With the help of this service, you can edit the comment tag with ID commentTagId.

Delete comment tag

With the help of this service, you can remove the comment tag with commentTagId ID.

conversations

With the help of conversations service in Resont, you can manage all direct messages in your social networks through Resont.

It is possible to respond, categorize, view simultaneously, etc. in the Resont for easier and better management of messages.

Conversations list

With the help of this service, you can get the list of conversations of the desired user.

conversation detail

With the help of this service, you can conversationId get the details of the conversation with the ID.

messages list

With the help of this service, you can get the list of all conversation messages with the conversationId desired user ID.

message detail

With the help of this service, you can get the details of the message with the ID messageId.

Reply to conversation

With the help of this service, you can conversationId add a new answer to the conversation with the ID.

Action to conversation

With the help of this service, you can conversationId add or remove action to the conversation with ID.

Change conversation tag

With the help of this service, you can conversationId update conversation tags with ID.

Conversations subscribe

With the help of this service, you can activate the desired accounts to receive calls.

Conversation tags

With the help of this service, you can add tags to conversations.

With this feature, you can easily categorize conversations.

Conversation tags list

With the help of this service, you can get the list of all the conversation tags of the desired user.

Create conversation tag

With the help of this service, you can add a new conversation tag.

Conversation tag detail

With the help of this service, you can get the details of the conversation tag with the ID conversationTagId.

Edit conversation tag

With the help of this service, you can edit the conversation tag with ID conversationTagId.

Remove conversation tag

With the help of this service, you can remove the conversation tag with conversationTagId.

Manage files

With the help of this service, you can upload a new file or manage the existing files, use me/files to see the status of the used space.

Files list

With the help of this service, you can get the list of all the files of the desired user.

Upload file

With the help of this service, you can add a new file.

File detail

With the help of this service, you can fileId get the details of the file with ID.

delete file

With the help of this service, you can delete the file with fileId. با کمک این سرویس می‌توانید فایل با شناسه fileId را حذف کنید.

insights

Using this service, you can analyze accounts or published content and get complete data about their status.

Account insights

With the help of this service, you can get the list of all conversation messages with the conversationId desired user ID.

post insights

With the help of this service, you can get the post group analysis data with the postGroupId desired user ID.

User information

This service shows the profile of the user entered with the token, all dates and times are sent to the output in the format available in this section.

User account detail

With the help of this service, you can get the details of the current user.

User files detail

With the help of this service, you can get the details of the storage space of the logged in user.

Posts

In this service you can send different posts.

posts list

With the help of this service, you can get the list of the desired user's post group.

Create post

You can add a new post with the help of this service.

Post group detail

With the help of this service, you can get the details of the post group with the ID postGroupId.

Post detail

With the help of this service, you can postId get post details with ID.

Edit post

With the help of this service, you can postGroupId edit the post with ID.

Edit post after publish

With the help of this service, you can postGroupId edit the post with ID.

Editing is currently supported for Telegram and Instagram networks.

Post retry

With the help of this service, you can register the post group with ID postGroupId for retry.

Cancel post

With the help of this service, you can postGroupId cancel the post group with ID.

delete post

With the help of this service, you can postGroupId delete the post group with ID.

Draft posts list

With the help of this service, you can get the list of the group of draft posts of the desired user.

Search

In this section, you can use the search service for some sections such as hashtag, location, stickers, etc.

Location search

With the help of this service, you can search for hashtags similar to the posted hashtag.

User search

With the help of this service, you can search for hashtags similar to the posted hashtag.

Search similar hashtags

With the help of this service, you can search for hashtags similar to the posted hashtag.

stickers

With the help of this service, you can add different stickers to the content published in Instagram stories.

Due to the many updates of Instagram, not all stickers may be supported in Navin Hub.

Create sticker image

With the help of this service, you can get the image based on the sent stickers.

Tickets

With the help of this service, you can create a ticket or a support message in Resont and communicate with different support departments.

Currently, tickets are answered 24 hours a day in Resont.

Tickets list

With the help of this service, you can get the list of tickets of the desired user.

Ticket departments list

With the help of this service, you can get the list of all support units.

Create ticket

With the help of this service, you can create a new ticket.

ticket detail

With the help of this service, you can ticketId get the details of the ticket with ID.

ticket messages list

With the help of this service, you can get the list of all ticket messages with the ticketId desired user ID.

Reply to ticket

With the help of this service, you can ticketIdadd a new response to the ticket with ID.

Close ticket

With the help of this service, you can ticketId close the ticket with ID.

Reference

In this section, you can see a complete list of items that are available in each service from the API.

This page helps you to access the list of all commands in each service much faster.

Account

AccountGroup

AccountPost

BooleanResponse

Caption

Comment

CommentTag

Conversation

ConversationParticipant

CursorPagination

Department

ErrorResponse

File

GenerateImage

Insights

InsightsResponse

Message

MessageReaction

Pagination

Post

PostGroup

RedirectResponse

SocialUser

SearchLocation

SearchPeople

StorageInfo

Ticket

TicketMeta

TicketUser

User