API

Bezmaksas JSON API tikai lasīšanai publicētajam katalogam. Atslēga nav vajadzīga.

Ātrais sākums

Visi kataloga produkti vienā pieprasījumā:

curl https://www.euromakers.org/api/software

[
  {
    "id": "proton-mail",
    "name": "Proton Mail",
    "description": "End-to-end encrypted email from Switzerland.",
    …
  },
  …
]

Ko izmantot?

Momentuzņēmuma faili: bez maksas, nolasāmi no jebkuras vietnes, katru nakti veidoti no jauna, bez ierobežojumiem. Pārlūkiem un darbiem ar visu katalogu.
Tiešsaistes API: tavam serverim, aptuveni 60 pieprasījumi minūtē katrai IP adresei. Pa vienam produktam un svaigākiem datiem.

Momentuzņēmuma faili

Publicētais katalogs statisku JSON failu veidā, katru nakti veidots no jauna. Pārrakstīti tiek tikai mainītie faili, un neviens no tiem neskaitās ierobežojumā.

https://data.euromakers.org/v1/software.json

Produktu masīvs, sakārtots pēc kategorijas id un tad pēc id. Tas pats JSON, kas GET /api/software.

[
  {
    "id": "proton-mail",
    "name": "Proton Mail",
    "description": "End-to-end encrypted email from Switzerland.",
    …
  },
  …
]

https://data.euromakers.org/v1/countries.json

Valstu nosaukumu masīvs, katrs vienu reizi, kataloga secībā (nesakārtots). Tas pats JSON, kas GET /api/software/countries.

["Germany", "France", "Slovakia", "…"]

https://data.euromakers.org/v1/categories.json

Objekts no kategorijas id uz produktu skaitu. Kategorijas bez produktiem tiek izlaistas. Tas pats JSON, kas GET /api/categories/counts.

{
  "artificial-intelligence": 13,
  "cloud": 16,
  "communication": 14
}

https://data.euromakers.org/v1/alternatives.json

Pazīstami rīki, katrs ar to produktu id, kas veidoti tam pašam darbam, kā rīku lapās.

[
  {
    "tool": "slack",
    "name": "Slack",
    "page": "https://www.euromakers.org/alternatives/slack",
    "ids": ["element", "rocket-chat", "…"]
  }
]

https://data.euromakers.org/v1/manifest.json

Kad faili izveidoti, cik ierakstu ir katrā, to izmērs un SHA-256, kā arī noteikumi.

{
  "version": "v1",
  "generatedAt": "2026-11-12T22:05:00.000Z",
  "docs": "https://www.euromakers.org/developers",
  "license": "Free for any use. Logos belong to their makers, and the directory can’t be resold in bulk.",
  "attribution": "Link back to EuroMakers (https://www.euromakers.org) where you show this data.",
  "terms": "https://www.euromakers.org/terms",
  "files": [
    {
      "name": "software.json",
      "url": "https://data.euromakers.org/v1/software.json",
      "items": "…",
      "bytes": "…",
      "sha256": "…"
    },
    "…"
  ]
}

No tīmekļa lapas:

const response = await fetch("https://data.euromakers.org/v1/software.json");
const products = await response.json();

Galapunkti

Katrs galapunkts atbild uz GET ar JSON. Atbilžu piemēri ir īsti, bet saīsināti.

GET /api/software

Produktu masīvs, sakārtots pēc kategorijas id un tad pēc id.

Parametri: Nav
Piemērs: curl https://www.euromakers.org/api/software
Atbilde: [ { "id": "proton-mail", "name": "Proton Mail", "description": "End-to-end encrypted email from Switzerland.", … }, … ]
Kļūdas: 429 · 500 · 503
Kešatmiņa: Glabāta malas serveros līdz 24 stundām un notīrīta, kad katalogs mainās. s-maxage=86400

GET /api/software/{id}

Viens produkts. Nezināms vai nepublicēts id dod 404.

Parametri: id · string · path · obligātsProdukta id: mazie burti, cipari un defises. ^[a-z0-9-]{1,80}$
Piemērs: curl https://www.euromakers.org/api/software/proton-mail
Atbilde: { "id": "proton-mail", "name": "Proton Mail", "description": "End-to-end encrypted email from Switzerland.", "audience": ["b2b", "individual"], "country": "Switzerland", "website": "https://proton.me/mail", "longDescription": "Proton Mail is the flagship encrypted email …", "features": ["End-to-end encrypted email", "…"], "useCases": ["business-email"], "category": "communication" }
Kļūdas: 404 · 429 · 500
Kešatmiņa: Glabāta malas serveros līdz 24 stundām un notīrīta, kad katalogs mainās. s-maxage=86400

GET /api/software/countries

Valstu nosaukumu masīvs, katrs vienu reizi, kataloga secībā (nesakārtots).

Parametri: Nav
Piemērs: curl https://www.euromakers.org/api/software/countries
Atbilde: ["Germany", "France", "Slovakia", "…"]
Kļūdas: 429 · 500 · 503
Kešatmiņa: Glabāta malas serveros līdz 24 stundām un notīrīta, kad katalogs mainās. s-maxage=86400

