AnimalTracing: Tools für die Entwicklung
Zugang zur REST-API, Testumgebung und Dokumentation für Entwickler und Schnittstellenpartner
Hier finden Sie alle technischen Ressourcen und Informationen für die Anbindung Ihrer Systeme an AnimalTracing/4. REST-API, Testumgebung, Dokumentation sowie Fehler- und Issue-Management sind zentral verfügbar.
Wartungsfenster AnimalTracing
Technische Änderungen für AnimalTracing/4
Die neue Schnittstelle AnimalTracing/4 basiert auf REST/JSON, nutzt ein erneuertes Authentifizierungsmodell und konsolidierte Datenstrukturen.
Übergang zu REST/JSON
- AnimalTracing/4 führt REST/JSON-basierte Endpunkte mit klar strukturierten Ressourcen ein.
- Operationen auf AnimalTracing/3 bleiben bis mindestens Ende 2027 verfügbar.
- Für ausgewählte AT/3-Operationen stehen bereits REST-Endpunkte auf AT/4 zur Verfügung.
Konsolidierte Daten- und Organisationsmodelle
- Einführung einheitlicher Stammdaten- und Organisationsstrukturen über klar definierte Ressourcen.
- LegalUnits ersetzen frühere Organisationsmodelle.
- WorkingFocus entfällt und wird durch Permissions ersetzt.
Authentifizierung und Token-Umstellung
- Einführung eines neuen Token-Modells auf Basis eines standardkonformen Authentifizierungsverfahrens.
- Schrittweise Umstellung je nach Schnittstellenversion und Nutzungskontext.
Ressourcen für die Entwicklung
Technische Servicebeschreibung 1.32.2
Stand von AT/3 und Übergang zu AT/4 ab dem TVD-Release (geplant 22.10.2026)
API-Dokumentation (Swagger)
REST/JSON-API testen und integrieren
TVD-TEST1 Testumgebung
Zugang für Entwickler und Schnittstellenpartner
Issue-Management und Support
Fehler und Änderungswünsche im Bitbucket-Tracker
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
Anmeldung zum Newsletter
Wir informieren Sie über technische Änderungen, geplante Wartungsfenster der Testumgebung und weitere relevante Updates.