Een registratieprofiel aanmaken

Maak het profiel één keer aan

Dit verzoek maakt een lokaal registratieprofiel aan, samen met identiteits- en adresrecords bij de carrier. Begin met de huidige registratielanden, nummertypen en vereisten. De vereisten zijn afhankelijk van het land en het type nummer dat u wilt registreren.

Een geslaagd antwoord op het aanmaken is geen goedkeuring door de toezichthouder en geen activering van het nummer. Bewaar de document-UUID, de identiteits-ID en de adres-ID afzonderlijk: ze dienen verschillende doelen. Dit verzoek wijzigt accountgegevens en is geen bewerking die alleen valideert.

Aanmaakverzoek

Authenticeer met uw ingeschakelde MultiTEL API-account en het daarvoor toegestane IP-adres. De voorbeelden gebruiken HTTP Basic-referenties die in omgevingsvariabelen zijn opgeslagen. Controleer zowel het HTTP-antwoord als het JSON-veld status.code; een HTTP 200-antwoord op zich bewijst geen succes. Alle voorbeeldwaarden zijn fictief.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @registration-profile.json \
  https://api.multitel.net/v3/create_document

{
  "identity_type": "Personal",
  "first_name": "Example",
  "last_name": "Person",
  "phone_number": "12025550123",
  "email": "end-user@example.com",
  "city": "Example City",
  "postal_code": "00000",
  "country": "US",
  "address": "1 Example Street",
  "nationality": "US",
  "signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE"
}

De JSON is een illustratief Personal-profiel, geen echte identiteit die klaar is om in te dienen. Vervang de gegevens en de handtekening door de eindgebruikersinformatie die de geselecteerde registratieregels vereisen. Form-encoded invoer wordt ook ondersteund.

Velden van het registratieprofiel
Veld	Verplicht en formaat
`identity_type`	Verplicht. Gebruik exact de waarde Personal of Business; de voorwaardelijke validatie is afhankelijk van hoofdlettergebruik.
`first_name, last_name`	Verplicht, elk maximaal 64 tekens. Geef voor een bedrijf de gegevens van de vertegenwoordiger op die het geselecteerde land vereist.
`phone_number`	Verplichte numerieke telefoonwaarde van ten minste acht tekens. Een internationaal nummer dat alleen uit cijfers bestaat, inclusief de landcode, voldoet aan deze validatie; dit is een contactnummer, geen nummeraankoop.
`city, postal_code, address`	Verplicht, elk maximaal 64 tekens.
`country`	Verplichte ISO-code van het adresland uit de registratiecatalogus. De service koppelt deze aan het landrecord van de carrier.
`signature`	Verplichte handtekeninggegevens. Het huidige portaal levert Base64 PNG-afbeeldingsbytes zonder het voorvoegsel data:image/png;base64,. Verkrijg de handtekening van de eindgebruiker via uw geautoriseerde werkproces; een niet-lege tijdelijke waarde is geen betekenisvolle handtekening.
`nationality`	Verplicht voor Personal, als ISO-landcode. Vervang deze niet door een land-UUID.
`company_name, incorporation_country`	Verplicht voor Business. De bedrijfsnaam mag maximaal 64 tekens bevatten; incorporation_country is een ISO-landcode.
`email`	Optioneel contact-e-mailadres van de eindgebruiker, maximaal 254 tekens. Een weggelaten of leeg e-mailadres neemt het e-mailadres van het basisaccount niet over.
`company_reg_number, vat_id, id_number, personal_tax_id, birth_date, description`	Optioneel in deze handler, maar het geselecteerde land of de carrier kan sommige ervan vereisen. Lever de formaten aan die voor die registratie vereist zijn. Directe API-aanroepen passen niet automatisch elke normalisatie toe die het portaal uitvoert.

Deze directe v3-handler vereist adresvelden en maakt een adres aan. Ga er niet van uit dat de optie van het portaal om het adres uit te stellen via deze handler beschikbaar is.

