Démarrage rapide

Lancez-vous en 3 étapes :

1. Obtenir une clé API

Inscrivez-vous sur portal.napspan.com pour obtenir une clé API gratuite (essai de 14 jours, 1 000 requêtes/jour).

2. Effectuer votre première requête

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.napspan.com/api/v1/events?jurisdiction=WA&limit=5"

3. Analyser la réponse

{
  "data": [
    {
      "id": "WA-691391",
      "type": "construction",
      "severity": "minor",
      "title": "Maintenance - US 101",
      "description": "Travelers in both directions...",
      "latitude": 46.449,
      "longitude": -123.872,
      "jurisdiction": "WA",
      "start_time": "2026-03-23T07:00:00Z"
    }
  ],
  "total": 90,
  "limit": 5,
  "has_more": true
}

Authentification

Toutes les requêtes API nécessitent une clé API. Transmettez-la via l'en-tête X-API-Key (recommandé) ou le paramètre de requête api_key.

curl -H "X-API-Key: sk_live_abc123" https://api.napspan.com/api/v1/events

curl "https://api.napspan.com/api/v1/events?api_key=sk_live_abc123"

Erreurs & limites de débit

L'API retourne des codes de statut HTTP standard. Les en-têtes de limite de débit sont inclus dans chaque réponse.

Événements

Les événements de circulation incluent les incidents, travaux, fermetures, alertes météo, restrictions et événements spéciaux dans toutes les juridictions actives.

GET /api/v1/events

GET /api/v1/events/geojson Starter+

Mêmes paramètres que /events, retourne une FeatureCollection GeoJSON. Content-Type : application/geo+json.

GET /api/v1/events/{id}

Événement unique par ID. Retourne le détail complet de l'événement avec ses métadonnées.

# Événements près de Seattle, WA
curl -H "X-API-Key: $KEY" \
  "https://api.napspan.com/api/v1/events?jurisdiction=WA&lat=47.6&lng=-122.3&radius_km=100"

import requests

resp = requests.get("https://api.napspan.com/api/v1/events", params={
    "jurisdiction": "WA",
    "lat": 47.6, "lng": -122.3, "radius_km": 100
}, headers={"X-API-Key": KEY})
events = resp.json()["data"]

const res = await fetch(
  `https://api.napspan.com/api/v1/events?jurisdiction=WA&lat=47.6&lng=-122.3&radius_km=100`,
  { headers: { "X-API-Key": KEY } }
);
const { data, total } = await res.json();

req, _ := http.NewRequest("GET",
    "https://api.napspan.com/api/v1/events?jurisdiction=WA&lat=47.6&lng=-122.3&radius_km=100", nil)
req.Header.Set("X-API-Key", key)
resp, _ := http.DefaultClient.Do(req)

Fonctionnalités

Les fonctionnalités sont des données hors événement : caméras, stations météo, aires de repos, panneaux, stationnement poids lourds, recharge EV, et plus encore. Tous les types partagent le même point de terminaison — spécifiez le type avec le paramètre type.

GET /api/v1/features?type=

curl -H "X-API-Key: $KEY" \
  "https://api.napspan.com/api/v1/features?type=cameras&jurisdiction=CO&lat=39.7&lng=-104.9&radius_km=50"

GET /api/v1/features/{id}/details

Détail chargé à la demande pour une fonctionnalité unique. Certaines fonctionnalités (données compactes des couches cartographiques) ne retournent leurs propriétés complètes que via ce point de terminaison.

Corridor poids lourds Pro+

Trouvez toutes les restrictions poids lourds le long d'un itinéraire. Trace un corridor avec marge entre deux points et retourne tous les gabarits de pont, restrictions de poids, routes camions et restrictions qui le croisent. Utilise des requêtes spatiales PostGIS pour un calcul précis sur grand cercle.

GET /api/v1/truck/corridor

curl -H "X-API-Key: $KEY" \
  "https://api.napspan.com/api/v1/truck/corridor?\
from_lat=47.61&from_lng=-122.33&\
to_lat=47.66&to_lng=-117.43&\
buffer_km=10"

{
  "corridor": {
    "from": [47.61, -122.33],
    "to": [47.66, -117.43],
    "buffer_km": 10,
    "distance_km": 371.2
  },
  "data": [
    {
      "id": "US-nbi-WA-531234",
      "feature_type": "bridge_clearances",
      "name": "I-90 over Snoqualmie River",
      "latitude": 47.53,
      "longitude": -121.82,
      "properties": {
        "posting_status": "open",
        "year_built": 1969,
        "_distance_km": "2.31"
      }
    },
    {
      "id": "WA-cvr-R-WA-90-1",
      "feature_type": "truck_restrictions",
      "name": "Snoqualmie Pass",
      "properties": {
        "restriction": "Oversize loads require pilot car",
        "_distance_km": "0.45"
      }
    }
  ],
  "total": 142,
  "limit": 500
}

GET /api/v1/truck/corridor/geojson Pro+ GeoJSON

Même requête, retourne une FeatureCollection GeoJSON. Utilisez-la pour afficher les résultats du corridor directement sur une carte Leaflet ou Mapbox.

// Afficher le corridor poids lourds sur une carte Leaflet
const url = `https://api.napspan.com/api/v1/truck/corridor/geojson`
  + `?from_lat=47.61&from_lng=-122.33&to_lat=47.66&to_lng=-117.43&buffer_km=10`;

fetch(url, { headers: { "X-API-Key": KEY } })
  .then(r => r.json())
  .then(geojson => {
    L.geoJSON(geojson, {
      pointToLayer: (f, ll) => L.circleMarker(ll, { radius: 6 }),
      onEachFeature: (f, layer) => {
        layer.bindPopup(`<b>${f.properties.name}</b><br>${f.properties.feature_type}`);
      }
    }).addTo(map);
  });

import requests

resp = requests.get("https://api.napspan.com/api/v1/truck/corridor", params={
    "from_lat": 47.61, "from_lng": -122.33,
    "to_lat": 47.66,  "to_lng": -117.43,
    "buffer_km": 10
}, headers={"X-API-Key": KEY})

for feat in resp.json()["data"]:
    if feat["feature_type"] == "bridge_clearances":
        print(f"Pont : {feat['name']} ({feat['properties'].get('posting_status', 'unknown')})")

Analytique Pro+

Analytique historique et tendances. Tous les points de terminaison nécessitent un plan Pro ou Enterprise.

Webhooks

Abonnez-vous aux changements d'événements en temps réel. Lorsqu'un événement de circulation est créé, change de gravité ou est archivé, l'API envoie un POST signé HMAC-SHA256 à votre URL webhook.

Format de la charge utile

{
  "event": "event.created",
  "timestamp": "2026-03-25T14:30:00Z",
  "data": {
    "id": "WA-691391",
    "type": "construction",
    "severity": "minor",
    "jurisdiction": "WA",
    "title": "Maintenance - US 101",
    "latitude": 46.449,
    "longitude": -123.872
  }
}

Vérifiez l'en-tête X-NAPSPAN-Signature en utilisant HMAC-SHA256 avec votre secret webhook. Les livraisons sont relancées avec un délai exponentiel (3 tentatives).

Types de fonctionnalités

Passez l'une de ces valeurs comme paramètre type à /features.

Types d'événements

Plans & limites

Obtenir une clé API gratuite