Мақсаты және ағындағы орны
«API кіріс деректері» қабылданған HTTP сұрауының кестесін беріп, тармақты бастайды. Оны «API: деректерді қабылдау және жариялау» тобынан немесе қосылымдар қойындысынан қосыңыз. «Data Bridge жүйесіне деректер қабылдау» бағыты бар REST API қосылымын таңдаңыз. Ағында әр кіріс түпкі нүктесіне бір осындай блок қолданыңыз.
Блокқа кіріс кестесі қажет емес. Нәтижесін тазалауға, тексеруге, түрлендірулерге және қабылдаушыларға жалғаңыз. Қабылданған жеткізілім ашық жоба нұсқасын емес, Production орындайды. Ағын бірнеше дереккөз қолданса, кестелерін алғаннан кейін тиісті кілттермен біріктіріңіз.
Деректер немесе файлдар
«Деректер қабылдау» режимінде Content-Type бойынша автоматты анықтауды немесе JSON, JSON Lines, CSV/TSV не XML таңдаңыз. JSON үшін қажет болса data.items сияқты жазба жолын орнатыңыз. CSV үшін бөлгіш пен тақырыптарды; XML үшін жазба жолы мен ата-аналық атрибуттарды анықтаңыз. Ішкі мәндер customer.id сияқты өрістерге айналады.
«Файлдар қабылдау» режимінде қабылданатын XLSX/XLSM, CSV, TXT, JSON және XML пішімдерін, файл санын және оқу баптауларын таңдаңыз. Excel үшін парақ пен A1:Z10000 сияқты нақты ауқымды; JSON файлы үшін /data/rows сияқты JSON Pointer қолданыңыз. Бір сұраудағы барлық файл жолдары біріктіріледі. Қажет болса дерек өрісімен қайталанбайтын атауы бар файл атауы бағанын қосыңыз.
Өрістер және қате ережесі
Сынақ үлгісін енгізіп, оның жеке пішімін таңдаңыз және өрістерді жаңартыңыз. Әр өріс пішімін тексеріңіз: мәтін, бүтін сан, сан, күн, күн/уақыт немесе логикалық мән; міндеттілерін белгілеңіз. Тексеру мәндерді түрлендірмейді: кейінгі блоктарда қалыпқа келтіріңіз. Бір немесе бірнеше өрістен тұратын 20 бірегей кілтке дейін қосыңыз; олар қайталанымдарды тек бір сұрау ішінде тексереді.
Анықталған өріс жоқ болса, сұрауды қабылдамауға немесе бос мән беруге болады. Жарамсыз мәндер үшін толық мәліметпен бүкіл сұрауды қабылдамау, тек жарамды жолдарды қабылдау немесе қысқа қорытындымен бүкіл сұрауды қабылдамауды таңдаңыз. Ішінара қабылдау кейін қабылданбаған жолдарды салыстыруды талап етеді; жарамды жол қалмаса, сұрау қабылданбайды.
Симуляция және жұмыс орындауы
Сынақ деректері алдын ала қарауда, тексеруде, симуляцияда және анықтама мысалдарында қолданылады. Оның пішімі сұрау пішімінен тәуелсіз. Production сынақ үлгісін ешқашан алмастырып қолданбайды. API жеткізілімінсіз іске қосуға анықталған өрістері бар бос кестені немесе тоқтатуды таңдаңыз: бұл сынақ мәндерін кездейсоқ пайдаланудан қорғайды.
Жарамды жолды, міндетті мәннің болмауын және қайталанатын кілтті сынаңыз. Жариялағаннан кейін бақылау жеткізілімін жіберіп, қабылдаушы кестені салыстырыңыз. «Техникалық құжаттама» түпкі нүкте келісімін; контекст мәзіріндегі «API сұраулары» оның журналын ашады. Мынаны қараңыз: API қабылдауын баптау — толық қосылым, қол қою және бақылау рәсімі үшін.