GET /api/categories/counts

Objekts no kategorijas id uz produktu skaitu. Kategorijas bez produktiem tiek izlaistas.

Parametri: Nav
Piemērs: curl https://www.euromakers.org/api/categories/counts
Atbilde: { "artificial-intelligence": 13, "cloud": 16, "communication": 14 }
Kļūdas: 429 · 500 · 503
Kešatmiņa: Glabāta malas serveros līdz 24 stundām un notīrīta, kad katalogs mainās. s-maxage=86400

Produkts

Katram produktam ir šie lauki. Neobligātie tiek izlaisti, ja ir tukši.

id · string: Nemainīgs id, arī produkta lapas adreses beigas.
name · string: Produkta nosaukums.
description · string: Apraksts vienā teikumā.
audience · string[]: Kam tas paredzēts: b2b, individual vai abiem.
country · string: Izcelsmes valsts.
website · uri: Produkta vietne.
longDescription · string: Dažas rindkopas par produktu.
features · string[]: Galvenās funkcijas.
useCases · string[]: No viena līdz četriem lietojuma gadījumu id.
category · string: Kategorijas id, kā /categories/{id}.
verified · boolean: neobligāts · true, ja veidotājs ir apstiprinājis īpašumtiesības; citādi lauka nav.
logoUrl · uri: neobligāts · Logotips (PNG, JPEG vai WebP); lauka nav, ja logotipa nav.

Tas pats kā TypeScript tipi:

export interface Software {
  /** Stable id, also the end of the product’s page address. */
  id: string;
  /** Product name. */
  name: string;
  /** One-sentence description. */
  description: string;
  /** Who it’s for: b2b, individual or both. */
  audience: ("b2b" | "individual")[];
  /** Country of origin. */
  country: string;
  /** The product’s website. */
  website: string;
  /** A few paragraphs about the product. */
  longDescription: string;
  /** Main features. */
  features: string[];
  /** One to four use-case ids. */
  useCases: string[];
  /** Category id, as in /categories/{id}. */
  category: string;
  /** true when the maker verified ownership; absent otherwise. */
  verified?: true;
  /** Logo (PNG, JPEG or WebP); absent when there is none. */
  logoUrl?: string;
}

/** countries.json, GET /api/software/countries */
export type Countries = string[];

/** categories.json, GET /api/categories/counts */
export type CategoryCounts = Record<string, number>;

/** One entry of alternatives.json */
export interface Alternative {
  tool: string;
  name: string;
  page: string;
  ids: string[];
}

Kļūdas

Kļūdas ir JSON ar ziņojumu, nemainīgu kodu un padomu:

{
  "code": "not_found",
  "error": "Software not found",
  "hint": "List known ids with GET /api/software, then retry with an existing kebab-case id."
}

Statuss	Kods	Kad
404	`not_found`	Nezināms id vai šajā ceļā nav galapunkta.
429	`rate_limited`	Pārsniegts pieprasījumu ierobežojums.
500	`internal_error`	Mūsu pusē kaut kas nogāja greizi.
503	`catalog_unavailable`	Katalogu neizdevās ielādēt.

Pieprasījumu ierobežojumi

60 pieprasījumi 60 sekundēs katrai IP adresei, kopīgi visiem galapunktiem, ieskaitot atbildes no kešatmiņas. Pārsniedzot ierobežojumu, saņemsi 429 ar galvenēm Retry-After (sekundēs) un X-RateLimit-Limit. Ja API kopumā ir ļoti noslogots, tas var atbildēt ar 429, pirms esi sasniedzis savu ierobežojumu.

Godīga lietošana: ja vajag vairāk, izmanto momentuzņēmuma failus.

Nosacījuma pieprasījumi

Katrai atbildei ir ETag. Nosūti to atpakaļ galvenē If-None-Match, un nemainīta atbilde būs 304 bez satura.

curl -i https://www.euromakers.org/api/software/proton-mail -H 'If-None-Match: "<ETag of the last answer>"'

CORS

Tiešsaistes API nesūta CORS galvenes, tāpēc pārlūks citā vietnē to nevar nolasīt. Pārlūkā izmanto momentuzņēmuma failus: tos drīkst lasīt jebkura vietne.

Versijas

Šī ir API un momentuzņēmuma failu 1. versija. Mēs tikai papildinām: neviens ceļš, lauks vai tips nemainās un nepazūd. Nesaderīgas izmaiņas nāktu kā jauna versija blakus šai.

Lietošana un atsauce

API ir bezmaksas jebkādai lietošanai. Ievieto saiti uz EuroMakers tur, kur rādi tā datus. Logotipi pieder to veidotājiem, un katalogu nedrīkst tālākpārdot vairumā.

Lietošanas noteikumi

Mašīnlasāms

/openapi.json · Katra galapunkta OpenAPI 3.1 apraksts
/llms.txt · Vietnes kopsavilkums valodu modeļiem
https://data.euromakers.org/v1/manifest.json · Kad faili izveidoti, cik ierakstu ir katrā, to izmērs un SHA-256, kā arī noteikumi.