Diff for "API"

Not logged in - Log In / Register

Differences between revisions 6 and 41 (spanning 35 versions)
Revision 6 as of 2008-07-31 16:59:35
Size: 866
Editor: cpe-24-193-113-134
Comment:
Revision 41 as of 2023-07-06 08:24:58
Size: 2363
Editor: ines-almeida
Comment: Fix APi reference link
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#acl AdminGroup:read,write All:read
Line 5: Line 3:
The Launchpad website lets you learn about and manage bugs, projects, questions, and other artifacts of software development. These same objects are gradually being exposed through a web service, so that you can access them from scripts, applications, or other websites, in addition to accessing them through the Launchpad website. ''Note: This page discusses the Launchpad web service API from the perspective of developer wanting to use the API. If you want to help develop the API, see the [[https://dev.launchpad.net/API|Launchpad dev wiki]] instead. If you would like to find or share hints on being an end-user of a launchpadlib-based application, see [[/EndUserHints]]. If you're looking for the _internal_ API documentation, see http://people.canonical.com/~mwh/canonicalapi/''
Line 7: Line 5:
The Launchpad web service is currently in a limited beta, open to Launchpad's beta testers. The Launchpad website lets you learn about and manage bugs, projects, questions, and other artefacts of software development. These same objects are gradually being exposed through a web service, so that you can access them from scripts, applications, or other websites, in addition to accessing them through the Launchpad website. The service is designed around the principles of REST, with the goals of simplicity and transparency.
Line 9: Line 7:
Most users will be happy with [[API/launchpadlib| launchpadlib]], the official Python client library for Launchpad's web service.  * If you're the end-user of an application like Ground Control, you don't need to know about the API at all: you just need to know [[API/ThirdPartyIntegration|how to integrate your Launchpad account with a third-party application]].
Line 11: Line 9:
Users who aren't Python programmers, or who are interested in the inner workings of the web service, should read [[API/Hacking| the hacking document]].  * [[API/launchpadlib|launchpadlib]] is the official Python client library for Launchpad's web service.
Line 13: Line 11:
Everyone will appreciate the reference documentation. (link forthcoming) {{{
   >>> me = launchpad.me
   >>> me.display_name = 'My new display name'
   >>> me.lp_save()
}}}

 * Developers who aren't Python programmers, or who are interested in the inner workings of the web service, should read [[API/Hacking| the hacking document]].

{{{
   PATCH /beta/+me HTTP/1.1
   Host: api.launchpad.net
   Content-type: application/json

   { "display_name" : "My new display name" }
}}}

 * See our directory of [[Clients|clients]] and [[API/Uses|code that uses the Launchpad APIs]] for examples. Also, we have a page of [[API/Examples|example code]].

 * If you're writing your own interface to Launchpad, instead of using launchpadlib, you'll need to know how [[http://oauth.net/| OAuth]] works. [[API/SigningRequests| Signing Requests]] explains how to walk your end-users through the process of getting a set of OAuth credentials that you can use to make Launchpad web service requests on their behalf.

 * The [[http://launchpad.net/+apidoc/|reference documentation]] describes every published object and operation in a language-neutral form.

Launchpad web services API

Note: This page discusses the Launchpad web service API from the perspective of developer wanting to use the API. If you want to help develop the API, see the Launchpad dev wiki instead. If you would like to find or share hints on being an end-user of a launchpadlib-based application, see /EndUserHints. If you're looking for the _internal_ API documentation, see http://people.canonical.com/~mwh/canonicalapi/

The Launchpad website lets you learn about and manage bugs, projects, questions, and other artefacts of software development. These same objects are gradually being exposed through a web service, so that you can access them from scripts, applications, or other websites, in addition to accessing them through the Launchpad website. The service is designed around the principles of REST, with the goals of simplicity and transparency.

   >>> me = launchpad.me
   >>> me.display_name = 'My new display name'
   >>> me.lp_save()
  • Developers who aren't Python programmers, or who are interested in the inner workings of the web service, should read the hacking document.

   PATCH /beta/+me HTTP/1.1
   Host: api.launchpad.net
   Content-type: application/json

   { "display_name" : "My new display name" }
  • See our directory of clients and code that uses the Launchpad APIs for examples. Also, we have a page of example code.

  • If you're writing your own interface to Launchpad, instead of using launchpadlib, you'll need to know how OAuth works. Signing Requests explains how to walk your end-users through the process of getting a set of OAuth credentials that you can use to make Launchpad web service requests on their behalf.

  • The reference documentation describes every published object and operation in a language-neutral form.

API (last edited 2023-07-06 08:24:58 by ines-almeida)