Greške u Salesforce Workbenchu: Rješavanje problema s API alatima tijekom prekida rada

Pogreške Salesforce Workbencha tijekom zastoja: počnite odvajanjem kvara alata od kvara platforme

Kada Salesforce Workbench iznenada prestane s prijavom, REST Explorer vrati grešku ili upit koji je radio prije nekoliko minuta počne istjecati, najbrži put je da ne kliknete ponovno. Prvo utvrdite koji sloj ne uspijeva: Workbench web aplikacija, vaš preglednik ili mreža, Salesforce autentifikacija, vaša specifična Salesforce instanca ili sam API zahtjev.

Ta je razlika važna jer je Workbench web-bazirani API uslužni program kojim upravlja zajednica, a ne potpuno podržani Salesforce proizvod. Salesforce izričito navodi da ne održava Workbench i preporučuje podržane alternative kao što su Salesforce CLI, Code Builder i Salesforce Extensions for Visual Studio Code. Sam projekt Workbench također opisuje alat kao alat koji zahtijeva samo održavanje. Pogledajte Salesforceove smjernice za zamjenu Workbencha i izvorni repozitorij izvornog koda Workbencha .

Koristite ovu stranicu kao praktičnu referencu kada se sumnja na prekid rada ili degradaciju usluge. Cilj je sačuvati dokaze, izbjeći nepotrebne ponovne pokušaje i odlučiti hoće li se čekati, promijeniti alate ili popraviti nešto lokalno.

Ilustrativni prozor preglednika Salesforce Workbench koji prikazuje pogrešku pri povezivanju s prijavom bez otkrivanja vjerodajnica
Ilustrativna pogreška povezivanja s Workbenchom. Snimite točnu poruku prije promjene postavki ili ponovnog pokušaja.

Kontrolna lista za brzu trijažu

ProvjeritiNa što treba pazitiŠto vam govori
Salesforce TrustUtjecaj specifičan za incident, degradaciju, održavanje ili instancuPrijavljuje li Salesforce problem na strani platforme
Sam radni stolMože li se stranica za prijavu učitati? Preusmjerava li OAuth ispravno?Je li alat koji hostira zajednica dostupan
Prijava u SalesforceMožete li se normalno prijaviti u organizaciju?Je li autentifikacija široko pogođena
Minimalni API pozivIsprobajte laganu krajnju točku kao što /services/data/je ili/services/data/v66.0/limitsRadi li API put neovisno o složenom upitu
Kod pogreške401, 403, 404, 5xx, istek vremena, REQUEST_LIMIT_EXCEEDED,UNSUPPORTED_API_VERSIONKoju granu za rješavanje problema slijediti
Drugi klijentSalesforce CLI, postojeća integracija ili drugi odobreni API klijentJe li kvar specifičan za Workbench

1. Provjerite Salesforce Trust prije promjene konfiguracije

Posjetite službenu stranicu za status povjerenja u Salesforceu i potražite instancu, domenu, pod ili zakupca relevantnog za vašu organizaciju. Incidenti u Salesforceu mogu biti regionalni ili specifični za instancu, tako da zeleni status za nepovezanu instancu ne dokazuje da je vaša organizacija zdrava.

Ako Trust prijavi prekid usluge, smanjenje performansi, problem s prijavom ili održavanje koje utječe na vaše okruženje, zabilježite ID i vrijeme incidenta. Zatim izbjegavajte spekulativne promjene povezanih aplikacija, vjerodajnica, profila, skupova dopuštenja, mrežnih pravila ili verzija API-ja, osim ako greška izričito ne ukazuje na te postavke. Promjene konfiguracije napravljene tijekom prekida mogu stvoriti drugi problem nakon što se platforma oporavi.

Ilustrativna stranica statusa Salesforce Trust s redovima usluga i jednim istaknutim redom poremećaja
Pomoću Salesforce Trust provjerite aktivni status vlastite instance. Prikazani statusi su ilustrativni; aktivna stranica Trust je izvor istine.

2. Sačuvajte točnu Workbench grešku i klasificirajte je

Workbench često propušta odgovore na pogreške Salesforce API-ja s malo interpretacije. To je korisno za rješavanje problema: točan HTTP status, Salesforce kod pogreške, krajnja točka i poruka obično vam govore više od generičkog bannera preglednika.

Prekid veze, istek vremena ili HTTP 5xx

Istek vremena, 502, 503 ili neki drugi 5xx odgovor može biti u skladu s degradacijom usluge, preopterećenom infrastrukturom ili međukvarom mreže. Nemojte pretpostavljati da 5xx dokazuje prekid rada cijelog Salesforcea. Usporedite isti lagani zahtjev od drugog odobrenog klijenta i provjerite povjerenje. Ako više klijenata istovremeno ne uspije na istoj Salesforce instanci, dokazi ne ukazuju samo na Workbench.

