jing-openplatform-api
  1. OAuth授权（Authorization）
jing-openplatform-api
  • 开放接口-V1文档 (Interface Document_V1)
    • 开发前必读（Must Read Before Development）
      • 接口更新日志 (Interface Update Log)
      • 接入指南（Access Guide）
      • 接口权限（Interface Permissions）
      • 访问频率和并发限制（Access Frequency & Concurrency Restrictions）
      • 全局错误码说明（Global Error Code Description）
    • OAuth授权（Authorization）
      • 获取访问Token（Get Access Token）
        POST
      • 刷新 Token（Refresh Token）
        POST
    • 用户管理（User Management）
      • 用户批量创建（User Batch Creation）
      • 用户查询（User Query）
      • 用户批量更新（User Batch Update）
      • 批量查询用户身份 (User Batch Query)
      • 用户列表查询（User List Query）
    • 用户群组 (User Group)
      • 查询静态人群列表 (Query Static Group)
      • 获取静态人群详情 (Get Static Group Details)
      • 查询静态人群详情用户列表 (Query Static Group User List)
      • 创建静态人群 (Creat Static Group)
      • 更新静态人群 (Update Static Group)
      • 删除静态人群 (Delete Static Group)
      • 导入群组用户 (Import Group User)
    • 用户标签（User Tags）
      • 批量创建普通标签（Batch Creating Tags）
      • 批量给用户打标签（Batch Tagging Users）
      • 查询普通标签 (Query Tags)
      • 移除用户标签 (Remove Tags)
    • 活动管理 (Activities Management)
      • 查询活动详情 (Query Activity Details)
      • 查询活动列表 (Query Activity List)
      • 查询活动报名用户列表 (Query Activity Registered User List)
      • 批量更新活动用户状态 (Batch Update Activity User Status)
    • 邮件管理 (EDM Management)
      • 查询邮箱列表 (Query Email Address List)
      • 创建发送邮件 (Crest Send Email)
      • 查询发送邮件详情 (Query Send Email Details)
      • 更新发送邮件 (Update Send Email)
      • 删除发送邮件 (Delete Send Email)
      • 查询发送邮件列表 (Query Send-Email List)
      • 查询发送明细 (Query Send Details)
    • 短信管理 (SMS Management)
      • 查询短信列表 (Query Message List)
      • 查询短信发送详情 (Query Send Message Detail)
      • 创建任务 (Create Task)
      • 发送 (Send Message)
    • 来源管理 (Source Management)
      • 查询来源选项 (Query Source Option)
      • 创建自定义来源选项 (Create Custom Source Option)
      • 更新自定义来源选项 (Update Custom Source Option)
      • 查询来源下所有选项 (Query all Options from Source)
    • 二维码管理 (QR Code Management)
      • 创建临时二维码 (Create Temporary QR Code)
      • 创建永久二维码 (Create Permanent QR Code)
    • 会员管理 (Member Management)
      • 会员创建 (Create Member)
      • 会员查询 (Query Member)
      • 会员更新 (Update Member)
      • 查询会员剩余积分 (Query Member Remaining Points)
      • 查询会员规则列表 (Query Member Rule List)
      • 查询会员列表 (Query Member List)
      • 扣减会员积分 (Deduct Member Points)
      • 增加会员积分 (Add Member Points)
    • 成员管理 (Employee Management)
      • 查询成员信息（Query Member Information）
    • 微信公众号 (WeChat Account)
      • 发送微信模版消息 (Send WeChat Template Message)
      • 获取用户的openid和关注状态 (Get User Openid & Follow Status)
    • 线索管理（Lead Management）
      • 线索创建（Lead Creation）
      • 线索更新（Lead Update）
      • 线索查询（Lead Query）
      • 线索状态列表查询（Get Lead Status List）
      • 线索状态更新（Get Status Update）
      • 线索布局列表查询（Lead List）
      • 更新线索协作人（Update Lead Collaborators）
      • 查询线索详情链接（Query Lead Details Link）
    • 客户管理（Account Management）
      • 客户创建（Account Creation）
      • 客户查询（Account Query）
      • 客户更新（Account Update）
      • 客户布局列表查询（Account List）
    • CRM 对象通用接口（CRM Object Interface）
      • 查询业务类型列表（Get Business Type）
      • 查询选项集字段（Get Option Set Fields）
      • 查询来源选项字段(获取下拉选项)（Source Field Type (Get Drop-down Options)）
      • 查询自定义选项字段（Get Custom Option Set Fields）
      • 查询对象所有字段（Get All Fields of the Object）
    • CTA管理 (CTA Management)
      • 查询CTA列表 (Query CTA List)
      • 查询CTA明细列表 (Query CTA Detail List)
    • 模板消息 (Template Message)
      • 创建模版消息 (Create Template Message)
      • 创建模板消息推送 (Create Template Message Send)
      • 更新模板消息 (Update Template Message)
      • 查询模版消息详情 (Query Template Message Detail)
      • 删除模版消息 (Delete Template Message)
      • 查询模板消息列表 (Query Template Message List)
      • 查询微信模板列表 (Query WeChat Template Message List)
      • 查询消息模板推送明细 (Query Template Message Send Detail)
      • 查询消息模板点击明细 (Query Template Message Chick Detail)
      • 查询模板消息推送记录列表 (Query Template Message Send Record List)
    • 隐私条款v1（Privacy Policy_V1）
      • 查询隐私条款列表（Query Privacy Policy List）
      • 查询隐私条款授权记录列表（Query Privacy Policy Authorization Record List）
    • 隐私条款v2（Privacy Policy_V2）
      • 查询隐私条款列表（Query Privacy Policy List）
      • 新增用户授权记录（Add User Authorization Record）
      • 查询用户授权状态（Query User Authorization Status）
      • 移除用户授权记录（Delete User Authorization Record）
      • 查询隐私条款模版（Query Privacy Policy Templete）
    • 企业微信 (WeCom Management)
      • 发送企微应用消息（Send WeCom App Message）
      • 获取用户的企微好友状态(Get User's WeCom Friendship Status )
    • 评分管理 (Scoring Management)
      • 批量查询用户意向评分 (Batch Query User Intention Scoring)
      • 批量查询用户行为评分 (Batch Query User Active Scoring)
      • 批量查询线索身份评分 (Batch Query Lead Identity Scoring)
      • 批量查询线索行为评分 (Batch Query Lead Active Scoring)
      • 批量查询线索意向评分 (Batch Query Lead Intention Scoring)
      • 批量查询用户身份评分 (Batch Query User Identity Scoring)
      • 批量用户行为评分清零 (Batch Delete User Action Scoring)
    • 自定义事件 (Custom Events)
      • 创建自定义事件 (Creat Custom Events)
      • 上报自定义事件 (Report Custom Events)
    • 公司管理 (Company Management)
      • 批量创建公司 (Batch Create Company)
      • 批量更新公司 (Batch Update Company)
      • 批量删除公司 (Batch Delete Company)
      • 批量获取公司列表 (Batch Get Company List)
  • webhook
    • 用户（User）
      • 用户创建（User Creation）
      • 创建用户webhook推送事件（Create Push Events of User webhook）
        • add_omni_user_success事件（add_omni_user_success event）
      • 修改用户webhook推送事件
        • custom_field事件（修改用户信息）
    • 活动
      • 创建活动
        • 活动webhook-直播
        • 活动webhook-会议
      • 更新活动
        • 更改直播活动webhook
        • 更改会议活动webhook
      • 删除活动
        • 删除直播活动webhook
        • 删除会议活动webhook
    • 线索（Lead）
      • 线索事件说明文档（Description Document of Lead Event）
      • 创建线索webhook推送事件（Create Push Events of User webhook）
        • add_omni_user_success事件（add_omni_user_success event）
        • object_create事件（object_create event）
        • object_update_life_cycle事件（object_update_life_cycle event）
        • object_source_info事件（object_source_info event）
      • 线索更新（Lead Update）
        • object_update_life_cycle事件（object_update_life_cycle event）
        • object_update事件（object_update event）
      • 线索状态更新（Lead Update Status）
        • object_update_status事件（object_update_status event）
      • 线索作废（Lead Voided）
        • object_voids事件（object_voids event）
      • 线索负责人变更（Lead Owner Change）
        • object_change_owner事件（不包含线索信息）（object_change_owner event (without lead information)）
        • object_change_owner事件（包含线索信息，需要平台人员手动配置启用）
      • 线索生命周期变更（Lead Lifecycle Change）
        • object_update_life_cycle事件（object_update_life_cycle event）
      • 线索添加备注（Lead Add Notes）
        • object_add_notes事件（object_add_notes event）
      • 线索添加协作人（Lead Add Collaborator）
        • object_add_team_member事件（object_add_team_member event）
      • 线索移除协作人（Lead Remove Collaborator）
        • object_remove_team_member事件（object_remove_team_member event）
      • 公海池变更（Lead Pool Change）
        • object_change_lead_pool事件（object_change_lead_pool event）
      • 线索关联（Lead Association）
        • object_relation事件（object_relation event）
      • 线索恢复（Lead Restore）
        • object_restore事件（object_restore event）
      • 线索来源 (Lead Source)
        • 线索来源(Lead Source)
    • 客户（Account）
      • 客户（Account）
      • 客户webhook推送（Account webhook Push）
        • 创建客户（Create Account）
          • object_create事件-客户（object_create event-Account）
        • 更新客户（Update Account）
          • object_update事件-客户（object_update event-Account）
        • 客户负责人变更（Object_Change_Owner）
          • object_change_owner事件-客户（object_change_owner event-Account）
        • 客户作废（object_voids）
          • object_voids事件-客户（object_voids event-Account）
        • 客户关联线索（object_relation）
          • object_relation事件-客户（object_relation event-Account）
    • 模板消息(Template Message)
      • 点击模板消息
      • 模板消息推送成功(Template Send Success)
      • 模板消息推送失败(Template Send Error)
      • 模板消息推送通知(Template Message Push Notification)
        • template_send事件（template_send event）
    • Jingtrack
      • JINGtrack-H5
        • 访问页面（pageView）
        • 自定义事件（customEvent）
      • JINGtrack-小程序
        • 访问页面 (小程序）(View Page)
          • pages/store/detail/detail事件（pages/store/detail/detail event）
        • 小程序自定义事件(tracking_customevent)
          • RemoveFromCart事件（RemoveFromCart Event）
        • 打开小程序(Open Mini Program)
          • tracking_vst事件（tracking_vst event）
        • 关闭小程序(Close Mini Program)
          • tracking_cls事件（tracking_cls event）
    • 评分(Scoring)
      • 身份等级变更(Identity Grade Updated)
        • 身份等级变更事件（custom_field_update event）
      • 行为等级变更(Active Level Update)
        • 行为等级变更事件（total_update event）
    • 用户行为（User Action）
      • 活动用户行为
        • 提交活动报名信息
      • CTA用户行为
        • CTA提交信息
      • 用户标签行为
        • 用户打标签
      • 授权隐私条款行为
        • 授权隐私条款（Authorized Privacy Policy）
    • 系统行为（System Action）
      • 活动系统行为
        • 活动报名用户状态变更（Change Activity Registered User Status）
  1. OAuth授权（Authorization）

刷新 Token（Refresh Token）

live-阿里云（Alibaba Cloud）
https://jingopenapi.jingsocial.com
live-阿里云（Alibaba Cloud）
https://jingopenapi.jingsocial.com
POST
https://jingopenapi.jingsocial.com
/v1/oauth2/token/refresh
由于Access_Token 有效期（默认2小时）较短,当Access_Token超时过期后，可以使用 Refresh_token 进行刷新，每次刷新都会产生新的 Access_token。
Refresh_Token 有效期是为30天，过期后可以调用获取 Access_Token 接口获取新的 Refresh_token 和 AccessToken,同时老的 Refresh_token 会过期。
Since the validity period of Access_Token (default 2 hours) is relatively short, when the Access_Token timeout expires, you can use Refresh_token to refresh it, and each time it is refreshed, a new Access_token will be generated.
Refresh_Token is valid for 30 days, after the expiration date, you can call the Get Access_Token interface to get a new Refresh_token and AccessToken, meanwhile the old Refresh_token will expire.

请求参数

Body 参数application/json
app_id
string 
必需
app_secret
string 
必需
refresh_token
string 
有效期30天
必需
示例
{
	"app_id": "{{app_id}}",
	"app_secret":"{{app_secret}}",
    "refresh_token":"{{access_token}}"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://jingopenapi.jingsocial.com/v1/oauth2/token/refresh' \
--header 'Content-Type: application/json' \
--data-raw '{
	"app_id": "202305171108447827375161344",
	"app_secret":"c32501b33424473daebb9d43ccc37c57",
    "refresh_token":""
}'

返回响应

🟢200成功
application/json
Body
request_id
string 
可选
code
integer 
可选
msg
string 
可选
data
object 
可选
access_token
string 
必需
scope
string 
必需
token_type
string 
必需
expires_in
integer 
必需
refresh_token
string 
必需
示例
{
    "request_id": "6f843be20b21c5e18b9825616b85b424",
    "code": 0,
    "msg": "success",
    "data": {
        "access_token": "535eda1d-a06e-42f9-958f-d244ae72b646",
        "refresh_token": "fc5e86a1-81da-4715-a18f-8724ff1fd413",
        "scope": "all",
        "token_type": "bearer",
        "expires_in": 4511
    },
    "timestamp": 1722583035263
}
🟢200失败
修改于 2024-08-02 08:53:56
上一页
获取访问Token（Get Access Token）
下一页
用户批量创建（User Batch Creation）
Built with