API publique & SDK

Authentification

• Type : HTTP Basic — Authorization: Basic base64(client_id:client_secret)
• Provision : admin ➜ Intégrations ➜ “Créer un compte machine”.
• Scopes : choisissez les portées exactes (lecture contenu ressource, review tâches, finance…).

SDK officiels

• @natp/sdk (Node.js, ESM + CJS) – helpers projets/tâches/finance.
• natp-sdk (Python) – clients typés + pagination utilitaires.
• Chaque SDK charge automatiquement .natp ou variables d’environnement pour le Basic Auth.

cURL

# Auth via compte machine créé dans /admin/integrations
CLIENT_ID="ma_xxxxx"
CLIENT_SECRET="••••••"

curl https://app.example.org/api/integrations/projects \
  -H "Authorization: Basic $(printf "$CLIENT_ID:$CLIENT_SECRET" | base64)"

Node.js

import fetch from 'node-fetch';

const auth = Buffer.from(`${process.env.NATP_CLIENT_ID}:${process.env.NATP_CLIENT_SECRET}`).toString('base64');

const res = await fetch('https://app.example.org/api/integrations/tasks', {
  headers: { Authorization: `Basic ${auth}` },
});
const { tasks } = await res.json();
console.table(tasks.map(({ title, status }) => ({ title, status })));

Python

import os
import base64
import requests

auth = base64.b64encode(f"{os.environ['NATP_CLIENT_ID']}:{os.environ['NATP_CLIENT_SECRET']}".encode()).decode()
resp = requests.get(
    'https://app.example.org/api/integrations/resources',
    headers={'Authorization': f'Basic {auth}'},
)
resp.raise_for_status()
for resource in resp.json().get('resources', []):
    print(resource['slug'], resource['mime'], resource['updatedAt'])