Ispravite postojeću robnu marku za slanje poruka
Ažurirajte postojeću robnu marku kada se promijene poslovni kontaktni podaci ili adresa. Zadržite njezin identifikator; stvaranje nove registracije nije način ispravljanja podataka o postojećem poslovnom subjektu. Upotrijebite omogućen račun za API putem protokola HTTPS s dopuštene izvorne IP adrese. Robna marka mora pripadati tom računu.
Najprije dohvatite trenutačni zapis. Lokalnu kopiju čuvajte kao privatnu jer sadrži podatke o identitetu poslovnog subjekta i kontaktne podatke.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
--output current-brand.jsonOčuvajte trenutačna polja robne marke
Pripremite brand-update.json na temelju trenutačnog zapisa, odabirom samo onih polja robne marke u koja je dopušten upis. Očuvajte identitet poslovnog subjekta i ostale obvezne vrijednosti dok unosite željeni ispravak. Nemojte slati cijeli odgovor na GET: brandId, rezultati provjere identiteta i statusa, vremenske oznake i ostala polja namijenjena samo odgovoru ne pripadaju ažuriranju.
Shema ažuriranja zahtijeva entityType, displayName, country, email i brandRelationship. Pravila specifična za vrstu subjekta i dalje vrijede. Za organizaciju očuvajte njezin pravni naziv, porezni identifikator i državu njegova izdavanja te adresu i djelatnost, prema potrebi. Za samostalnog poduzetnika umjesto toga očuvajte odgovarajuća polja osobnog imena i mobilnog kontakta. Upotrijebite stvarne trenutačne vrijednosti, a ne zamjenske vrijednosti iz primjera registracije.
| Polja | Kako ih upotrebljavati |
|---|---|
| displayName, email, phone | Prepoznatljiv naziv robne marke i valjani kontaktni podaci. Najveće duljine: 255, 100 i 20 znakova. Upotrijebite međunarodni format telefonskog broja s oznakom + i pozivnim brojem države. |
| street, city, state, postalCode, country | Stvarna poslovna adresa s međusobno usklađenim podacima. Ograničenja: 255, 100, 20, 10 i 2 znaka. Gdje je primjenjivo, upotrijebite važeće oznake saveznih država SAD-a. |
| entityType, companyName, ein, einIssuingCountry | Pravni identitet. Te su promjene ograničene kada kampanje ili vanjske provjere čekaju obradu ili su aktivne. Nemojte brisati funkcionalne kampanje samo kako biste zaobišli ograničenje promjene identiteta. |
| firstName, lastName, mobilePhone, businessContactEmail | Podaci o identitetu ili kontakti za provjeru kada su primjereni vrsti subjekta. Ograničenja: 100, 100, 20 i 255 znakova. |
| brandRelationship, vertical | Trenutačne šifre odnosa i djelatnosti. Odnos se može promijeniti najviše jednom u tri mjeseca. Standardni obrazac za uređivanje na portalu ne omogućuje promjene odnosa. |
| website, altBusinessIdType, altBusinessId, stockSymbol, stockExchange | Primjenjivi podaci o mrežnom mjestu, alternativnom poslovnom identitetu i društvu uvrštenom na burzu. Očuvajte vrijednosti potrebne za validaciju subjekta. |
| referenceId, ipAddress | Podržani metapodaci o poslovnoj referenci i izvornoj IP adresi. Nijedno od tih polja ne određuje vlasništvo računa niti služi kao ključ idempotentnosti zahtjeva. |
Upotrijebite aktualne kataloge za slanje poruka za šifre. Shema ažuriranja ne omogućuje upotrebu polja mock za promjenu okruženja robne marke. Upotrijebite zaseban, pregledan postupak prijelaza iz testnog u produkcijsko okruženje umjesto mijenjanja te zastavice pri uređivanju.
Pošaljite pregledani ispravak
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @brand-update.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"Upotrijebite jedan ključ za ovo namjeravano ažuriranje i sačuvajte točne bajtove tijela zahtjeva. Ponovna upotreba ključa s promijenjenom metodom, putanjom, upitom ili tijelom uzrokuje sukob; promjena oblikovanja zapisa JSON također mijenja otisak zahtjeva. Duplikat zahtjeva koji se još obrađuje može vratiti 409 sa zaglavljem Retry-After. Dovršeni zahtjev može ponovno vratiti svoj spremljeni rezultat, uključujući pogrešku. Sačuvajte pojedinosti zahtjeva pri utvrđivanju ishoda nakon isteka vremena čekanja umjesto da automatski generirate novi ključ.
Provjerite spremljeni zapis i status validacije
Uspješno ažuriranje vraća HTTP 200 i izravan objekt robne marke u formatu JSON, bez starije omotnice status/response iz v3. Provjerite njegov brandId, zatim ponovno dohvatite istu robnu marku metodom GET i usporedite željena polja. Javna ruta za ažuriranje ne prihvaća omotnicu changes/version s portala niti pruža njegovu optimističku provjeru istodobnih izmjena. Uskladite rad osoba koje istodobno uređuju podatke; ključ idempotentnosti sprječava dvostruko slanje, ali ne i promjene koje unese druga osoba.
Trenutačni portal dohvaća robnu marku, očuva njezina polja u koja je dopušten upis, provjerava verziju obrasca prije spremanja i ponovno dohvaća rezultat. Zaključava osnovna polja pravnog identiteta kada pronađe aktivne kampanje. Registar može nametnuti dodatna ograničenja, uključujući ograničenja zbog vanjske provjere, čak i kada je polje bilo dostupno u obrascu.
Spremanje ispravljenih podataka ne zahtijeva automatski novu provjeru identiteta niti jamči odobrenje. Ponovna provjera zasebna je radnja koja može podlijegati naknadi; na portalu pregledajte trenutačno stanje i izričito potvrdite svaku navedenu naknadu. Uobičajena ažuriranja robne marke metodom PUT ne pokreću zasebno terećenje za registraciju u trenutačnoj usluzi API. Postojeće naknade za kampanje, slanje poruka i ostale usluge ostaju zasebne.
Riješite pogreške bez stvaranja dvostruke registracije
Pročitajte status HTTP i pojedinosti pogreške u formatu JSON. Za 400 ispravite konkretno polje ili poštujte ograničenje promjene identiteta ili odnosa. Za 401, 403 ili 404 provjerite vjerodajnice, dopuštenu izvornu IP adresu i vlasništvo računa. Za 429 postupite prema zaglavlju Retry-After. Pogreška 500 ili 502 može se pojaviti nakon što je registar prihvatio ažuriranje; sačuvajte svaki primljeni requestId i dohvatite postojeći zapis prije ponovnog slanja.
Neprazan, ali nepotpun odgovor na ažuriranje može ostaviti nepotpunu lokalnu snimku stanja; prazno tijelo uspješnog odgovora može zadržati starija polja snimke. Nemojte zaključiti da su polja očuvana samo na temelju statusa uspjeha. Ponovno dohvatite cijelu robnu marku i uz pomoć podrške razriješite sva odstupanja. Ovaj vodič ne jamči atomska ažuriranja registra, lokalne predmemorije i naplate.