API

Vsi izdelki v katalogu z eno zahtevo:

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

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

• Datoteke posnetka: brezplačne, berljive s katerega koli spletnega mesta, vsako noč znova zgrajene, brez omejitev. Za brskalnike in opravila s celotnim katalogom.
• API v živo: za vaš strežnik, približno 60 zahtev na minuto za vsak naslov IP. Za en izdelek naenkrat in svežejše podatke.

Objavljeni katalog kot statične datoteke JSON, vsako noč znova zgrajene. Znova se zapišejo samo spremenjene datoteke in nobena se ne šteje v omejitev.

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

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

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

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

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

S spletne strani:

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

Vsaka končna točka na GET odgovori z JSON. Primeri odgovorov so pravi, a skrajšani.

Vsak izdelek ima ta polja. Neobvezna so izpuščena, kadar so prazna.

id · string

Stalen id, hkrati konec naslova strani izdelka.

name · string

Ime izdelka.

description · string

Opis v enem stavku.

audience · string[]

Komu je namenjen: b2b, individual ali obojim.

country · string

Država izvora.

website · uri

Spletna stran izdelka.

longDescription · string

Nekaj odstavkov o izdelku.

features · string[]

Glavne funkcije.

useCases · string[]

Od enega do štirih id-jev primerov uporabe.

category · string

Id kategorije, kot v /categories/{id}.

verified · boolean

neobvezno · true, ko je ustvarjalec potrdil lastništvo; sicer polja ni.

logoUrl · uri

neobvezno · Logotip (PNG, JPEG ali WebP); polja ni, če logotipa ni.

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

Napake so JSON s sporočilom, stalno kodo in namigom:

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

60 zahtev na 60 sekund za vsak naslov IP, skupno za vse končne točke, vključno z odgovori iz predpomnilnika. Nad omejitvijo dobite 429 z glavama Retry-After (v sekundah) in X-RateLimit-Limit. Ko je API kot celota zelo obremenjen, lahko odgovori 429, še preden dosežete svojo omejitev.

Pošteno ravnanje: če potrebujete več, uporabite datoteke posnetka.

Vsak odgovor ima ETag. Pošljite ga nazaj v If-None-Match in nespremenjen odgovor bo 304 brez vsebine.

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

API v živo ne pošilja glav CORS, zato ga brskalnik na drugem spletnem mestu ne more prebrati. V brskalniku uporabite datoteke posnetka: bere jih lahko katero koli spletno mesto.

To je različica 1 API-ja in datotek posnetka. Samo dodajamo: nobena pot, polje ali tip se ne spremeni ali izgine. Nezdružljiva sprememba bi prišla kot nova različica poleg te.

API je brezplačen za vsako uporabo. Kjer prikazujete njegove podatke, dodajte povezavo na EuroMakers. Logotipi pripadajo njihovim ustvarjalcem, kataloga pa ni dovoljeno preprodajati v celoti.

Pogoji uporabe

• /openapi.json · Opis vseh končnih točk v OpenAPI 3.1
• /llms.txt · Povzetek spletnega mesta za jezikovne modele
• https://data.euromakers.org/v1/manifest.json · Kdaj so datoteke nastale, koliko vnosov ima vsaka, njihova velikost in SHA-256 ter pogoji.