Đăng bài ảnh
curl --request POST \
--url https://api.madiad.com/v1/posts/photos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'profile_id=<string>' \
--form 'caption=<string>' \
--form 'title=<string>' \
--form photos=@example-file \
--form 'photo_urls=<string>' \
--form scheduled_at=2023-11-07T05:31:56Z \
--form 'timezone=<string>' \
--form add_to_queue=true \
--form 'facebook_page_id=<string>' \
--form 'pinterest_board_id=<string>' \
--form 'subreddit=<string>' \
--form 'reddit_title=<string>' \
--form 'first_comment=<string>'import requests
url = "https://api.madiad.com/v1/posts/photos"
files = { "photos": ("example-file", open("example-file", "rb")) }
payload = {
"profile_id": "<string>",
"caption": "<string>",
"title": "<string>",
"photo_urls": "<string>",
"scheduled_at": "2023-11-07T05:31:56Z",
"timezone": "<string>",
"add_to_queue": "true",
"facebook_page_id": "<string>",
"pinterest_board_id": "<string>",
"subreddit": "<string>",
"reddit_title": "<string>",
"first_comment": "<string>"
}
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('profile_id', '<string>');
form.append('caption', '<string>');
form.append('title', '<string>');
form.append('photos', '<string>');
form.append('photo_urls', '<string>');
form.append('scheduled_at', '2023-11-07T05:31:56Z');
form.append('timezone', '<string>');
form.append('add_to_queue', 'true');
form.append('facebook_page_id', '<string>');
form.append('pinterest_board_id', '<string>');
form.append('subreddit', '<string>');
form.append('reddit_title', '<string>');
form.append('first_comment', '<string>');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://api.madiad.com/v1/posts/photos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.madiad.com/v1/posts/photos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"profile_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"caption\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photos\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photo_urls\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"scheduled_at\"\r\n\r\n2023-11-07T05:31:56Z\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"timezone\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"add_to_queue\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"facebook_page_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pinterest_board_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"subreddit\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reddit_title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_comment\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: multipart/form-data"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.madiad.com/v1/posts/photos"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"profile_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"caption\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photos\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photo_urls\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"scheduled_at\"\r\n\r\n2023-11-07T05:31:56Z\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"timezone\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"add_to_queue\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"facebook_page_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pinterest_board_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"subreddit\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reddit_title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_comment\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.madiad.com/v1/posts/photos")
.header("Authorization", "Bearer <token>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"profile_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"caption\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photos\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photo_urls\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"scheduled_at\"\r\n\r\n2023-11-07T05:31:56Z\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"timezone\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"add_to_queue\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"facebook_page_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pinterest_board_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"subreddit\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reddit_title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_comment\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.madiad.com/v1/posts/photos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"profile_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"caption\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photos\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photo_urls\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"scheduled_at\"\r\n\r\n2023-11-07T05:31:56Z\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"timezone\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"add_to_queue\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"facebook_page_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pinterest_board_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"subreddit\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reddit_title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_comment\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"status": "completed",
"profile_id": "<string>",
"platforms": [
"<string>"
],
"failed_platforms": [
"<string>"
],
"request_id": "<string>",
"job_id": "<string>",
"truncated": [
{
"platform": "<string>",
"text": "title",
"field": "<string>",
"length": 123,
"limit": 123,
"unit": "utf16"
}
],
"results": {},
"warnings": [
{
"platform": "<string>",
"code": "music_not_applied",
"message": "<string>"
}
]
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}posts
Đăng bài ảnh
Đăng một hoặc nhiều ảnh. Gửi dạng multipart/form-data để tải thẳng tệp trong photos[], hoặc dạng JSON khi mọi ảnh đều là địa chỉ.
Có thể ghi đè cho riêng từng kênh bằng các trường gửi thêm, chúng được chuyển đi nguyên vẹn: <kênh>_caption ghi đè phần thân và <kênh>_title ghi đè tiêu đề, cho bất kỳ kênh nào có trong platforms.
POST
/
v1
/
posts
/
photos
Đăng bài ảnh
curl --request POST \
--url https://api.madiad.com/v1/posts/photos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'profile_id=<string>' \
--form 'caption=<string>' \
--form 'title=<string>' \
--form photos=@example-file \
--form 'photo_urls=<string>' \
--form scheduled_at=2023-11-07T05:31:56Z \
--form 'timezone=<string>' \
--form add_to_queue=true \
--form 'facebook_page_id=<string>' \
--form 'pinterest_board_id=<string>' \
--form 'subreddit=<string>' \
--form 'reddit_title=<string>' \
--form 'first_comment=<string>'import requests
url = "https://api.madiad.com/v1/posts/photos"
files = { "photos": ("example-file", open("example-file", "rb")) }
payload = {
"profile_id": "<string>",
"caption": "<string>",
"title": "<string>",
"photo_urls": "<string>",
"scheduled_at": "2023-11-07T05:31:56Z",
"timezone": "<string>",
"add_to_queue": "true",
"facebook_page_id": "<string>",
"pinterest_board_id": "<string>",
"subreddit": "<string>",
"reddit_title": "<string>",
"first_comment": "<string>"
}
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('profile_id', '<string>');
form.append('caption', '<string>');
form.append('title', '<string>');
form.append('photos', '<string>');
form.append('photo_urls', '<string>');
form.append('scheduled_at', '2023-11-07T05:31:56Z');
form.append('timezone', '<string>');
form.append('add_to_queue', 'true');
form.append('facebook_page_id', '<string>');
form.append('pinterest_board_id', '<string>');
form.append('subreddit', '<string>');
form.append('reddit_title', '<string>');
form.append('first_comment', '<string>');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://api.madiad.com/v1/posts/photos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.madiad.com/v1/posts/photos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"profile_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"caption\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photos\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photo_urls\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"scheduled_at\"\r\n\r\n2023-11-07T05:31:56Z\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"timezone\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"add_to_queue\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"facebook_page_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pinterest_board_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"subreddit\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reddit_title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_comment\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: multipart/form-data"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.madiad.com/v1/posts/photos"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"profile_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"caption\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photos\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photo_urls\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"scheduled_at\"\r\n\r\n2023-11-07T05:31:56Z\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"timezone\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"add_to_queue\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"facebook_page_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pinterest_board_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"subreddit\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reddit_title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_comment\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.madiad.com/v1/posts/photos")
.header("Authorization", "Bearer <token>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"profile_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"caption\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photos\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photo_urls\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"scheduled_at\"\r\n\r\n2023-11-07T05:31:56Z\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"timezone\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"add_to_queue\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"facebook_page_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pinterest_board_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"subreddit\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reddit_title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_comment\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.madiad.com/v1/posts/photos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"profile_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"caption\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photos\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"photo_urls\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"scheduled_at\"\r\n\r\n2023-11-07T05:31:56Z\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"timezone\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"add_to_queue\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"facebook_page_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"pinterest_board_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"subreddit\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"reddit_title\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_comment\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"status": "completed",
"profile_id": "<string>",
"platforms": [
"<string>"
],
"failed_platforms": [
"<string>"
],
"request_id": "<string>",
"job_id": "<string>",
"truncated": [
{
"platform": "<string>",
"text": "title",
"field": "<string>",
"length": 123,
"limit": 123,
"unit": "utf16"
}
],
"results": {},
"warnings": [
{
"platform": "<string>",
"code": "music_not_applied",
"message": "<string>"
}
]
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>"
}
}Ủy quyền
API key của bạn, gửi ở header Authorization: Bearer <key>. Một key quản lý mọi hồ sơ trong tài khoản.
Tiêu đề
Khoá bạn tự sinh cho TỪNG bài, ghi xuống TRƯỚC khi gọi. Dùng lại một khoá đã hoàn tất thì API trả về kết quả cũ chứ không đăng bài mới — nhìn từ ngoài giống hệt bị bỏ qua trong im lặng. Dùng lại cho một thân yêu cầu KHÁC thì nhận idempotency_conflict.
Nội dung
multipart/form-dataapplication/json
Id của hồ sơ thương hiệu cần thao tác. Lấy danh sách bằng GET /v1/profiles.
Các kênh cần đăng. Nhận cả chuỗi các mã cách nhau bằng dấu phẩy. Chỉ những kênh liệt kê ở đây nhận bài ảnh; kênh khác bị từ chối bằng 400.
Tùy chọn có sẵn:
tiktok, instagram, linkedin, facebook, x, threads, pinterest, reddit, bluesky, google_business, telegram, discord, mastodon, lemmy, wordpress PHẦN THÂN của bài. Đây KHÔNG phải tiêu đề: title (và <kênh>_title cho riêng từng kênh) là trường khác. Nhét thân bài vào title thì bài vẫn đăng được nên rất khó phát hiện, nhưng nó đi vòng qua phép kiểm độ dài thân bài.
TIÊU ĐỀ bài, dùng chung cho mọi kênh. YouTube, Reddit và Pinterest bắt buộc có; <kênh>_title ghi đè cho riêng một kênh.
Tệp ảnh gửi kèm trong yêu cầu (chỉ với multipart). Dùng lẫn với photo_urls được; ảnh gửi kèm xếp trước.
Địa chỉ https:// của các ảnh. Ảnh được tải về ở phía máy chủ nên KHÔNG dính trần 4,5 MB của thân yêu cầu như khi tải thẳng tệp qua photos[].
Đăng vào thời điểm này thay vì đăng ngay (ISO 8601). Đi kèm timezone.
Múi giờ IANA cho scheduled_at, ví dụ Asia/Ho_Chi_Minh.
Đưa bài vào hàng chờ của hồ sơ thay vì đăng ngay.
Trang Facebook cần đăng lên. BỊ BỎ QUA khi hồ sơ đã ghim sẵn một Trang (ghim thắng), và bị BỎ HẲN ở các bài hẹn giờ.
BẮT BUỘC khi đăng lên Pinterest. Bảng Pinterest đích. Lấy danh sách bằng GET /v1/connections/pinterest/boards.
BẮT BUỘC khi đăng lên Reddit. Subreddit đích, không kèm tiền tố r/.
BẮT BUỘC khi đăng lên Reddit. Tiêu đề bài trên Reddit. Thiếu thì lấy caption.
Đoạn chữ đăng làm bình luận đầu tiên. Chỉ Trang Facebook.
Phản hồi
Thành công.
processing và scheduled chưa phải kết quả — tra lại bằng GET /v1/posts/status. draft: không kênh nào từ chối, nhưng ít nhất một kênh đang giữ bài ở mục nháp (xem results.<kênh>.draft); đây là kết quả cuối. canceled chỉ có ở lệnh tra trạng thái: bài hẹn giờ đã huỷ trước khi chạy. unknown: lệnh đăng đã ngừng chờ trước khi các kênh trả lời (502 upstream_timeout) và phía các kênh chưa nhận được bài; cứ tra tiếp.
Tùy chọn có sẵn:
completed, draft, partial, failed, processing, scheduled, canceled, unknown Chỉ xuất hiện khi có ít nhất một kênh từ chối.
Chỉ xuất hiện khi caption chung đã được cắt cho vừa một kênh. Mỗi kênh và mỗi phần chữ một dòng: text là title (tiêu đề), caption (nội dung) hoặc description (mô tả), field là trường của kênh nhận phần chữ đã cắt, length là độ dài caption và limit là giới hạn, cả hai tính theo unit (utf16 là ký tự, utf8 là byte, dùng cho mô tả YouTube). Kênh nào không có trong danh sách thì nhận đủ caption.
Show child attributes
Show child attributes
Khoá theo tên kênh.
Show child attributes
Show child attributes
Chỉ xuất hiện khi một kênh đã đăng bài nhưng không đúng hẳn như yêu cầu — ví dụ bài ảnh TikTok lên mà không có nhạc đã chọn. Cảnh báo KHÔNG đổi status: bài đã lên, đừng gửi lại. Với bài xử lý nền, cảnh báo xuất hiện ở GET /v1/posts/status, không có ở phản hồi đăng đầu tiên. Cảnh báo mà nền tảng chỉ trả kèm câu trả lời đầu tiên của bài thì chỉ có ở phản hồi đăng.
Show child attributes
Show child attributes