launchpad help|
Size: 1663
Comment:
|
Size: 2098
Comment:
|
| 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: |
| * When will the limited beta become an open beta? When will the open beta become a full release? The [[API/Roadmap| roadmap]] has the answers. * Most users will be happy with [[API/launchpadlib| launchpadlib]], the official Python client library for Launchpad's web service. |
* Most users will be happy with [[API/launchpadlib|launchpadlib]], the official Python client library for Launchpad's web service. |
| Line 14: | Line 10: |
| >>> me = launchpad.people['my-username'] | >>> me = launchpad.me |
| Line 23: | Line 19: |
| Host: api.edge.launchpad.net | Host: api.launchpad.net |
| Line 29: | Line 25: |
| * 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]]. |
|
| Line 31: | Line 29: |
| * Everyone will appreciate the reference documentation. (link forthcoming) | * Everyone can appreciate the [[http://launchpad.net/+apidoc|reference documentation]]. |
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.
Most users will be happy with launchpadlib, the official Python client library for Launchpad's web service.
>>> me = launchpad.me >>> me.display_name = 'My new display name' >>> me.lp_save()
Users 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.
Everyone can appreciate the reference documentation.
