Rateweb-API

ʼn Gratis, leesalleen-API vir lewendige Suid-Afrika-koersdata. As jou webwerf die primakoers noem, keer dit dat daardie syfer stilweg verouderd raak wanneer dit weer beweeg.

Vir wie is dit

Eiendomsblogs, eiendomsagente, voertuighandelaars, makelaars, en enigiemand wat ’n koers publiseer wat op datum moet bly. Jy kry dieselfde syfers waarop ons eie sakrekenaars loop, opgedateer wanneer die onderliggende koers verander.

Kry ’n sleutel

Sleutels is gratis en word met die hand uitgereik sodat ons weet wie die data gebruik. Kontak ons met jou webwerf se URL en wat jy bou, en ons stuur een.

ʼn Sleutel word een keer gewys wanneer dit uitgereik word en daarna geënkripteer gestoor — ons kan dit nie later herwin nie, stoor dit dus iewers veilig. Verlore sleutels word vervang, nie herstel nie.

Verifikasie

Stuur jou sleutel op enige van hierdie drie maniere:

Authorization: Bearer YOUR_KEY
X-API-Key: YOUR_KEY
?api_key=YOUR_KEY

Die navraagstring-vorm bestaan vir blaaser-inbeddings wat nie opskrifte kan stel nie. Verkies ’n opskrif waar jy kan — navraagstringe beland in verwysingsopskrifte en bedienerlogs.

Eindpunte

GET /api/v1

Diensmetadata en die eindpuntlys. Geen sleutel nodig nie, sodat jy konnektiwiteit kan toets voordat jy een het.

GET /api/v1/rates

Hierdie mark se hoofkoerse — beleidskoers (repo), prima-uitleenkoers, en die beste geadverteerde spaarkoers oor die produkte wat ons dophou.

curl -H "Authorization: Bearer YOUR_KEY" \
  https://afrikaans.rateweb.co.za/api/v1/rates

GET /api/v1/rates/prime/history

Elke primakoersverandering met sy inwerkingtredingsdatum en die skuif in basispunte, nuutste eerste. Opsionele ?limit= (verstek 50, maksimum 200).

Slegs Suid-Afrika — die reeks beskryf SARB-besluite, sodat ander markte se gasheerbedieners 404 teruggee eerder as om Suid-Afrikaanse beleid as hul eie voor te stel.

Wat elke reaksie bevat

Saam met data dra elke lading ’n meta-blok met as_of (hoe aktueel die syfers is), source (wie dit publiseer) en die mark wat hulle beskryf. Wys asseblief die datum oral waar jy ’n koers vertoon — ’n koers sonder ’n datum is nie ’n feit nie, en ’n verouderde syfer op jou bladsy is soveel jou geloofwaardigheid as ons s’n.

Koersperke

60 versoeke per minuut per sleutel by verstek. Elke reaksie gee X-RateLimit-Limit en X-RateLimit-Remaining terug; oorskryding gee ’n 429 met ’n Retry-After-opskrif terug.

Koerse verander selde — die meeste integrasies behoort vir ’n uur of langer te kas eerder as om by elke bladsywys te roep. As jy werklik ’n hoër plafon nodig het, vra.

Voorwaardes

  • Toeskrywing vereis. Skakel na afrikaans.rateweb.co.za oral waar die data verskyn.
  • Slegs inligting. Geadverteerde koerse verander sonder kennisgewing — verifieer by die verskaffer voordat enigiemand daarop staatmaak vir ’n besluit.
  • Verkoop dit nie weer nie. Vertoon dit vrylik op jou eie webwerf; verpak die voer nie weer as jou eie dataproduk nie.
  • Ons kan die API verander of onttrek, maar v1 sal steeds soos v1 optree — omvangryke veranderinge kry ’n nuwe weergawe.

Foute

Foute gee die toepaslike status terug met ’n masjienleesbare error.code: missing_api_key of invalid_api_key (401), rate_limit_exceeded (429), not_available_in_market (404).