ORG - AllCorpClubs

Introduksjon

Metoden lister ut alle bedriftsidrettslag i Norge som er aktive.

Metoden er til bruk for et synkroniseringsendepunkt.

Datalast og synkroniseringsbehov

Datamengden fra API’et er stort når du ikke bruker noen parametere. Det anbefales å benytte api’et på natten og som en automatisert synkronisering, ikke hyppigere enn hvert 30 dag.. Overdreven bruk kan resultere i at tilgangen fjernes.

Mye data? - Hent uten logo

Legg til følgene querystringparameter: logo=false og logo innholdet fjernes fra responsen. Dette gir merkbart økt ytelse.

eks: {{dataurl}}/api/v1/org/allCorpClubs?logo=false

"orgLogoBase64": "" vil være blank.

Bedriftsidrettslag under spesifikt orgledd (f.eks særforbund)

Metoden har støtte for å liste idrettslag knyttet til en spesifik orgtype. Du må oppgi orgid til det spesifikke overliggende orgledd.

Eksempel: OrgId=961415 (Oslo og Akershus Bedriftsidrettskrets)

Støttede orgtyper:

OrgTypeId	Orgtype navn

OrgTypeId	Orgtype navn
16	Bedriftsidrettskrets
3	Idrettskretser (NIF-Linjen) *

For å finne orgledd knyttet til orgtypene kan du bruke: https://idrettsforbundet.atlassian.net/wiki/spaces/DDTII/pages/561446913

* Når du henter ut bedriftsidrettslag etter orgtype 3 (NIF Krets), så kan du risikere å ikke få med alle bedriftsidrettslag. Det er ikke tvungen registrering av bedriftsidrettslaget i en NIF idrettskrets, slik at det vil være mangler i resultatet.

Eksempler

JSON Request paramters

Optional : 

OrgId=961415 (OrgId for spesifikt overliggende orgledd, i dette tilfellet Oslo / Akershus bed.krets)
or
ReferenceID= (ReferenceID for spesifikt overliggende orgledd)

JSON Response

[
    {
        "orgId": 10429,
        "referenceId": "cc5od80f00017j08uq40",
        "orgName": "Atomen Bedriftsidrettslag",
        "abbreviation": "Atomen Bedriftsidrettslag",
        "describingName": "Atomen Bedriftsidrettslag",
        "orgTypeId": 15,
        "organisationNumber": "911556731",
        "email": "johnes@hrp.no",
        "homePage": "atomen.hrp.no",
        "mobilePhone": "93437508",
        "addressLine1": null,
        "addressLine2": null,
        "city": "HALDEN",
        "country": "Norge",
        "countryId": "1500152",
        "postCode": "1751",
        "longitude": null,
        "latitude": null,
        "orgLogoBase64": "",
        "members": 170
    },
    {
        "orgId": 10448,
        "referenceId": "cc5od80f00017j08uqdg",
        "orgName": "Saugbrugs Bedriftsidrettslag",
        "abbreviation": "Saugbrugs Bedriftsidrettslag",
        "describingName": "Saugbrugs Bedriftsidrettslag",
        "orgTypeId": 15,
        "organisationNumber": "912972089",
        "email": "max.rosen@norskeskog.com",
        "homePage": "https://www.facebook.com/groups/339345369764388/",
        "mobilePhone": "+4795880530",
        "addressLine1": null,
        "addressLine2": null,
        "city": "HALDEN",
        "country": "Norge",
        "countryId": "1500152",
        "postCode": "1779",
        "longitude": null,
        "latitude": null,
        "orgLogoBase64": "",
        "members": 10
    },
    {
    ...
    ...
    ...    
    }
]

Endepunktlinker

BaseUrl	Metode	Miljø	Scopes	Client claims (optional)	Parametere

BaseUrl	Metode	Miljø	Scopes	Client claims (optional)	Parametere
https://datadst.nif.no	/api/v1/org/allcorpclubs	DST	data_org_read		orgid, referenceid for krets
https://data.nif.no	/api/v1/org/allcorpclubs	PROD	data_org_read		orgid, referenceid for krets