API

Nemokama, tik skaitymui skirta JSON API paskelbtam katalogui. Rakto nereikia.

Greita pradžia

Visi katalogo produktai vienu užklausimu:

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

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

Kurį naudoti?

Momentinės kopijos failai: nemokami, skaitomi iš bet kurios svetainės, perkuriami kiekvieną naktį, be ribų. Naršyklėms ir darbams su visu katalogu.
Tiesioginė API: jūsų serveriui, apie 60 užklausų per minutę kiekvienam IP adresui. Po vieną produktą ir šviežesniems duomenims.

Momentinės kopijos failai

Paskelbtas katalogas statiniais JSON failais, perkuriamais kiekvieną naktį. Perrašomi tik pasikeitę failai, ir nė vienas jų neįskaičiuojamas į ribą.

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

Produktų masyvas, surikiuotas pagal kategorijos id, paskui pagal id. Tas pats JSON kaip GET /api/software.

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

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

Šalių pavadinimų masyvas, kiekvienas po kartą, katalogo tvarka (nerikiuota). Tas pats JSON kaip GET /api/software/countries.

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

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

Objektas: kategorijos id ir produktų skaičius. Kategorijos be produktų praleidžiamos. Tas pats JSON kaip GET /api/categories/counts.

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

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

Žinomi įrankiai, kiekvienas su produktų, skirtų tam pačiam darbui, ID, kaip įrankių puslapiuose.

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

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

Kada failai sukurti, kiek įrašų kiekviename, jų dydis ir SHA-256 bei sąlygos.

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

Iš tinklalapio:

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

Galiniai taškai

Kiekvienas galinis taškas į GET atsako JSON formatu. Atsakymų pavyzdžiai tikri, bet sutrumpinti.

GET /api/software

Produktų masyvas, surikiuotas pagal kategorijos id, paskui pagal id.

Parametrai: Nėra
Pavyzdys: curl https://www.euromakers.org/api/software
Atsakymas: [ { "id": "proton-mail", "name": "Proton Mail", "description": "End-to-end encrypted email from Switzerland.", … }, … ]
Klaidos: 429 · 500 · 503
Podėlis: Laikoma kraštiniuose serveriuose iki 24 valandų ir išvaloma, kai katalogas pasikeičia. s-maxage=86400

GET /api/software/{id}

Vienas produktas. Nežinomas ar nepaskelbtas id grąžina 404.

Parametrai: id · string · path · privalomasProdukto id: mažosios raidės, skaitmenys ir brūkšneliai. ^[a-z0-9-]{1,80}$
Pavyzdys: curl https://www.euromakers.org/api/software/proton-mail
Atsakymas: { "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" }
Klaidos: 404 · 429 · 500
Podėlis: Laikoma kraštiniuose serveriuose iki 24 valandų ir išvaloma, kai katalogas pasikeičia. s-maxage=86400

GET /api/software/countries

Šalių pavadinimų masyvas, kiekvienas po kartą, katalogo tvarka (nerikiuota).

Parametrai: Nėra
Pavyzdys: curl https://www.euromakers.org/api/software/countries
Atsakymas: ["Germany", "France", "Slovakia", "…"]
Klaidos: 429 · 500 · 503
Podėlis: Laikoma kraštiniuose serveriuose iki 24 valandų ir išvaloma, kai katalogas pasikeičia. s-maxage=86400

GET /api/categories/counts

Objektas: kategorijos id ir produktų skaičius. Kategorijos be produktų praleidžiamos.

Parametrai: Nėra
Pavyzdys: curl https://www.euromakers.org/api/categories/counts
Atsakymas: { "artificial-intelligence": 13, "cloud": 16, "communication": 14 }
Klaidos: 429 · 500 · 503
Podėlis: Laikoma kraštiniuose serveriuose iki 24 valandų ir išvaloma, kai katalogas pasikeičia. s-maxage=86400

Produktas

Kiekvienas produktas turi šiuos laukus. Neprivalomi praleidžiami, kai tušti.

id · string: Pastovus id, kartu ir produkto puslapio adreso pabaiga.
name · string: Produkto pavadinimas.
description · string: Vieno sakinio aprašymas.
audience · string[]: Kam skirta: b2b, individual arba abiem.
country · string: Kilmės šalis.
website · uri: Produkto svetainė.
longDescription · string: Kelios pastraipos apie produktą.
features · string[]: Pagrindinės funkcijos.
useCases · string[]: Nuo vieno iki keturių naudojimo atvejų id.
category · string: Kategorijos id, kaip /categories/{id}.
verified · boolean: neprivalomas · true, kai kūrėjas patvirtino nuosavybę; kitaip lauko nėra.
logoUrl · uri: neprivalomas · Logotipas (PNG, JPEG arba WebP); lauko nėra, kai logotipo nėra.

Tas pats kaip TypeScript tipai:

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

Klaidos

Klaidos yra JSON su pranešimu, pastoviu kodu ir patarimu:

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

Būsena	Kodas	Kada
404	`not_found`	Nežinomas id arba šiuo keliu nėra galinio taško.
429	`rate_limited`	Viršyta užklausų riba.
500	`internal_error`	Mūsų pusėje kažkas nepavyko.
503	`catalog_unavailable`	Nepavyko įkelti katalogo.

Užklausų ribos

60 užklausų per 60 sekundžių kiekvienam IP adresui, bendra visiems galiniams taškams, įskaitant atsakymus iš talpyklos. Viršijus ribą gausite 429 su antraštėmis Retry-After (sekundėmis) ir X-RateLimit-Limit. Kai API apskritai labai apkrauta, ji gali atsakyti 429 dar prieš jums pasiekiant savo ribą.

Sąžiningas naudojimas: jei reikia daugiau, naudokite momentinės kopijos failus.

Sąlyginės užklausos

Kiekvienas atsakymas turi ETag. Grąžinkite jį antraštėje If-None-Match, ir nepasikeitęs atsakymas bus 304 be turinio.

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

CORS

Tiesioginė API nesiunčia CORS antraščių, todėl naršyklė kitoje svetainėje jos negali perskaityti. Naršyklėje naudokite momentinės kopijos failus: juos gali skaityti bet kuri svetainė.

Versijos

Tai API ir momentinės kopijos failų 1 versija. Mes tik pridedame: joks kelias, laukas ar tipas nesikeičia ir nedingsta. Nesuderinamas pakeitimas ateitų kaip nauja versija šalia šios.

Naudojimas ir šaltinio nurodymas

API nemokama bet kokiam naudojimui. Nurodykite nuorodą į EuroMakers ten, kur rodote jos duomenis. Logotipai priklauso jų kūrėjams, o katalogo negalima perparduoti dideliais kiekiais.

Naudojimo sąlygos

Mašininiu būdu nuskaitoma

/openapi.json · Kiekvieno galinio taško OpenAPI 3.1 aprašas
/llms.txt · Svetainės santrauka kalbos modeliams
https://data.euromakers.org/v1/manifest.json · Kada failai sukurti, kiek įrašų kiekviename, jų dydis ir SHA-256 bei sąlygos.