CINXE.COM
Debtags
<!doctype html> <html lang="en"> <head> <!-- Required meta tags --> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> <link rel="stylesheet" href="/static/common/bootstrap4/css/bootstrap.min.css" /> <link rel="stylesheet" href="/static/common/fork-awesome/css/fork-awesome.css" /> <script src="/static/common/jquery/jquery.min.js"></script> <script src="/static/common/popper.js/umd/popper.min.js"></script> <script src="/static/common/bootstrap4/js/bootstrap.min.js"></script> <title>Debtags</title> <link rev="made" href="mailto:enrico@debian.org"> <meta name="Language" content="English"> <meta name="Author" content="Enrico Zini, enrico@debian.org"> <link type="text/css" rel="stylesheet" media="all" href="/static/css/debtags.css" /> </head> <body> <nav class="navbar navbar-expand-lg navbar-light bg-light"> <a class="navbar-brand" href="https://www.debian.org/"><img src="/static//debian/img/openlogo-50.png"></img></a> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarSupportedContent"> <ul class="navbar-nav mr-auto"> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> About Debtags </a> <div class="dropdown-menu" aria-labelledby="navbarDropdown"> <a class="dropdown-item" href="/">Main page</a> <a class="dropdown-item" href="https://wiki.debian.org/Debtags">Documentation</a> <a class="dropdown-item" href="https://wiki.debian.org/Debtags/FAQ">FAQ</a> <a class="dropdown-item" href="/statistics/">Statistics</a> </div> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Contribute </a> <div class="dropdown-menu" aria-labelledby="navbarDropdown"> <a class="dropdown-item" href="/getting-started/">Getting started</a> <a class="dropdown-item" href="/reports/todo/">TODO list</a> <a class="dropdown-item" href="/edit/">Tag editor</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/reports/">All reports</a> </div> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Develop </a> <div class="dropdown-menu" aria-labelledby="navbarDropdown"> <a class="dropdown-item" href="/api/">Site API</a> <a class="dropdown-item" href="/exports/">Export data</a> </div> </li> <li class="nav-item"> <a class="nav-link" href="/search/">Search</a> </li> </ul> <form name="begin" method="get" class="form-inline" action="/edit/"> <input type="text" name="pkg" id="pkg" class="form-control mr-2" placeholder="Package name"> <button type="submit" class="btn btn-primary">Tag</button> </form> <ul class="navbar-nav ml-2"> <li class="nav-item"> <a class="nav-link" href="/signon/login/"><span class="fa fa-sign-in"></span> Login</a> </li> </ul> </div> </nav> <div id="intro"> <p>This page document the site JSON APIs.</p> </div> <dl> <dt>/api/patch</dt> <dd> <p>POST a patch for the unreviewed tag database.</p> <p>There is only one required POST argument:</p> <dl> <dd>patch</dd> <dt>The tag patch, using the format of this example: <pre> pkg1: +tag1, +tag2, -tag3 pkg2: +tag1 pkg3: -tag2, -tag3 </pre> note that spaces are important: separators are "colon-space" and "comma-space"</dt> </dl> <p>The result is a JSON encoded dictionary as follows:</p> <pre> { pkgs: { pkg1: [tag1, tag2, tag3], pkg2: [tag2], pkg3: [tag1], } notes: [ "note about the patch" ] } </pre> <p>For each package involved in the submitted patch, there is an entry in <tt>pkgs</tt> with its new tags.</p> <p>If the server's consistency checks alter the patch before submission, string notes are added to <tt>notes</tt> to document what happened.</p> </dd> </dl> <div class="container-fluid"> <div class="row"> <div class="col"> <div class="card"> <div class="card-body"> <p>Copyright 漏 2011-2013 Enrico Zini <enrico@debian.org>. See <a href="/license/">license terms</a>. Source code is <a href="https://salsa.debian.org/debtags-team/debtagsd">available</a>.</p> <p>Debtags is part of <a href="https://www.debian.org/">Debian</a>.</p> </div> </div> </div> </div> </div> </body> </html>