xmlrpc-api-notes.txt

Fedora infrastructure depends on python-bugzilla in various ways:
http://lists.fedorahosted.org/pipermail/python-bugzilla/2012-June/000001.html

Red Hat bugzilla originally had a totally custom API. Much of that is
being dropped in 2013, API conversions outlined here:
https://bugzilla.redhat.com/show_bug.cgi?id=822007

Externally facing RH bugzilla instance that doesn't send email and is
refreshed periodically. This is what is used in the functional test suite:
http://partner-bugzilla.redhat.com

Some trackers in the wild to use for API testing:
    bugzilla.redhat.com
    bugzilla.mozilla.org
    bugzilla.kernel.org
    bugzilla.gnome.org
    bugs.freedesktop.org
    bugzilla.novell.com
    bugzilla.zimbra.com
    bugzilla.samba.org
    bugs.gentoo.org


  Upstream timeline
  =================

Here's a timeline of the evolution of the upstream bugzilla XMLRPC API:

Bugzilla 2.*:
    No XMLRPC API that I can tell

Bugzilla 3.0:
    http://www.bugzilla.org/docs/3.0/html/api/index.html
    Bug.legal_values
    Bug.get_bugs:
        returns: id, alias, summary, creation_time, last_change_time
    Bug.create
    Bugzilla.version
    Bugzilla.timezone
    Product.get_selectable_products
    Product.get_enterable_products
    Product.get_accessible_products
    Product.get_products
    User.login
    User.logout
    User.offer_account_by_email
    User.create

Bugzilla 3.2:
    http://www.bugzilla.org/docs/3.2/en/html/api/
    Bug: RENAME: get_bugs->get, get_bugs should still work
    Bug.add_comment
    Bugzilla.extensions
    Product: RENAME: get_products->get, get_products should still work

Bugzilla 3.4:
    http://www.bugzilla.org/docs/3.4/en/html/api/
    Bug.comments
    Bug.history
    Bug.search
    Bug.update_see_also
    Bugzilla.time
    Bugzilla: DEPRECATED: timezone, use time instead
    User.get
    Util.filter_fields
    Util.validate

Bugzilla 3.6:
    http://www.bugzilla.org/docs/3.6/en/html/api/
    Bug.attachments
    Bug.fields
    Bug: DEPRECATED: legal_values
    Bugzilla: timezone now always returns UTC+0000

Bugzilla 4.0:
    http://www.bugzilla.org/docs/4.0/en/html/api/
    Bug.add_attachment
    Bug.update
    Util.filter_wants

Bugzilla 4.2:
    http://www.bugzilla.org/docs/4.2/en/html/api/
    Group.create
    Product.create

Bugzilla 4.4:
    http://www.bugzilla.org/docs/4.4/en/html/api/
    Bug.update_tags
    Bugzilla.parameters
    Bugzilla.last_audit_time
    Classification.get
    Group.update
    Product.update
    User.update
    Util.translate
    Util.params_to_objects

Bugzilla 5.0: (July 2015)
    https://www.bugzilla.org/docs/5.0/en/html/integrating/api/index.html
    Bug.update_attachment
    Bug.search/update_comment_tags
    Bug.search:
        search() now supports --from-url style, like rhbz before it
        search() now supports quicksearch
    Bug.update:
        update() alias is now a hash of add/remove/set, but has back compat
        update() can take 'flags' config now
    Component (new, or newly documented?)
    Component.create
    User.valid_login

Bugzilla latest/tip:
    https://bugzilla.readthedocs.io/en/latest/api/index.html


Redhat Bugzilla: 4.4 based with extensions. Bits on top of 4.4
    https://bugzilla.redhat.com/docs/en/html/api/
    Bug.search has --from-url extension
    Bug.update has more hashing support
    extra_fields for fetching comments, attachments, etc at Bug.get time
    ExternalBugs extension: https://bugzilla.redhat.com/docs/en/html/api/extensions/ExternalBugs/lib/WebService.html