Greške 401 ili nevažeće sesije

To obično ukazuje na probleme s autentifikacijom ili sesijom. Ponovno se autentificirajte pomoću OAuth umjesto kopiranja starih ID-ova sesije između preglednika. Ako normalna prijava na Salesforce također ne uspije i Trust prijavi utjecaj prijave, pričekajte oporavak usluge prije rotiranja vjerodajnica. Ako prijava na Salesforce radi, ali OAuth na Workbench ne radi, istražite put povezane aplikacije Workbench ili upotrijebite podržani alternativni klijent.

403 i pogreške autorizacije

Greška 403 obično znači da je zahtjev stigao do usluge koja ga je odbila. Provjerite korisnička dopuštenja, pravila povezanih aplikacija, ograničenja IP adresa i točan kod pogreške Salesforcea. Jedan poznati primjer specifičan za Workbench je , što se može dogoditi kada administrator blokira povezanu aplikaciju Workbench. Smjernice za povezane aplikacijeOAUTH_APP_BLOCKED projekta Workbench opisuju ovaj scenarij.

3. Smanjite test na najmanji siguran API zahtjev

Tijekom sumnje na prekid rada, nemojte dijagnosticirati skupnim učitavanjem, implementacijom metapodataka, dugim SOQL upitom ili višekoračnim skriptom. Počnite s krajnjom točkom samo za čitanje koja je jednostavna za izvršavanje. U REST Exploreru, zahtjev kao što je GET /services/data/provjerava osnovnu dostupnost API-ja. Zahtjev kao što je GET /services/data/v66.0/limitsmože vam pomoći u pregledu ograničenja organizacije kada API funkcionira.

Salesforce dokumentira Workbench REST Explorer kao način pozivanja REST krajnjih točaka, ali Workbench nije idealan za velike ili operacije koje zahtijevaju intenzivne performanse. Izvorna dokumentacija Workbencha napominje da ga vremensko ograničenje preglednika i veze čini prikladnijim za brze API interakcije u hodu nego za velika učitavanja ili izvoze podataka.

Ilustrativni Workbench REST Explorer koji prikazuje GET zahtjev prema krajnjoj točki ograničenja i odgovor na API pogrešku
REST Explorer je koristan za minimalne reproducibilne zahtjeve. Zabilježite HTTP status i Salesforce kod pogreške umjesto da se oslanjate samo na banner poruku.

4. Tretirajte pogreške API-limita drugačije od zastoja

REQUEST_LIMIT_EXCEEDEDnije isto što i prekid rada platforme. Salesforce primjenjuje alokacije API zahtjeva i kada organizacija premaši svoje ograničenje korištenja, daljnji API pozivi mogu se blokirati dok korištenje ne padne ispod praga. Članak podrške Salesforcea iz srpnja 2026. potvrđuje da REST API, SOAP API, Bulk API i Bulk API 2.0 pozivi doprinose potrošnji API-ja. Pogledajte Salesforceove smjernice za REQUEST_LIMIT_EXCEEDED i objašnjenje ograničenja korištenja API- ja .

Ako je pogreška uvjet ograničenja, ponovljeni pokušaji pogoršavaju situaciju trošenjem više poziva kada se zahtjevi još uvijek prihvaćaju. Identificirajte integracije s velikim volumenom, pauzirajte nebitne poslove gdje je to operativno sigurno i pratite korištenje u Salesforce postavkama. Nemojte čekati incident povjerenja da biste riješili problem ograničenja specifičnog za zakupnika.

5. Provjerite neusklađenost verzije API-ja

UNSUPPORTED_API_VERSIONzaslužuje vlastitu podružnicu. Salesforce je u svibnju 2026. objavio članak podrške u kojem se objašnjava da Workbench može prema zadanim postavkama odabrati noviju verziju API-ja prije nego što je produkcijska ili razvojna organizacija podrži. Preporučeno rješenje za Workbench je snižavanje zadane verzije API-ja na onu koju podržava ciljna organizacija. Pogledajte članak o rješavanju problema UNSUPPORTED_API_VERSION u Salesforceu .

Ovo je važno tijekom razdoblja izdanja jer neusklađenost između verzije API-ja može izgledati kao prekid rada ako se usredotočite samo na vrijeme. Provjerite samu grešku verzije prije nego što pričekate oporavak platforme.

6. Usporedite Workbench s podržanim klijentom

