Custom Feature: MASS web API

[martin@rootjazz]

For access to the web api, send me an email. It's publicly available upon request.

Code: Select all

support[at]rootjazz[dot]com

--------------------------------
turn API processing on via: TOOLS > START API
note, this is likely to change

--------------------------------




API URL:
https://rootjazz.com/api/api.php


Add Mass Action:
POST
type=add
auth=<your_license_key>
job=<json_string>


Returns:

Code: Select all

{
  "status":1,
  "id":<id>
}

success: status = 1
failed: status = 0
id is the job id, used for other API calls

<json_string>

Code: Select all

{
    "MassAction": "like",
    "Url": "https://twitter.com/rootjazz/status/1734591218842222225/",
    "PauseMin": 0,
    "PauseMax": 10,
    "Num": 10,
    "Accs": "acctag_massaccs",
    "NumThreads": 1,
    "RunNow": false
}

MassAction:

follow
like
reply
bookmark
views
postlink
retweet
joincommunity

Accs:
Same format as auto write files:
Specify the accounts you want to use in CSV or a token: all, rand_XX (where XX is a number: rand_10, rand_5 rand_100), acctag_<tagname>

Accs=all
Accs=acctag_masstag1
Accs=rand_10
Accs=rootjazz,rootjazz1,rootjazz2,rootjazz@gmail.com,rootjazz3,rootjazz4

[martin@rootjazz]

Code: Select all

{
    "MassAction": "reply",
    "Url": "https://twitter.com/elonmusk/status/1734591218842031234",
    "PauseMin": 0,
    "PauseMax": 60,
    "Num": 3,
    "Accs": "all",
    "NumThreads": 1,
    "RunNow": false,
    "Comments": ["#emoji4#","checkout twitterdub for your twitter automation","a multi\n post on <br>multiple lines"]
}

[martin@rootjazz]

Code: Select all

{
    "MassAction": "follow",
    "Url": "@elonmusk",
    "PauseMin": 0,
    "PauseMax": 0,
    "Num": 20,
    "Accs": "rand_20",
    "NumThreads": 10,
    "RunNow": true,
}

[martin@rootjazz]

POST:
https://rootjazz.com/api/api.php

Code: Select all

type=add
auth=1296387tgsjyfg76e82iugasd76aer12fuyg
job={"MassAction":"like","Url":"https://twitter.com/rootjazz/status/1734591218842222225/","PauseMin":0,"PauseMax":10,"Num":10,"Accs":"acctag_massaccs","NumThreads":1,"RunNow":false}

[martin@rootjazz]

Status update

API URL:
https://rootjazz.com/api/api.php


POST
type=status
auth=<your_license_key>
status_id=<id>


Returns:

Code: Select all

{
  "status":1,
  "job_status":0
}

Request success: status = 1
Request failed: status = 0

job_status:
added = 0
processing = 1
completed = 2
deleted = 3


If job completed will contain job report:

Code: Select all

{
  "status":1,
  "job_status":2,
   "action_status":2,
   "report":<json>,
   "date":time_stamp_job_added
   "date_started":time_stamp_job_started_processing
   "date_finished:time_stamp_job_completed
}

action_status
failed = 0
cancelled = 1
completed = 2


report json:

Code: Select all

{
  "Success": [<list_profiles>],
  "Failed":[<list_profiles>],
  "Ignored":[<list_profiles>],
}

Reply report json:

Code: Select all

{
  "Success": [<list_profiles>],
  "Failed":[<list_profiles>],
  "Ignored":[<list_profiles>],
  "Posted":{"<username>":[<list_posted_tweet_urls>],...}
}

Posted is a dictionary mapping usernames to a list of posted urls

[martin@rootjazz]

Delete job

API URL:
https://rootjazz.com/api/api.php

Added job can be deleted if it has not started processing


POST
type=delete
auth=<your_license_key>
delete_id=<id>


Returns:

Code: Select all

{
  "status":1,
  "job_status":3
}

If status=0, no job status will be present, job was not deleted

[martin@rootjazz]

<locked>

For help with Mass Web Api, please create a new thread