Quick reposting

The QUICKREPOST method allows you to instantaneously repost data that is already in the system, and has successfully been previously posted to at least one destination. In the payload the job id has to be passed as a parameter to the job tag.

You can explicitly state which destinations you want to quick repost the data back to, or leave this blank - in which case the system will re-broadcast to all previous destinations.

This is an example payload for the QUICKREPOST request:

<?xml version="1.0" encoding="UTF-8"?>
<idibu>
  <method>quickrepost</method>
  <job id="31002766">
    <board id="10" />
    <board id="517" />
    <board id="520" />
    <board id="86" />
  </job>
</idibu>

Depending on the system configuration and the previous results of posting the job, you can get a response with mixed results:

<?xml version="1.0" encoding="UTF-8" ?>
<idibu>
 <JOB ID="31002766">
  <POST STATUS="FAILED" BOARDID="520" REASON="not-subscribed">This account is not subscribed to the stated board.</POST>
  <POST STATUS="PENDING" TYPE="ADD" QUICKREPOST="YES" BOARDID="10" QUEUEID="54263" PUBLISH="2011-02-25 16:00" DURATION="7" />
  <POST STATUS="FAILED" BOARDID="86" REASON="no-post">This job hasn't been previously succesfully posted to this board.</POST>
  <POST STATUS="FAILED" BOARDID="517" REASON="no-quota">The stated board has no quota available</POST>
 </JOB>
</idibu>

The different values for the REASON parameter and their meaning are in the example XML. It can happen that there are critical errors with the account or the job, in which case the result XML will be something like this:

<?xml version="1.0" encoding="UTF-8" ?>
<idibu>
 <JOB ID="31002766">
  <ERROR TYPE="credit">This is a pay-per-post account, and it has no credits left. Please ask your account administrator to contact idibu. Thanks.</ERROR>
  <ERROR TYPE="boards">There are no subscribed boards. Please contact your account administrator</ERROR>
  <ERROR TYPE="posts">No posts suitable for reposting were found for this job.</ERROR>
 </JOB>
</idibu>

All the different values for the type parameter are in the example XML.

When there's a critical error either with the account or the job, any combination of the 3 errors can be generated.

You can also cancel a pending job.