AnimalTracing : des outils pour le développement
Accès à l’API REST, à l’environnement de test et à la documentation pour les développeuses et développeurs et les partenaires d’interface
Vous trouverez ici toutes les ressources techniques et informations pour connecter vos systèmes à AnimalTracing/4. L’API REST, l’environnement de test, la documentation et la gestion des erreurs et des problèmes sont centralisés.
Fenêtres de maintenance AnimalTracing
Modifications techniques pour AnimalTracing/4
La nouvelle interface AnimalTracing/4 est basée sur REST/JSON et utilise un nouveau modèle d’authentification et des structures de données consolidées.
Passage à REST/JSON
- AnimalTracing/4 introduit des paramètres basés sur REST/JSON avec des ressources clairement structurées.
- Les opérations sur AnimalTracing/3 resteront disponibles au moins jusqu’à fin 2027.
- Pour certaines opérations AT/3, des points d’extrémité REST sont déjà disponibles sur AT/4.
Modèles de données et d’organisation consolidés
- Introduction de structures de données de base et organisationnelles uniformes via des ressources clairement définies.
- Les LegalUnits remplacent les anciens modèles d’organisation.
- WorkingFocus est supprimé et remplacé par Permissions.
Authentification et conversion de jeton
- Introduction d’un nouveau modèle de jeton basé sur une procédure d’authentification conforme aux normes.
- Changement progressif en fonction de la version de l’interface et du contexte d’utilisation.
Ressources pour le développement
Description technique des services 1.32.2
La spécification 1.32 illustre l’état actuel documenté d’AT/3 et le passage à AT/4.
Documentation API pour AnimalTracing/4 sur Swagger
Tester et intégrer l’API REST/JSON
Environnement de test BDTA-TEST1
Accès pour les développeuses et développeurs et les partenaires d’interface
Gestion des tickets et support
Erreurs et demandes de modification dans le tracker Bitbucket
FAQ for AnimalTracing/3 (ENG)
Only registered software clients are allowed to access AnimalTracing.
To get registered, you need a contract with the Federal Office for Agriculture (FOAG) for the use of the Agate login and a contract with Identitas for the use of AnimalTracing.
The use of the Agate login will generate following costs: blw.admin.ch
The use of AnimalTracing is free of charge. We will however charge you the hours we spend for the onboarding of your application and our support during your test phase. Normally, this will be between 5 and 10 hours.
Please contact us to get more information or start the onboarding process.
This error message is shown when your request does not contain an OAuth token or if your token is invalid. Only registered software are able to get a token from the agate IDP. For more information see « AnimalTracing onboarding »
This can have different reasons:
1. You do not have the required working focus in TVD
– You can assign some working focuses to yourself in TVD: guest, mandate taker, equid owner
– You can ask the mandate giver to give you the mandate
2. You have the required working focus in TVD, but in your request, you specified a different working focus
– Use the correct working focus in your request
3. The working focus in your request is formally incorrect
– See working focus examples
It depends whether you need an access token for a system or your end users.
Systems have their own (fixed) agate number and must use the client credential flow to get an access token.
Users must use the authorization code flow to get an access token for their agate number. They need to enter their credentials and their agate number in their webbrowser to get an authorization code. This code is then passed to your application which can then use this code to get the agate access token.
More details can be found here: blw.admin.ch > IAM WBF – Factsheet OAuth
Inscrivez-vous à notre newsletter.
Nous vous informons des modifications techniques, des créneaux de maintenance de l’environnement de test prévus et d’autres mises à jour importantes.