API

API JSON b'xejn, għall-qari biss, għad-direttorju ppubblikat. M'hemmx bżonn ta' ċavetta.

Bidu malajr

Kull prodott fid-direttorju, f'talba waħda:

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

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

Liema nuża?

Fajls snapshot: b'xejn, jinqraw minn kull sit, jinbnew mill-ġdid kull lejl, mingħajr limiti. Għall-browsers u xogħlijiet bid-direttorju kollu.
API live: għas-server tiegħek, madwar 60 talba fil-minuta għal kull indirizz IP. Għal prodott wieħed kull darba u data aktar friska.

Fajls snapshot

Id-direttorju ppubblikat bħala fajls JSON statiċi, mibnija mill-ġdid kull lejl. Jinkitbu mill-ġdid biss il-fajls li jinbidlu, u l-ebda wieħed minnhom ma jgħodd għal limitu.

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

Array ta' prodotti, ordnati skont l-id tal-kategorija u mbagħad skont l-id. L-istess JSON bħal GET /api/software.

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

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

Array ta' ismijiet ta' pajjiżi, kull wieħed darba, fl-ordni tad-direttorju (mhux issortjat). L-istess JSON bħal GET /api/software/countries.

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

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

Oġġett mill-id tal-kategorija għan-numru ta' prodotti. Kategoriji mingħajr prodotti jitħallew barra. L-istess JSON bħal GET /api/categories/counts.

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

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

Għodod magħrufa, kull waħda bl-ids tal-prodotti magħmula għall-istess xogħol, bħal fuq il-paġni tal-għodod.

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

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

Meta saru l-fajls, kemm-il oġġett għandu kull wieħed, id-daqs u l-SHA-256 tagħhom, u t-termini.

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

Minn paġna web:

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

Endpoints

Kull endpoint iwieġeb GET b'JSON. It-tweġibiet tal-eżempji huma veri iżda mqassra.

GET /api/software

Array ta' prodotti, ordnati skont l-id tal-kategorija u mbagħad skont l-id.

Parametri: Xejn
Eżempju: curl https://www.euromakers.org/api/software
Tweġiba: [ { "id": "proton-mail", "name": "Proton Mail", "description": "End-to-end encrypted email from Switzerland.", … }, … ]
Żbalji: 429 · 500 · 503
Cache: Jinżamm fit-tarf tan-netwerk sa 24 siegħa u jitħassar meta d-direttorju jinbidel. s-maxage=86400

GET /api/software/{id}

Prodott wieħed. Id mhux magħruf jew mhux ippubblikat jagħti 404.

Parametri: id · string · path · meħtieġL-id tal-prodott: ittri żgħar, ċifri u sinjali ta' unjoni. ^[a-z0-9-]{1,80}$
Eżempju: curl https://www.euromakers.org/api/software/proton-mail
Tweġiba: { "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" }
Żbalji: 404 · 429 · 500
Cache: Jinżamm fit-tarf tan-netwerk sa 24 siegħa u jitħassar meta d-direttorju jinbidel. s-maxage=86400

GET /api/software/countries

Array ta' ismijiet ta' pajjiżi, kull wieħed darba, fl-ordni tad-direttorju (mhux issortjat).

Parametri: Xejn
Eżempju: curl https://www.euromakers.org/api/software/countries
Tweġiba: ["Germany", "France", "Slovakia", "…"]
Żbalji: 429 · 500 · 503
Cache: Jinżamm fit-tarf tan-netwerk sa 24 siegħa u jitħassar meta d-direttorju jinbidel. s-maxage=86400

GET /api/categories/counts

Oġġett mill-id tal-kategorija għan-numru ta' prodotti. Kategoriji mingħajr prodotti jitħallew barra.

Parametri: Xejn
Eżempju: curl https://www.euromakers.org/api/categories/counts
Tweġiba: { "artificial-intelligence": 13, "cloud": 16, "communication": 14 }
Żbalji: 429 · 500 · 503
Cache: Jinżamm fit-tarf tan-netwerk sa 24 siegħa u jitħassar meta d-direttorju jinbidel. s-maxage=86400

Prodott

Kull prodott għandu dawn l-oqsma. Dawk mhux obbligatorji jitħallew barra meta jkunu vojta.

id · string: Id stabbli, ukoll it-tmiem tal-indirizz tal-paġna tal-prodott.
name · string: Isem il-prodott.
description · string: Deskrizzjoni f'sentenza waħda.
audience · string[]: Għal min hu: b2b, individual jew it-tnejn.
country · string: Pajjiż tal-oriġini.
website · uri: Is-sit web tal-prodott.
longDescription · string: Ftit paragrafi dwar il-prodott.
features · string[]: Karatteristiċi ewlenin.
useCases · string[]: Minn id wieħed sa erba' ids ta' użu.
category · string: Id tal-kategorija, bħal f'/categories/{id}.
verified · boolean: mhux obbligatorju · true meta min jagħmlu kkonferma s-sjieda; inkella nieqes.
logoUrl · uri: mhux obbligatorju · Logo (PNG, JPEG jew WebP); nieqes meta ma jkunx hemm.

L-istess bħala tipi 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[];
}

Żbalji

L-iżbalji huma JSON b'messaġġ, kodiċi stabbli u ħjiel:

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

Status	Kodiċi	Meta
404	`not_found`	Id mhux magħruf, jew l-ebda endpoint f'dak il-path.
429	`rate_limited`	Il-limitu tat-talbiet inqabeż.
500	`internal_error`	Xi ħaġa ma ħadmitx min-naħa tagħna.
503	`catalog_unavailable`	Id-direttorju ma setax jitgħabba.

Limiti tat-talbiet

60 talba kull 60 sekonda għal kull indirizz IP, maqsuma bejn l-endpoints kollha, inklużi t-tweġibiet mill-cache. Fuq il-limitu tieħu 429 bl-headers Retry-After (f'sekondi) u X-RateLimit-Limit. Meta l-API kollha tkun għaddejja ħafna xogħol, tista' twieġeb 429 qabel ma tilħaq il-limitu tiegħek.

Użu ġust: jekk għandek bżonn aktar, uża l-fajls snapshot.

Talbiet kondizzjonali

Kull tweġiba għandha ETag. Ibagħtu lura f'If-None-Match, u tweġiba li ma nbidlitx tkun 304 mingħajr kontenut.

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

CORS

L-API live ma tibgħatx headers CORS, allura browser fuq sit ieħor ma jistax jaqraha. F'browser, uża l-fajls snapshot: kull sit jista' jaqrahom.

Verżjonijiet

Din hija l-verżjoni 1 tal-API u tal-fajls snapshot. Aħna nżidu biss: l-ebda path, field jew tip ma jinbidel jew jisparixxi. Bidla inkompatibbli tasal bħala verżjoni ġdida ħdejn din.

Użu u attribuzzjoni

L-API huwa b'xejn għal kull użu. Poġġi link lura għal EuroMakers fejn turi d-data tiegħu. Il-logos huma ta' min jagħmilhom, u d-direttorju ma jistax jerġa' jinbiegħ bl-ingrossa.

Termini tas-servizz

Għall-magni

/openapi.json · Deskrizzjoni OpenAPI 3.1 ta' kull endpoint
/llms.txt · Sommarju tas-sit għall-mudelli tal-lingwa
https://data.euromakers.org/v1/manifest.json · Meta saru l-fajls, kemm-il oġġett għandu kull wieħed, id-daqs u l-SHA-256 tagħhom, u t-termini.