launchpad help|
Size: 1469
Comment:
|
Size: 2336
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: |
| * 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]]. * Most users will be happy with [[API/launchpadlib|launchpadlib]], the official Python client library for Launchpad's web service. |
| Line 12: | Line 12: |
| >>> print launchpad.users['sabdfl'].display_name Mark Shuttleworth |
>>> me = launchpad.me >>> me.display_name = 'My new display name' >>> me.lp_save() |
| Line 20: | Line 21: |
| Host: api.edge.launchpad.net | Host: api.launchpad.net |
| Line 26: | Line 27: |
| {{{ 200 OK }}} |
* 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 30: | Line 29: |
| * If you're writing your own interface to Launchpad, 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. | * 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. |
| Line 32: | Line 31: |
| * 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.
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 how to integrate your Launchpad account with a third-party application.
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.
