Learn/Szybki start Airtable

Rejestrowanie kursów transakcji w Airtable

Skonfiguruj tabelę Airtable i zaplanowaną automatyzację, która odświeża orientacyjne dane FX, zachowując pierwotny kurs każdej transakcji.

ERexchangerate.dev·Sep 29, 2026·7 min czytania

Użyj osobnych grup pól pierwotnych i bieżących: Rate at transaction wraz ze źródłem i czasem obowiązywania zapisuje się raz, gdy waluta i kwota są gotowe, a Current rate i jego metadane odświeża automatyzacja. Dzięki temu późniejsza zmiana rynku nie nadpisze wartości użytej przez transakcję.

Najważniejsze punkty
Utwórz osobne pola From, To, Amount, pierwotnej proweniencji, bieżącego monitoringu i błędów.
Użyj automatyzacji dla gotowego rekordu, aby raz zapisać pierwotny kurs i jego proweniencję; nie przeliczaj tych pól ponownie.
Użyj automatyzacji At scheduled time do odświeżania bieżących szacunków oraz zachowania source i effective_at.
Pokazuj błędy w Sync status i Sync error zamiast zapisywać zero lub wartości wyglądające na aktualne.
Akcja Run a script nie jest dostępna w Airtable Free; przed wdrożeniem sprawdź aktualne limity planu.

Utwórz tabelę Transactions

Utwórz tabelę Transactions z polami: From (tekst jednoliniowy), To (tekst jednoliniowy), Amount (liczba), Rate at transaction (liczba), Transaction converted (liczba), Transaction source, Transaction market session, Transaction effective at, Archived (checkbox), Current rate (liczba), Current converted (liczba), Source, Market session, Effective at, Checked at, Sync status i Sync error. Pola Transaction effective at, Effective at i Checked at ustaw jako data i czas; pozostałe metadane i statusy jako tekst jednoliniowy. Dodaj widok Needs FX refresh, filtruj Archived jako odznaczone i sortuj Checked at od najstarszych, puste najpierw, aby kolejne uruchomienia rotowały rekordy.

Obie grupy kursów mają inne znaczenie. Pola Transaction * są migawką księgową lub audytową. Bieżące pola bez prefiksu to nowa orientacyjna obserwacja dla panelu lub estymacji. Nie używaj ich do odtwarzania wartości pierwotnej.

Zapisz pierwotny kurs transakcji

Utwórz automatyzację Airtable z wyzwalaczem When record matches conditions: From, To i Amount są wypełnione, a Rate at transaction jest puste. Dodaj Run a script, ustaw mode na snapshot, przekaż recordId rekordu wyzwalającego i wklej skrypt. Dodaj sekret Airtable Automation exchangerateApiKey; skrypt odczytuje go przez input.secret, więc edytorzy bez dostępu mogą uruchamiać automatyzację bez poznania wartości. Migawka zapisuje pola pierwotne tylko wtedy, gdy kurs jest pusty; ponowienie pozostawia je bez zmian.

HTTP request · latest ratecopy
GET https://api.exchangerate.dev/v1/latest/{From}?symbols={To}

Authorization: Bearer EXR_KEY_FROM_A_SERVER_SIDE_SECRET
Użyj sekretu Automation
Utwórz exchangerateApiKey w sekcji Secrets edytora skryptów dla obu automatyzacji. Nie zmieniaj nazwy. Nie umieszczaj wartości w polu tabeli, URL-u, wspólnym opisie ani literale kodu; Airtable ogranicza edycję skryptów używających sekretów do osób z dostępem.

Odświeżaj bieżące szacunki według harmonogramu

Utwórz drugą automatyzację z wyzwalaczem At scheduled time. Ustaw mode na refresh, pozostaw recordId puste, aby przetworzyć pierwszych 25 rekordów widoku Needs FX refresh, i wklej kompletny skrypt Airtable. Każde uruchomienie wykonuje najwyżej 25 żądań HTTP, poniżej limitu 50 fetches Airtable, i zapisuje partie najwyżej 50 rekordów. Ten przykład jest przeznaczony dla małej bazy raportowej; większe tabele wymagają planowanej kolejki i grupowania żądań. Przy 25 różnych parach raz dziennie zaplanuj do 750 żądań API w 30-dniowym miesiącu, poza migawkami początkowymi i ponowieniami.

Odświeżanie zmienia tylko Current rate, Current converted, Source, Market session, Effective at i Checked at. Nie aktualizuje żadnego pola Transaction *. Błędy HTTP i niepoprawne odpowiedzi ustawiają Sync status na Error i zachowują ostatnie poprawne wartości bieżące.

Pokaż błędy

401 oznacza problem z sekretem Automation; 429 oznacza problem z harmonogramem lub limitem konta; brak symbolu oznacza nieprawidłową albo niedostępną parę. Zachowaj ostatnią poprawną wartość z poprzednim Checked at, a w Sync error umieść diagnozę dla operatora. Nigdy nie zamieniaj błędu na wiersz z kursem zero.

Sprawdź limity planu Airtable

Aktualna dokumentacja Run a script Airtable opisuje natywne sekrety Automation i ochronę przed edytorami. Limity automatyzacji mówią, że Run a script nie jest dostępne w planie Free, a nieudane uruchomienia także się liczą. Codzienne odświeżanie zwykle wystarcza dla tabeli raportowej; nie zmienia dziennego kursu referencyjnego w notowanie intraday.

Tylko kursy orientacyjne
Używaj tych obserwacji do estymacji, raportów i analiz. Płatność lub regulowana transakcja musi korzystać z wykonalnej wyceny i rejestru rozliczenia odpowiedzialnego dostawcy.
ER
exchangerate.dev
Przewodniki integracji dla programistów korzystających z danych FX.

Czytaj dalej

ReferenceSzybki start API kursów walutCzytaj TutorialPobieranie kursów walut w ZapierCzytaj TutorialŁadowanie kursów walut do Power BICzytaj
Więcej porównańFixer vs exchangerate.devOpen Exchange Rates vs exchangerate.devCurrencylayer vs exchangerate.dev
PoradnikiKursy walut w Next.js i TypeScriptAlert kursów walut w Pythonie: USD/IDRKursy walut w Go przez net/http
Kursy na żywoEUR/USDGBP/USDUSD/JPY