Debian Code Search API keys
Our API keys encode an (encrypted) identity, which makes all API requests programmatically identifiable. This makes Debian Code Search more available:
- When the service would otherwise be overwhelmed by requests, instead of turning off the entire API, we can throttle or reject only requests coming in with an individual API key.
- Because the keys are personalized, we can reach out to the right person and resolve any issues as quickly as possible.
After you log in via the salsa.debian.org GitLab instance,
you will see a personal API key file for download here.
If you need a non-personal API key for a CLI tool, web service, etc.,
please reach out to email@example.com.
The Debian Code Search API is described in an OpenAPI specification (OAS),
which you can use with various Swagger tools:
- a standalone version of the Swagger UI documentation browser
the editor.swagger.io online editor
Allows 1-click code generation for many programming languages!
- the ReDoc online documentation browser
- the MrinDoc online documentation browser
- The Restish CLI
- the Swagger Codegen program
- …and many others, as listed at OpenAPI.Tools
For your convenience, here is an embedded Swagger UI documentation browser:
This table lists all available Debian Code Search OpenAPI spec URLs:
For new developments, if supported in your environment, prefer using OpenAPI 3 in either YAML (hand-written) or JSON (automatically converted).
OpenAPI 2 is our canonical spec because one can derive OpenAPI 3 from it, but the other way around is not possible. As of September 2020, it is worthwhile to keep OpenAPI 2 around because some tools offer broader compatibility with it.