Bewaar alle drie de identificatoren

Hieronder staan geselecteerde antwoordvelden; het werkelijke antwoord bevat ook de ingediende profielinformatie en handtekeninggegevens. Behandel het volledige antwoord als vertrouwelijk.

{
  "status": {
    "code": 200,
    "msg": "Success Create Registration Detail."
  },
  "response": {
    "uuid": "11111111111111111111111111111111",
    "identity_id": "22222222222222222222222222222222",
    "address_id": "33333333333333333333333333333333",
    "country_iso": "US",
    "email": "end-user@example.com"
  }
}

response.uuid identificeert het lokale profiel. Gebruik deze met get_document. In documents en get_document-antwoorden heet dezelfde profielidentificator id.
response.identity_id identificeert de identiteit voor latere identiteitsbewijzen en ondersteunende documenten.
response.address_id identificeert het aangemaakte adres. Bewaar deze afzonderlijk; de UUID van het lokale profiel is geen adres-ID. De compatibiliteit van het later bijvoegen van adresbewijzen voor nieuw aangemaakte profielen wordt nog beoordeeld.

De twee endpoints voor het teruglezen van het profiel geven geen identity_id of address_id terug; bewaar daarom het oorspronkelijke geslaagde antwoord op het aanmaken. Als dat verloren is gegaan, gebruik dan de documentweergave van het portaal of neem contact op met de ondersteuning voordat u een vervanging aanmaakt.

Geavanceerd: vooraf geüploade bewijzen bijvoegen tijdens het aanmaken

U kunt identity_encryptfiles en address_encryptfiles opgeven als arrays van ID's die zijn geretourneerd door create_encrypt_files. Upload met een bewijstype voor de bijbehorende entiteitscategorie en dien daarna in voordat de bestandsverwijzing na ongeveer 20 minuten verloopt. De aanmaakhandler controleert het account, de categorie en de vervaltijd van elke opgegeven verwijzing.

Deze velden hebben andere namen dan encrypted_file_ids van het latere endpoint voor bijvoegen. Tijdens het aanmaken wordt elk bestand als een afzonderlijk bewijsverzoek verzonden, ook wanneer meerdere bestanden hetzelfde bewijstype delen. Gebruik voor een identiteitsbewijs dat meerdere bestanden samen moet bevatten het latere create_proof-verzoek met één array. Een geslaagde profielaanmaak op zich levert geen goedkeuringsresultaten voor afzonderlijke bewijzen op.

Als een later adresbewijs voor een nieuw aangemaakt adres wordt afgewezen, gebruik dan niet de profiel-UUID als vervanging en maak de identiteit niet herhaaldelijk opnieuw aan. Stop en controleer het profiel in het portaal of bij de ondersteuning. Het pad voor het teruglezen en opzoeken van adresbewijzen blijft een beperking van de beoordeling.

Fouten en gedeeltelijke aanmaak

API-code 400 dekt veldvalidatie, fouten bij het aanmaken bij de carrier en fouten bij lokaal opslaan. Validatiefouten kunnen als vermeldingen per veld verschijnen in response. Code 500 wordt gebruikt voor een niet-beschikbaar of ongeldig registratieland, en code 404 voor ontbrekende of verlopen vooraf geüploade verwijzingen. Lees status.msg naast de code.

De bewerkingen op het lokale profiel en de upstream-bewerkingen bij de carrier vormen niet één atomaire transactie. Een mislukt verzoek kan upstream status achterlaten, zelfs wanneer er geen lokaal profiel wordt vermeld. Er is geen idempotentiesleutel voor de client beschikbaar. Inspecteer na een time-out of een onzekere fout de bestaande profielen en neem contact op met de ondersteuning voordat u het aanmaken herhaalt; een lege documents-lijst bewijst niet dat er upstream niets is aangemaakt.