Update a RevShare campaign

curl --request POST \
  --url https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaign_id": "revc_abc123",
  "name": "Telegram channel A",
  "tags": [
    "test-tag"
  ]
}
'

import requests

url = "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update"

payload = {
    "campaign_id": "revc_abc123",
    "name": "Telegram channel A",
    "tags": ["test-tag"]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({campaign_id: 'revc_abc123', name: 'Telegram channel A', tags: ['test-tag']})
};

fetch('https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update', 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://partners.onlytraffic.com/api/marketer/revshare/campaigns/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'campaign_id' => 'revc_abc123',
    'name' => 'Telegram channel A',
    'tags' => [
        'test-tag'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$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://partners.onlytraffic.com/api/marketer/revshare/campaigns/update"

	payload := strings.NewReader("{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "campaign_id": "revc_abc123",
    "of_account_id": 456789,
    "of_username": "modelname",
    "name": "My RevShare Campaign",
    "url": "https://onlyfans.com/modelname/c1",
    "type": "link",
    "status": "active",
    "revshare_percent": 40,
    "visits": 1200,
    "subscribers": 85,
    "subscribers_today": 3,
    "income": 542.3,
    "income_today": 12.5,
    "revenue": 216.92,
    "onlyfans_account": {
      "name": "Model Name",
      "username": "modelname",
      "about": "About text",
      "tags": [
        "brunette"
      ],
      "avatar": {
        "original": "https://cdn.example.com/avatar.jpg",
        "thumbnail": "https://cdn.example.com/avatar_thumb.jpg",
        "thumbnail_640": "https://cdn.example.com/avatar_640.jpg"
      },
      "demo_content": [],
      "regular_price": 9.99,
      "promotions": [],
      "blocked_countries": [],
      "subscribers_count": 3400,
      "likes_count": 87000,
      "posts_count": 560,
      "photos_count": 420,
      "videos_count": 140,
      "performer_top": 5
    },
    "tags": [
      "test-tag"
    ],
    "created_at": "2024-01-01T00:00:00+00:00",
    "created_at_ts": 1704067200,
    "finished_at": null,
    "finished_at_ts": null,
    "changed_at": "2024-06-01T12:00:00+00:00",
    "changed_at_ts": 1717243200
  }
}

Запись

Обновить RevShare-кампанию

Renames a campaign, changes its note or its tags. Same as Edit on the Campaigns page. Fields left out keep their current value.

tags replaces the whole tag list with tag names from your tag list (Campaigns -> Tags); unknown names are rejected and tags are not created here. Send an empty array to clear the tags.

Returns the updated campaign row.

Errors (status: "error", HTTP 200):

404 Campaign not found.
422 Unknown tag: <name> or Incorrect tags: array of tag names.
403 Access denied: missing / unknown key, or the account is not an active partner.
429 Rate limit exceeded (30 writes per minute per key, see the Retry-After header).
503 Service is temporarily unavailable: the platform did not answer in time. The action may still have been applied, check the matching read endpoint before repeating it.

POST

api

marketer

revshare

campaigns

update

Update a RevShare campaign

curl --request POST \
  --url https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaign_id": "revc_abc123",
  "name": "Telegram channel A",
  "tags": [
    "test-tag"
  ]
}
'

import requests

url = "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update"

payload = {
    "campaign_id": "revc_abc123",
    "name": "Telegram channel A",
    "tags": ["test-tag"]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({campaign_id: 'revc_abc123', name: 'Telegram channel A', tags: ['test-tag']})
};

fetch('https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update', 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://partners.onlytraffic.com/api/marketer/revshare/campaigns/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'campaign_id' => 'revc_abc123',
    'name' => 'Telegram channel A',
    'tags' => [
        'test-tag'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$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://partners.onlytraffic.com/api/marketer/revshare/campaigns/update"

	payload := strings.NewReader("{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "campaign_id": "revc_abc123",
    "of_account_id": 456789,
    "of_username": "modelname",
    "name": "My RevShare Campaign",
    "url": "https://onlyfans.com/modelname/c1",
    "type": "link",
    "status": "active",
    "revshare_percent": 40,
    "visits": 1200,
    "subscribers": 85,
    "subscribers_today": 3,
    "income": 542.3,
    "income_today": 12.5,
    "revenue": 216.92,
    "onlyfans_account": {
      "name": "Model Name",
      "username": "modelname",
      "about": "About text",
      "tags": [
        "brunette"
      ],
      "avatar": {
        "original": "https://cdn.example.com/avatar.jpg",
        "thumbnail": "https://cdn.example.com/avatar_thumb.jpg",
        "thumbnail_640": "https://cdn.example.com/avatar_640.jpg"
      },
      "demo_content": [],
      "regular_price": 9.99,
      "promotions": [],
      "blocked_countries": [],
      "subscribers_count": 3400,
      "likes_count": 87000,
      "posts_count": 560,
      "photos_count": 420,
      "videos_count": 140,
      "performer_top": 5
    },
    "tags": [
      "test-tag"
    ],
    "created_at": "2024-01-01T00:00:00+00:00",
    "created_at_ts": 1704067200,
    "finished_at": null,
    "finished_at_ts": null,
    "changed_at": "2024-06-01T12:00:00+00:00",
    "changed_at_ts": 1717243200
  }
}

То же, что Edit на странице Campaigns. Поля, которые вы не передали, сохраняют текущее значение.

tags — массив названий тегов из вашего списка тегов (Campaigns -> Tags), он заменяет весь список. Названия сопоставляются без учёта регистра. Неизвестное название отвечает 422 Unknown tag: <name>; теги через API не создаются. Отправьте [], чтобы убрать все теги.

Ошибки

Сообщение	Значение
`Campaign not found`	Неизвестный id, не ваша кампания или числовой внутренний id (`404`)
`Unknown tag: <name>`	Названия нет в вашем списке тегов (`422`)
`Incorrect tags: array of tag names`	`tags` не является массивом (`422`)

Авторизации

Authorization

string

header

обязательно

API key from the partner cabinet, Tools -> API (https://partners.onlytraffic.com/tools/api): up to 5 named keys per account, each Full or Read-only, ot_partners_ prefix, shown once at creation. Raw value or Bearer form. Read-only keys cannot call the POST endpoints (403 This API key is read-only); expired or revoked keys get 403 Error! Access denied.

Тело

application/json

campaign_id

string

обязательно

Campaign public id (revc_…).

name

string

Campaign name.

note

string

Private note.

Ответ

200 - application/json

Success (check status; errors are also HTTP 200)

Success
Error

status

enum<string>

Доступные опции:

success

data

object

Show child attributes

Обзор

Платформы

Форматы работы

Выплаты и безопасность

API

Обновить RevShare-кампанию

Теги

Ошибки

Авторизации

Тело

Ответ

​Теги

​Ошибки

Авторизации

Тело

Ответ

Теги

Ошибки