Ako je zadatak hitan i Workbench je jedina komponenta koja ne radi, reproducirajte najmanji zahtjev pomoću Salesforce CLI-ja ili drugog podržanog, odobrenog klijenta. Svrha je dijagnostika, a ne zaobilaženje stvarnog prekida rada Salesforcea. Ako oba klijenta ne uspiju u istoj organizaciji s usporedivim pogreškama na strani poslužitelja, promjena alata vjerojatno neće vratiti uslugu. Ako CLI uspije dok Workbench ne uspije, imate jači dokaz da je problem u Workbench hostingu, sesiji preglednika ili putu povezane aplikacije.

Ilustrativni terminal koji prikazuje informacije o verziji Salesforce CLI-ja i uspješnu naredbu za prijavu u organizaciju putem preglednika
Drugi klijent može pomoći u izolaciji sloja koji ne uspijeva. Koristite odobreni Salesforce CLI tijek rada i izbjegavajte otkrivanje pristupnih tokena, ID-ova sesija ili tajni na snimkama zaslona ili tiketima.

7. Koristite disciplinu ponovnog pokušaja umjesto oluja ponovnih pokušaja

Tijekom potvrđenog prekida usluge, agresivni ručni ponovni pokušaji rijetko pomažu. Za automatizirane klijente koristite ograničene ponovne pokušaje s eksponencijalnim odmakom i podrhtavanjem gdje to dopušta vaš dizajn integracije. Za ručnu upotrebu Workbencha pričekajte smisleno ažuriranje statusa ili razuman interval prije ponavljanja istog zahtjeva.

Za operacije pisanja budite posebno oprezni. Istek vremena ne dokazuje uvijek da Salesforce nije ništa učinio; klijent je možda izgubio odgovor nakon što je poslužitelj obradio zahtjev. Prije ponovnog slanja naredbe za kreiranje, ažuriranje, brisanje ili implementaciju, provjerite je li izvorna radnja izvršena. Dvostruki zapisi često su štetniji od odgođenog ponovnog pokušaja.

Uobičajeni simptomi i sljedeće radnje

SimptomNajkorisnija sljedeća provjeraIzbjegavati
Stranica Workbencha se ne učitavaProvjerite dostupnost Workbencha i koristite drugog odobrenog klijentaTrenutna promjena dozvola Salesforcea
OAuth preusmjeravanja ne uspijevajuProvjerite prijavu u Salesforce, povjerenje i pravila za povezane aplikacijeDijeljenje ID-ova sesija ili vjerodajnica
REST Explorer vraća 5xxProvjeri povjerenje i ponovi minimalni poziv samo za čitanje od drugog klijentaIzvođenje većih testnih zadataka
REQUEST_LIMIT_EXCEEDEDPregledajte potrošnju API-ja organizacije i ograničenja korištenjaBrzi ponovni pokušaji
UNSUPPORTED_API_VERSIONOdaberite verziju API-ja koju podržava ciljna organizacijaČekanje prekida koji možda i ne postoji
Samo jedan složeni upit ima vremenski limitPojednostavite upit i provjerite selektivnost/volumenPretpostavimo zastoj na cijeloj platformi

Koje dokaze trebate prikupiti za prijavu incidenta?

  • UTC vremenska oznaka i vaša lokalna vremenska zona.
  • Identifikatori Salesforce organizacije i instance koji se mogu sigurno dijeliti interno.
  • Točna krajnja točka i HTTP metoda, s uklonjenim osjetljivim parametrima.
  • HTTP status, Salesforce errorCodei kratki izvadak odgovora.
  • Je li funkcionirala normalna prijava na Salesforce.
  • Je li isti minimalni zahtjev odbijen od drugog odobrenog klijenta.
  • Relevantni ID incidenta Salesforce Trust ili napomena da nije vidljiv nijedan odgovarajući incident.
  • Je li operacija bila samo za čitanje ili je mogla potvrditi pisanje.

Nikada nemojte lijepiti tokene za pristup, lozinke, ID-ove sesija, OAuth autorizacijske kodove ili potpuno osjetljive podatke u dijeljene tikete ili chat kanale.

Kada prestati s rješavanjem problema na radnom stolu i promijeniti alate

Prebacite se s Workbencha na Workbench kada je kvar očito izoliran, kada je operacija prevelika za uslužni program temeljen na pregledniku, kada vam je potrebno ponovljivo skriptirano ponašanje ili kada vam je potreban podržani razvojni tijek rada. Salesforceove vlastite smjernice za zamjenu posebno upućuju programere na Code Builder, Salesforce CLI i Salesforce Extensions za VS Code.

