Pour favoriser le développement d'innovations et pour mettre à disposition le plus largement possible les informations liées aux services en ligne proposés par les administrations calédoniennes, service-public.nc ouvre ses données et les rend accessibles via une API (interface de programmation applicative).
Ce service est actuellement en expérimentation et en recherche d'amélioration continue. N'hésitez pas à fournir vos feedbacks pour nous aider à nous améliorer.
Les API proposées permettent de disposer du contenu à jour provenant de service-Public.nc. Ce contenu est limité aux pages hébergées par service-public.nc. Il n’inclut donc pas le contenu des sites partenaires.
Les API Service-Public.nc sont accessible via HTTPS et retournent les données selon la spécification JSON API.
Les API Service-public.nc sont en version bêta et peuvent être sujettes à changements et améliorations.
Veuillez à ce que votre application puisse supporter des périodes d’indisponibilité. Si vous souhaitez être informés des mises à jour, dites-le nous :)
Si vous rencontrez des difficultés ou si vous avez des questions concernant les API Service-public.nc, veuillez nous contacter.
Pour obtenir vos identifiants d’accès aux API Service-Public.nc, renseignez les éléments suivants et envovez-les à contact@service-public.nc
- Nom de la structure
- Description brève du service et de l’utilisation prévue
- Nom et email du responsable de traitement (facultatif si la demande concerne un POC)
- Nom et email du responsable technique (cette personne recevra les accès techniques, il peut s’agir d’un prestataire)
- Indiquez que vous accepter les conditions d'utilisation définies dans la page https://service-public.nc/espace-developpeurs
Pré-requis
Pour réutiliser le contenu de Service-public.nc par les API, vous devez au préalable obtenir vos identifiants et accepter les conditions générales d’utilisation (cf étape précédente).
Un login/mot de passe vous sera délivré. Veillez à protéger ces informations en suivant ces bonnes pratiques :
- Ne faites pas figurer vos identifiants en clair dans le code source de votre application mais enregistrez-les dans des variables d'environnement ou dans des fichiers dédiés protégés ;
- Retirez ceux devenus inutiles et informez-nous afin qu’ils soient supprimés ;
- Lorsque vous publiez du code sur une plateforme de gestion de versions, assurez-vous que vos identifiants n'apparaissent pas.
Etape 1 - Générer un access token
Les ressources proposées nécessitent un token d’authentification (access_token) valide. Pour l’obtenir il suffit d’appeler la ressource /login-token avec vos identifiants.
Exemple d’appel :
Exemple de retour :
"access_token": "N0c2F384Jn3j52Y5MPgK1cRm9o9VTxNWMgaM6J_4_7A",
"type": "Bearer",
"expires_in": 86400,
"refresh_token": "kIgfgtIPfKaXrMmMtSzguQ6VXgaY-yQcnbuFqLT1zyQ"
}
Etape 2 - Requêter une API
L’API service-public.nc fournit plusieurs ressources :
Ressources | Description |
---|---|
/dossiers |
Afficher les dossiers de SPNC |
/faqs |
Afficher les « comment faire si » |
/teleservices |
Afficher les formulaires et services en ligne |
/contacts |
Afficher l’annuaire des administrations |
L'URL permettant de requêter une API est constituée des éléments suivants :
- le point d'accès https://service-public.nc/api
- la version de l’API (1.0 par défaut)
- le nom de la ressource
- l’access token
- les paramètres spécifiques à l'API manipulée
Exemple d’appel de la ressource "dossier" :
Exemple de retour :
"access_token": "N0c2F384Jn3j52Y6MPgK1cRm9o9VTxNWMgaM6J_4_7A",
"type": "Bearer",
"expires_in": 86400,
"refresh_token": "kIgfgtIPfKaXrMmMtSzguQ7VXgaY-yQcnbuFqLT1zyQ"
}
Cas d'erreurs possibles
Access token erroné ou absent :
"type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
"title": "Bad credentials. Anonymous user resolved for a resource that requires authentication.",
"status": 401,
"detail": "Unauthorized"
}
L'utilisation d'une API Service-public.nc nécessite de préciser les informations suivantes dans votre application :
- l’absence de responsabilité de Service-public.nc dans l’utilisation qui est faite de ces données dans l’application ;
- la référence aux autorisations CNIL auxquelles vous devez éventuellement vous soumettre en tant que développeur ;
- les données et services qui seront utilisés par l’application.
Par ailleurs, veillez à ne pas :
- utiliser le terme Service-public.nc d’une manière qui suggère un partenariat, un parrainage ou une approbation de notre part ;
- combiner Service-public.nc avec votre nom, vos marques ou des termes génériques ;
- utiliser des noms ou des logos qui imitent ou pourraient être confondus avec Service-public.nc ;
- présenter les éléments Service-public.nc comme les fonctionnalités les plus caractéristiques ou les plus remarquables de votre application.
Si vous souhaitez utiliser le logo Service-public.nc, veuillez nous contacter.
Lors du développement et de l’exploitation de votre application, prêtez attention à ce que :
- le volume des données consommées par votre application reste raisonnable. Service-public.nc mettra en œuvre les moyens nécessaires pour que ses API puissent répondre à l’ensemble des sollicitations ;
- l’application soit suffisamment sécurisée pour supporter des indisponibilités temporaires d'une API même si nous mettons tout en œuvre pour que cela n’arrive pas ;
- l’application ne puisse pas être détournée par des tiers.