开发者API

强大的 API接口

使用RESTful API将全媒运营官的强大功能集成到您的应用程序中，实现自动化内容发布和管理

v2.1
API版本
50+
接口数量
1000/h
请求限制
99.9%
稳定性

快速开始

4个步骤快速集成API

1

获取API密钥

在用户设置页面生成您的API密钥

2

安装SDK

选择您喜欢的编程语言安装对应SDK

3

发起第一个请求

使用API获取账户信息验证集成

4

探索更多功能

浏览完整API文档了解所有可用功能

API文档

完整的接口说明和使用指南

API概览

RESTful API接口，支持JSON格式数据交互

基础URL

https://api.omniopra.com/v2

认证方式

Bearer Token

数据格式

JSON

请求限制

1000次/小时

身份认证

基于Token的安全认证机制

API密钥获取

在用户设置中生成API密钥

/auth/token

Token使用

在请求头中添加Authorization字段

Bearer {token}

Token刷新

定期刷新Token保证安全性

/auth/refresh

权限验证

验证用户权限和访问范围

/auth/verify

核心接口

完整的API接口文档和示例

内容管理

GETPOSTPUTDELETE

创建、编辑、删除内容

/content

平台管理

GETPOSTPUT

管理发布平台和账号配置

/platforms

发布任务

GETPOSTPUT

创建和管理发布任务

/tasks

数据分析

GET

获取发布数据和统计信息

/analytics

Webhook事件

实时事件通知和回调处理

task.completed

发布任务完成

载荷包含：任务ID、结果状态、平台信息

task.failed

发布任务失败

载荷包含：任务ID、错误信息、失败原因

content.created

内容创建成功

载荷包含：内容ID、标题、创建时间

account.updated

平台账号更新

载荷包含：平台ID、账号信息、更新时间

代码示例

常用操作的示例代码

请求示例

获取内容列表

curl
curl -X GET "https://api.omniopra.com/v2/content" \
  -H "Authorization: Bearer your_token" \
  -H "Content-Type: application/json"

创建发布任务

javascript
const response = await fetch('https://api.omniopra.com/v2/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your_token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    contentId: '12345',
    platforms: ['wechat', 'weibo'],
    scheduledAt: '2024-01-20T10:00:00Z'
  })
});

获取数据分析

python
import requests

headers = {
    'Authorization': 'Bearer your_token',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://api.omniopra.com/v2/analytics/summary',
    headers=headers,
    params={'period': '30d'}
)

data = response.json()

响应示例

成功响应

JSON
{
  "success": true,
  "data": {
    "id": "12345",
    "title": "示例内容",
    "status": "published",
    "createdAt": "2024-01-20T10:00:00Z"
  },
  "message": "操作成功"
}

错误响应

JSON
{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "令牌无效或已过期",
    "details": "请检查Authorization头中的令牌"
  }
}

SDK与开发包

多种编程语言的官方SDK

🟨

JavaScript/Node.js

已发布
🐍

Python

已发布
🐘

PHP

已发布
☕

Java

开发中

正在开发中，敬请期待

🔵

Go

规划中

计划开发中

💎

Ruby

规划中

计划开发中

使用限制

请求频率限制

免费版100次/小时
专业版1,000次/小时
企业版10,000次/小时

超限提醒

超过限制后将返回429状态码，建议实现指数退避重试机制

最佳实践

错误处理

始终检查响应状态码，实现适当的错误处理逻辑

数据缓存

合理缓存API响应数据，减少不必要的请求

安全考虑

妥善保管API密钥，避免在客户端代码中暴露

版本管理

API会持续演进，建议订阅更新通知获取最新变更

开始构建您的应用

立即获取API密钥，开始集成全媒运营官的强大功能

获取API密钥查看完整文档
免费账户包含100次/小时API调用，无需信用卡