Endepunkter og valideringsfeil
1. Hent access token
POST /oauth/token
Brukes for å hente token som kreves for videre bruk av API-et.
2. Hent distributørens innrapporterte fondskostnader
GET /distribution-fees
Returnerer fondskostnader for distributøren som er knyttet til access tokenen.
| Kode | Beskrivelse |
|---|---|
422 | Validation failed: Paginerings parameterne inneholdt ugyldige verdier |
| Kode | Beskrivelse |
|---|---|
422 | Ett eller flere av de oppgitte ISIN-numrene har allerede en fondskostnad knyttet til din distributør. Bruk PUT eller PATCH for å oppdatere eksisterende poster, eller slett dem først. |
422 | Ett eller flere av de oppgitte ISIN-numrene finnes ikke i fondsunivers. Kontroller at ISIN-nummeret er korrekt stavet og at fondet er registrert i systemet. |
422 | Forespørselen inneholder ugyldige eller manglende feltverdier. Kontroller at alle påkrevde felt er oppgitt og har korrekt format og verdi. |
3. Full erstatning av fondskostnader med innsendt payload
PUT /distribution-fees
Brukes for å sende inn og for å erstatte hele eksisterende distribution-fees listen til en distributør
Eksempel på payloads
{
"distributionFees": [
{
"isin": " NO0011101545",
"platformFeeRate": 0.43,
"commissionRebateRate": 0.23
},
{
"isin": " SE0011311190",
"platformFeeRate": 0.13,
"commissionRebateRate": 0.93
}
] }
Dette er det anbefalte endepunktet når distributøren skal gjøre en større synkronisering. Denne operasjonen erstattet hele fondslisten til en distributør.
Semantikk
-
Hvert element i fondskostnader representerer ett fond
-
ISIN brukes til oppslag i Finansportalens fondsunivers
| Kode | Beskrivelse |
|---|---|
422 | Fond listen er tom |
422 | ISIN i en rad har ugyldig format |
422 | Plattformgebyrer er utenfor tillatt verdiområde (0–100) |
422 | Returprovisjon er utenfor tillatt verdiområde (0–100) |
422 | ISIN finnes ikke i finansportalens fondsunivers |
4. Slette fondskostnader for flere fond samtidig
POST /distribution-fees/bulk-delete
Dette endepunktet brukes for å slette distribution fees for flere fond samtidig, basert på ISIN.
Eksempel på payloads
{
"isins": [
" NO0011101545",
“SE0011311190”,
"NO0014101345"
]
}
| Kode | Beskrivelse |
|---|---|
422 | Fond listen er tom |
422 | ISIN i en rad har ugyldig format |
422 | ISIN finnes ikke i finansportalens fondsunivers |
422 | ISIN er ikke knyttet til distributøren |