Skip Navigation

Search TODO list Editor Statistics

This page document the site JSON APIs.

/api/patch

POST a patch for the unreviewed tag database.

There are two required POST arguments:

tag
An arbitrary string that identifies the patch. Multiple patches submitted with the same tag are correlated together later on, easing the work of reviewers.
patch
The tag patch, using the format of this example:
pkg1: +tag1, +tag2, -tag3
pkg2: +tag1
pkg3: -tag2, -tag3
        
note that spaces are important: separators are "colon-space" and "comma-space"

The result is a JSON encoded dictionary as follows:

{
    pkgs: {
        pkg1: [tag1, tag2, tag3],
        pkg2: [tag2],
        pkg3: [tag1],
    }
    notes: [
        "note about the patch"
    ]
}
    

For each package involved in the submitted patch, there is an entry in pkgs with its new tags.

If the server's consistency checks alter the patch before submission, string notes are added to notes to document what happened.