Search the model numbers, SKUs and product names of a CSAF provider's advisories
const url = 'https://example.com/v1/orgs/example/csaf-products?kind=model_number&limit=50';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/v1/orgs/example/csaf-products?kind=model_number&limit=50' \ --header 'Authorization: Bearer <token>'For picking a CSAF product mapping’s value. providers lists the CSAF providers whose advisories are loaded; without provider, items is empty. items are the values of the provider’s known_affected and fixed products in advisories not withdrawn, each once, as a mapping stores it (value) and as an advisory spells it (label), in byte order of kind and value; next is the after= of the next page. Feed data, the same for every organization.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization (tenant) slug, e.g. alpenrobotik
Query Parameters
Section titled “Query Parameters”A provider’s slug, e.g. siemens
What of a CSAF product the value names
A part of the value
The next of the previous page
Responses
Section titled “Responses”A page
object
object
object
What of a CSAF product the value names
As a mapping stores it: trimmed, lower case, single spaces
As an advisory spells it
The vendor of a product with this value
The name of a product with this value (for product_name, the value itself)
Advisories naming the value
The after of the next page; absent on the last
Example
{ "providers": [ { "publisher": "vendor" } ], "items": [ { "kind": "model_number" } ]}Mapping.csafProviderUnknown, mapping.csafKindInvalid, or request.invalid (params.field q, after or limit)
No such object in this organization, no such organization, or the caller does not belong to it
Over the operation’s rate-limit budget (x-affectra-budget): code request.rateLimited with params.budget. Wait Retry-After seconds before trying again.
Every error answer, Content-Type
application/problem+json. The web app and integrations translate code; detail is English,
for people reading curl output or CI logs, and may change wording at
any time. Match on code, never on detail.
object
The HTTP status
Stable error codes. A code is never renamed; new ones may be added, so
a client falls back to detail for a code it doesn’t know. Another
organization’s object answers notFound, the same as a missing one.
What went wrong
Values the code’s message needs, e.g. {“field”: “version”}. Only values the caller sent or may see. Empty when the message needs none.
object
Example
{ "code": "notFound"}Headers
Section titled “Headers”Seconds until a request would be allowed again, at least 1
The server runs without a database or object storage; the catalog is unavailable