API

API JSON saor in aisce, inléite amháin, don eolaire foilsithe. Níl eochair ag teastáil.

Tús tapa

Gach táirge san eolaire, in aon iarratas amháin:

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

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

Cé acu ba cheart dom a úsáid?

Comhaid snapshot: saor in aisce, inléite ó aon suíomh, atógtha gach oíche, gan teorainneacha. Do bhrabhsálaithe agus do jabanna leis an eolaire ar fad.
API beo: do do fhreastalaí, timpeall 60 iarratas sa nóiméad do gach seoladh IP. Do tháirge amháin ag an am agus sonraí níos úire.

Comhaid snapshot

An t-eolaire foilsithe mar chomhaid JSON statacha, atógtha gach oíche. Ní athscríobhtar ach na comhaid a athraíonn, agus ní áirítear aon cheann acu i dteorainn.

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

Eagar táirgí, in ord de réir id na catagóire agus ansin de réir id. An JSON céanna le GET /api/software.

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

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

Eagar d’ainmneacha tíortha, gach ceann uair amháin, in ord an eolaire (gan sórtáil). An JSON céanna le GET /api/software/countries.

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

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

Réad ó id catagóire go líon na dtáirgí. Fágtar catagóirí gan táirgí amach. An JSON céanna le GET /api/categories/counts.

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

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

Uirlisí aitheanta, gach ceann acu le haitheantais na dtáirgí a rinneadh don obair chéanna, mar atá ar leathanaigh na n-uirlisí.

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

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

Cathain a rinneadh na comhaid, cé mhéad mír atá i ngach ceann, a méid agus a SHA-256, agus na téarmaí.

{
  "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": "…"
    },
    "…"
  ]
}

Ó leathanach gréasáin:

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

Críochphointí

Freagraíonn gach críochphointe GET le JSON. Is freagraí fíora iad na samplaí, ach giorraithe.

GET /api/software

Eagar táirgí, in ord de réir id na catagóire agus ansin de réir id.

Paraiméadair: Níl aon cheann
Sampla: curl https://www.euromakers.org/api/software
Freagra: [ { "id": "proton-mail", "name": "Proton Mail", "description": "End-to-end encrypted email from Switzerland.", … }, … ]
Earráidí: 429 · 500 · 503
Taisce: Coinnítear é ar imeall an líonra ar feadh suas le 24 uair an chloig agus glantar é nuair a athraíonn an t-eolaire. s-maxage=86400

GET /api/software/{id}

Táirge amháin. Is 404 é id anaithnid nó neamhfhoilsithe.

Paraiméadair: id · string · path · riachtanachId an táirge: litreacha beaga, digití agus fleiscíní. ^[a-z0-9-]{1,80}$
Sampla: curl https://www.euromakers.org/api/software/proton-mail
Freagra: { "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" }
Earráidí: 404 · 429 · 500
Taisce: Coinnítear é ar imeall an líonra ar feadh suas le 24 uair an chloig agus glantar é nuair a athraíonn an t-eolaire. s-maxage=86400

GET /api/software/countries

Eagar d’ainmneacha tíortha, gach ceann uair amháin, in ord an eolaire (gan sórtáil).

Paraiméadair: Níl aon cheann
Sampla: curl https://www.euromakers.org/api/software/countries
Freagra: ["Germany", "France", "Slovakia", "…"]
Earráidí: 429 · 500 · 503
Taisce: Coinnítear é ar imeall an líonra ar feadh suas le 24 uair an chloig agus glantar é nuair a athraíonn an t-eolaire. s-maxage=86400

GET /api/categories/counts

Réad ó id catagóire go líon na dtáirgí. Fágtar catagóirí gan táirgí amach.

Paraiméadair: Níl aon cheann
Sampla: curl https://www.euromakers.org/api/categories/counts
Freagra: { "artificial-intelligence": 13, "cloud": 16, "communication": 14 }
Earráidí: 429 · 500 · 503
Taisce: Coinnítear é ar imeall an líonra ar feadh suas le 24 uair an chloig agus glantar é nuair a athraíonn an t-eolaire. s-maxage=86400

Táirge

Tá na réimsí seo ag gach táirge. Fágtar na cinn roghnacha amach nuair atá siad folamh.

id · string: Id seasmhach, agus deireadh sheoladh leathanach an táirge freisin.
name · string: Ainm an táirge.
description · string: Cur síos in aon abairt amháin.
audience · string[]: Cé dó é: b2b, individual nó an dá cheann.
country · string: Tír thionscnaimh.
website · uri: Suíomh gréasáin an táirge.
longDescription · string: Cúpla alt faoin táirge.
features · string[]: Príomhghnéithe.
useCases · string[]: Idir id amháin agus ceithre id úsáide.
category · string: Id na catagóire, mar atá in /categories/{id}.
verified · boolean: roghnach · true nuair a dhearbhaigh an déantóir úinéireacht; as láthair murach sin.
logoUrl · uri: roghnach · Lógó (PNG, JPEG nó WebP); as láthair nuair nach bhfuil ceann ann.

An rud céanna mar chineálacha TypeScript:

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[];
}

Earráidí

Is JSON iad na hearráidí le teachtaireacht, cód seasmhach agus leid:

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

Stádas	Cód	Cathain
404	`not_found`	Id anaithnid, nó níl críochphointe ag an gcosán sin.
429	`rate_limited`	Sáraíodh an teorainn iarratas.
500	`internal_error`	Theip ar rud éigin ar ár dtaobh.
503	`catalog_unavailable`	Níorbh fhéidir an t-eolaire a lódáil.

Teorainneacha iarratas

60 iarratas in aghaidh 60 soicind do gach seoladh IP, roinnte ag gach críochphointe, freagraí ón taisce san áireamh. Thar an teorainn, faigheann tú 429 leis na ceanntáisc Retry-After (i soicindí) agus X-RateLimit-Limit. Nuair a bhíonn an API ina iomláine an-ghnóthach, féadfaidh sé 429 a thabhairt sula sroicheann tú do theorainn féin.

Úsáid chothrom: má theastaíonn níos mó uait, úsáid na comhaid snapshot.

Iarratais choinníollacha

Tá ETag ar gach freagra. Seol ar ais é in If-None-Match, agus is 304 gan chorp é freagra nár athraigh.

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

CORS

Ní sheolann an API beo ceanntáisc CORS, mar sin ní féidir le brabhsálaí ar shuíomh eile é a léamh. I mbrabhsálaí, úsáid na comhaid snapshot: is féidir le haon suíomh iad a léamh.

Leaganacha

Seo leagan 1 den API agus de na comhaid snapshot. Ní dhéanaimid ach cur leis: ní athraíonn ná ní imíonn aon chosán, réimse ná cineál. Thiocfadh athrú neamh-chomhoiriúnach mar leagan nua in aice leis an gceann seo.

Úsáid agus aitreabúideacht

Tá an API saor in aisce d’aon úsáid. Cuir nasc ar ais chuig EuroMakers áit a dtaispeánann tú a chuid sonraí. Is lena ndéantóirí na lógónna, agus ní féidir an t-eolaire a athdhíol ar an mórchóir.

Téarmaí seirbhíse

Inléite ag meaisín

/openapi.json · Cur síos OpenAPI 3.1 ar gach críochphointe
/llms.txt · Achoimre ar an suíomh do mhúnlaí teanga
https://data.euromakers.org/v1/manifest.json · Cathain a rinneadh na comhaid, cé mhéad mír atá i ngach ceann, a méid agus a SHA-256, agus na téarmaí.