EasyAlgerie · Sviluppatori

API gratuita del dinaro algerino

Aggiungi tassi di cambio e conversioni del dinaro al tuo sito, alla tua app o a un agente IA. Risposte JSON semplici, senza account né chiave API.

Senza autenticazione
11 valute ↔ DZD
Sola lettura

La tua prima richiesta

Copia questo esempio nel terminale per convertire 100 euro in dinari al tasso indicativo di acquisto del mercato parallelo.

curl 'https://easyalgerie.com/api/v1/dinar/convert?amount=100&from=EUR&to=DZD&market=parallel_buy'

Visualizza la risposta JSON

Due endpoint, un formato semplice

URL di base : https://easyalgerie.com/api/v1/dinar

GET /rates — Consulta i tassi

I tassi sono espressi in DZD per 1 unità di valuta estera. Senza filtro, la risposta include tutte le 11 valute disponibili.

curl 'https://easyalgerie.com/api/v1/dinar/rates?currency=EUR'

currency: Facoltativo: codice di una valuta estera, ad esempio EUR o USD. Non usare DZD.

GET /convert — Converti un importo

Converti una valuta estera in dinari o viceversa. Esattamente una delle due valute deve essere DZD: la conversione diretta EUR/USD non è supportata.

amount: Obbligatorio. Da 0 a 1.000.000.000, usando il punto decimale e fino a 6 cifre decimali. Senza separatori delle migliaia né notazione esponenziale.
from / to: Obbligatori. Codici ISO delle valute di partenza e di arrivo. Esattamente una deve essere DZD.
market: Facoltativo. official, parallel_buy o parallel_sell. Valore predefinito: parallel_buy.

I codici valuta non distinguono maiuscole e minuscole. I parametri sconosciuti o duplicati vengono rifiutati.

Valute supportate

DZDEURUSDCADGBPCHFTRYCNYSARAEDTNDMAD

Scegli il tasso corretto

official: Riferimento bancario proveniente da un fornitore di tassi di cambio; non è un’offerta garantita da una banca.
parallel_buy: Il cambiavalute acquista la valuta estera dal cliente in cambio di dinari.
parallel_sell: Il cambiavalute vende la valuta estera al cliente in cambio di dinari.

Il mercato scelto si applica in entrambe le direzioni di conversione: l’API non passa automaticamente a un altro tasso.

Comprendi la risposta

result: Importo convertito, arrotondato al centesimo, per eccesso in caso di metà esatta.
rate: Moltiplicatore: 1 unità di from = rate unità di to.
dzdPerUnit: Tasso di riferimento in DZD per 1 unità di valuta estera.
provenance: Origine del valore, fonte e data disponibile.

Origine e aggiornamento dei dati

provider: Tasso ricevuto da un fornitore esterno.
editorial: Tasso editoriale del convertitore pubblico, inclusi i valori inseriti manualmente da EasyAlgerie.
fallback: Valore statico di riserva. Non presentarlo come un tasso di mercato attuale.

Controlla sourceUpdatedAt per la data della fonte: null indica una data sconosciuta. Per i tassi manuali è la data di modifica in UTC, non un’osservazione indipendente del mercato. retrievedAt indica il recupero dell’istantanea dei dati, non quando è stato fissato il tasso.

Le fonti esterne sono memorizzate nella cache per 6 ore. I tassi manuali hanno priorità e la loro cache viene invalidata al salvataggio (durata di riserva: 30 secondi). refreshIntervalSeconds riguarda le fonti esterne.

Le conversioni sono indicative, senza transazioni né garanzia di cambio. I tassi pubblici sono separati dai tassi commerciali usati per i pagamenti EasyAlgerie.

Limiti e gestione degli errori

60 richieste al minuto per indirizzo IP, condivise tra /rates e /convert. Le intestazioni RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset descrivono la quota. Memorizza i tassi nella cache per i calcoli ripetuti.

400: Parametri non validi: consulta error.code, error.message ed error.field.
405: Metodo non consentito. Usa GET per leggere i dati.
429: Quota superata: attendi il numero di secondi indicato da Retry-After.
503: Dati temporaneamente non disponibili. Riprova più tardi, senza cicli rapidi.

CORS pubblico: le richieste dal browser sono consentite senza inviare cookie o credenziali. Non serve alcuna chiave API segreta.

Esempio JavaScript

const url = new URL("https://easyalgerie.com/api/v1/dinar/convert");
url.search = new URLSearchParams({
  amount: "100", from: "EUR", to: "DZD", market: "parallel_buy"
}).toString();

const response = await fetch(url, { credentials: "omit" });
if (response.status === 429) {
  throw new Error("Retry after " + response.headers.get("Retry-After") + " seconds");
}
const data = await response.json();
if (!response.ok) throw new Error(data.error?.message || "API unavailable");

console.log(data.result, data.to);
console.log(data.provenance);

Collega un agente IA

Importa la specifica OpenAPI in uno strumento compatibile, senza autenticazione. Non tutti gli agenti supportano l’importazione automatica.
Usa getDinarExchangeRates per leggere i tassi e convertAlgerianDinars per convertire. Specifica esplicitamente il mercato scelto.
Controlla origine e date prima di rispondere. Non presentare i tassi editoriali o di riserva come quotazioni in tempo reale.
Chiarisci gli importi ambigui: 1 DZD = 100 centesimi. Se il cliente parla di «milioni», chiedi se intende dinari o centesimi.

Apri OpenAPI