Nemojte mijenjati alate samo da biste nastavili opterećivati ​​nedostupnu Salesforce uslugu. Drugi klijent ne može popraviti prekid rada na strani poslužitelja, a ponovljeni pozivi mogu učiniti dijagnozu bučnijom. Tijekom prekida rada, najbolji rezultat je jasna klasifikacija: potvrđeni incident platforme, kvar samo na Workbenchu, problem s lokalnom mrežom/preglednikom, neusklađenost verzije API-ja, problem s dozvolama/autentifikacijom, iscrpljivanje ograničenja API-ja ili kvar specifičan za zahtjev.

Zaključak

Pogreške u Salesforce Workbenchu ​​lakše je riješiti kada ih tretirate kao signale, a ne kao dijagnoze. Provjerite Salesforce Trust, sačuvajte točnu pogrešku, smanjite zahtjev, usporedite s jednim podržanim klijentom i slijedite kod pogreške. Taj slijed vam pomaže da izbjegnete nepotrebne promjene konfiguracije tijekom prekida, a istovremeno uočavate probleme koji izgledaju kao prekid rada, ali su zapravo specifični za zakupnika ili Workbench.

Ostavite komentar

Prekid rada Salesforcea 2025.: Praktična retrospektiva na velike poremećaje

Prekid rada Salesforcea 2025.: Praktična retrospektiva na velike poremećaje

Pregledajte značajne prekide rada Salesforcea u 2025. godini, što je zakazalo, koliko su dugo trajali odabrani incidenti i praktične lekcije o otpornosti koje timovi mogu primijeniti.

Razvoj plana kontinuiteta poslovanja za vrijeme zastoja u radu Salesforcea

Razvoj plana kontinuiteta poslovanja za vrijeme zastoja u radu Salesforcea

Izradite praktičan plan za kontinuitet zastoja u Salesforceu s analizom utjecaja, ciljevima RTO/RPO, ručnim rješenjima, kontrolama integracije i provjerama oporavka.

Kako kontaktirati podršku Salesforcea tijekom većeg kvara sustava

Kako kontaktirati podršku Salesforcea tijekom većeg kvara sustava

Naučite kako kontaktirati Salesforce podršku tijekom većeg prekida: provjerite status povjerenja, odaberite pravi kanal, otvorite snažan slučaj i pratite oporavak.

Greške u Salesforce Workbenchu: Rješavanje problema s API alatima tijekom prekida rada

Greške u Salesforce Workbenchu: Rješavanje problema s API alatima tijekom prekida rada

Rješavanje problema s prijavom u Salesforce Workbench, REST Explorerom, timeoutom, 503, verzijom API-ja i ograničavanje pogrešaka tijekom zastoja pomoću praktičnog dijagnostičkog popisa za provjeru.

Ima li StoreForce problema? Kako maloprodajni timovi mogu zaštititi radnu snagu

Ima li StoreForce problema? Kako maloprodajni timovi mogu zaštititi radnu snagu

Problemi sa StoreForceom mogu poremetiti raspoređivanje, evidenciju vremena i tijekove rada zaposlenika. Naučite kako procijeniti utjecaj, održati trgovine u funkciji, provjeriti oporavak i znati kada eskalirati problem.

Koji su glavni uzroci raširenih prekida rada cloud platforme?

Koji su glavni uzroci raširenih prekida rada cloud platforme?

Razumjeti glavne uzroke raširenih prekida rada u oblaku, kako se kvarovi kaskadno prenose, što prvo provjeriti i kako osmisliti otporniji plan oporavka.

Datorama (Marketing Cloud) Down: What Marketers Need to Know

Datorama (Marketing Cloud) Down: What Marketers Need to Know

If Datorama or Marketing Cloud Intelligence seems down, use this evidence-based checklist to verify the outage, protect reporting quality, and know when data is trustworthy again.

Salesforce Heroku Outage: What Happens to Deployed Applications?

Salesforce Heroku Outage: What Happens to Deployed Applications?

A practical look at how Heroku outages can affect deployed apps, dynos, routing, databases, deploys, Heroku Connect, logs, and recovery.

Understanding the Dependency Between Salesforce and AWS

Understanding the Dependency Between Salesforce and AWS

Understand how Salesforce and AWS connect through Hyperforce, integrations, networking, data residency, outages, and shared operational responsibilities.

Je li Salesforce pogođen nedavnim prekidom rada AWS-a? Što bi korisnici trebali prvo provjeriti

Je li Salesforce pogođen nedavnim prekidom rada AWS-a? Što bi korisnici trebali prvo provjeriti

Prekid rada AWS-a ne znači automatski da je Salesforce u kvaru. Saznajte kako Hyperforce, regije, instance i Salesforce Trust određuju je li vaša organizacija pogođena.