Skip to content

API Ingest

This content is not available in your language yet.

L’endpoint d’ingest est ce que le SDK appelle pour envoyer un event. Tu peux aussi l’appeler directement depuis n’importe quel client HTTP.

POST https://api.pionne.app/ingest

Authentification

X-Pionne-Token: pio_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Schéma payload

{
  "exception_type": "TypeError",
  "message": "undefined is not an object (evaluating 'user.name')",
  "stack": "TypeError: undefined is not an object\n    at ...",
  "level": "error",
  "release": "1.0.0",
  "environment": "production",
  "platform": "ios",
  "app_id": "com.acme.app",
  "tags": {
    "tier": "pro",
    "ab_test": "variant_b"
  },
  "user": {
    "id": "user_a8f2c1"
  },
  "contexts": {
    "device": {
      "manufacturer": "Apple",
      "model": "iPhone 15 Pro",
      "model_id": "iPhone16,1"
    },
    "app": {
      "version": "1.0.0",
      "build": "42",
      "bundle_id": "com.acme.app"
    },
    "os": {
      "name": "iOS",
      "version": "18.2"
    },
    "expo": {
      "runtime_version": "1.0.0",
      "update_id": "abc123"
    }
  },
  "mechanism": {
    "type": "global",
    "handled": false
  },
  "breadcrumbs": [
    {
      "category": "navigation",
      "message": "/checkout",
      "ts": 1714896000000
    },
    {
      "category": "http",
      "message": "GET https://api.example.com/cart",
      "ts": 1714896001000,
      "data": { "status": 200 }
    }
  ],
  "screenshot": "/9j/4AAQSkZJRgABA...",
  "extra": {
    "cart_id": 42
  }
}

Champs

Champ	Type	Requis	Description
`exception_type`	`string`	Oui	Ex: `TypeError`, `Error`, custom
`message`	`string`	Oui	Message de l’erreur
`stack`	`string \| null`	Non	Stack brute
`level`	`'fatal' \| 'error' \| 'warning' \| 'info'`	Non	Default `error`
`release`	`string`	Non mais recommandé	Pour le matching sourcemap
`environment`	`string`	Non	Default `production`
`platform`	`'ios' \| 'android'`	Oui	Auto par le SDK
`app_id`	`string`	Oui	Bundle ID, sert au pinning
`tags`	`object`	Non	Clés/valeurs scalaires
`user.id`	`string`	Non	Anonyme uniquement
`contexts`	`object`	Non	Auto-rempli par le SDK
`mechanism`	`object`	Non	`{ type, handled }`
`breadcrumbs`	`array`	Non	Max 50
`screenshot`	`string`	Non	JPG base64
`extra`	`object`	Non	Données libres

Response

`202 Accepted`

{ "event_id": "evt_a1b2c3", "issue_id": "iss_xxx" }

L’event est en file de traitement. Il apparaît dans le dashboard sous quelques secondes.

Codes d’erreur

Code	Cause	Solution
`400`	Payload mal formé	Vérifie le schéma
`401`	Token invalide ou révoqué	Régénère via /api/projects/{id}/regenerate
`403`	`app_id` ne match pas le `bundle_id` pinné	Voir Bundle ID
`413`	Payload > 1 MB (souvent screenshot trop lourd)	Baisse `screenshotQuality`
`429`	Rate limit : 1000/min/token	Réduis le `sampleRate`

Exemple curl

curl -X POST https://api.pionne.app/ingest \
  -H "Content-Type: application/json" \
  -H "X-Pionne-Token: pio_live_xxx..." \
  -d '{
    "exception_type": "Error",
    "message": "manual test",
    "level": "info",
    "platform": "ios",
    "app_id": "com.acme.app"
  }'

Voir aussi