Démarrage rapide

Bienvenue dans le Dev Center téo ! Ce guide vous permettra de faire votre premier appel API en quelques minutes.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Vos identifiants API (CLIENT_ID, CLIENT_SECRET, TEO_ID) - demandez-les au support si ce n'est pas déjà fait
• Un outil pour faire des requêtes HTTP (curl, Postman, Insomnia, ou votre langage de programmation préféré)

Pas encore d'identifiants ?

Contactez notre support client pour obtenir vos identifiants API. Précisez votre cas d'usage et nous vous accompagnerons dans la mise en place.

Étape 1 : Obtenir un Access Token

L'API téo utilise OAuth2 pour l'authentification. Commencez par obtenir un token d'accès.

Avec curl

# Encodez vos identifiants en base64
# Format: CLIENT_ID:CLIENT_SECRET
CREDENTIALS=$(echo -n "votre_client_id:votre_client_secret" | base64)

# Obtenez le token
curl -X POST https://auth.teoapp.fr/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Authorization: Basic $CREDENTIALS" \
  -d "grant_type=client_credentials&scope=target-entity:VOTRE_TEO_ID"

Avec JavaScript (Node.js)

const credentials = Buffer.from(`${CLIENT_ID}:${CLIENT_SECRET}`).toString('base64');

const response = await fetch('https://auth.teoapp.fr/oauth2/token', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
    'Authorization': `Basic ${credentials}`
  },
  body: `grant_type=client_credentials&scope=target-entity:${TEO_ID}`
});

const { access_token } = await response.json();
console.log('Token:', access_token);

Avec PHP

$credentials = base64_encode("$clientId:$clientSecret");

$ch = curl_init('https://auth.teoapp.fr/oauth2/token');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/x-www-form-urlencoded',
        "Authorization: Basic $credentials"
    ],
    CURLOPT_POSTFIELDS => "grant_type=client_credentials&scope=target-entity:$teoId"
]);

$response = json_decode(curl_exec($ch));
$accessToken = $response->access_token;

Avec Python

import requests
import base64

credentials = base64.b64encode(f"{CLIENT_ID}:{CLIENT_SECRET}".encode()).decode()

response = requests.post(
    'https://auth.teoapp.fr/oauth2/token',
    headers={
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': f'Basic {credentials}'
    },
    data=f'grant_type=client_credentials&scope=target-entity:{TEO_ID}'
)

access_token = response.json()['access_token']
print(f'Token: {access_token}')

Réponse attendue

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3599,
  "token_type": "Bearer"
}

Durée de validité

Le token expire après 10 minutes. Pensez à le renouveler avant expiration pour éviter les erreurs d'authentification.

Étape 2 : Faire votre premier appel API

Utilisez votre token pour interroger l'API. Commençons par récupérer la liste des dossiers.

Avec curl

curl -X GET "https://teoapp.fr/api/production/dossiers" \
  -H "Authorization: Bearer VOTRE_ACCESS_TOKEN" \
  -H "Accept: application/ld+json"

Avec JavaScript

const response = await fetch('https://teoapp.fr/api/production/dossiers', {
  headers: {
    'Authorization': `Bearer ${access_token}`,
    'Accept': 'application/ld+json'
  }
});

const data = await response.json();
console.log('Dossiers:', data['hydra:member']);

Réponse attendue

{
  "@context": "/api/contexts/Dossier",
  "@id": "/api/production/dossiers",
  "@type": "hydra:Collection",
  "hydra:member": [
    {
      "@id": "/api/production/dossiers/abc123",
      "@type": "Dossier",
      "id": "abc123-def456-...",
      "firstName": "Jean",
      "lastName": "Dupont",
      "email": "[email protected]"
    }
  ],
  "hydra:totalItems": 42
}

Étape 3 : Explorer les ressources

Maintenant que vous savez faire des appels, explorez les différentes ressources disponibles :

Ressource	Endpoint	Description
Dossiers	/api/production/dossiers	Dossiers des bénéficiaires
Groupes	/api/production/groups	Groupes de formation
Séances	/api/production/activities	Séances d'activité
Prestations	/api/production/services	Catalogue de prestations
Factures	/api/accounting/invoices	Factures émises

Documentation complète

Consultez le manuel de référence de l'API pour la liste exhaustive des endpoints et leurs paramètres.

Prochaines étapes

Vous êtes maintenant prêt à intégrer téo dans votre application ! Voici les ressources pour aller plus loin :

• Authentification - Comprendre OAuth2 en détail
• Pagination - Gérer les collections volumineuses
• Identifiants - Retrouver les UUID dans téo
• Créer un dossier - Guide pas à pas
• Liens authentifiés - Intégration partenaire

Besoin d'aide ?

Notre équipe est là pour vous accompagner :

• Support technique - Créez un ticket pour toute question
• Référence API - Documentation OpenAPI interactive
• GitLab - Signaler un problème sur cette documentation