# Récupérer les informations de placement

> Récupère des informations sur les placements de paywall ou d'onboarding : paywalls, segments, audiences et tests A/B. Cela peut vous aider à vous assurer que tout est correctement configuré sans avoir à ouvrir chaque placement séparément.
>
> Limite de débit : 2 requêtes par seconde.

## OpenAPI

```yaml
/api-specs/export-analytics-api.yaml post /api/v1/client-api/exports/placements/
openapi: 3.1.0
info:
  title: API Adapty Export Analytics
  version: 1.0.0
  description: |
    L'API Adapty Export Analytics vous permet d'exporter vos données d'analyse au format CSV ou JSON,
    vous offrant la flexibilité d'approfondir les métriques de performance de votre application, de personnaliser les rapports
    et d'analyser les tendances au fil du temps. Grâce à cette API, vous pouvez facilement extraire des données d'analyse détaillées,
    ce qui facilite le suivi, le partage et l'affinement de vos informations de données selon vos besoins.
servers:
  - url: https://api-admin.adapty.io
    description: Serveur de production
security:
  - apikeyAuth: []
paths:
  /api/v1/client-api/exports/placements/:
    post:
      summary: Récupérer les informations de placement
      description: |-
        Récupère des informations sur les placements de paywall ou d'onboarding : paywalls, segments, audiences et tests A/B. Cela peut vous aider à vous assurer que tout est correctement configuré sans avoir à ouvrir chaque placement séparément.

        Limite de débit : 2 requêtes par seconde.
      operationId: retrievePlacementInfo
      security:
        - apikeyAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/PlacementInfoRequest"
            examples:
              basic:
                summary: Requête d'informations de placement de base
                value:
                  filters:
                    placement_type: paywall
      responses:
        "200":
          description: Informations de placement récupérées avec succès
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PlacementInfoResponse"
            text/csv:
              schema:
                type: string
                description: Informations de placement au format CSV
        "400":
          description: Requête incorrecte
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "401":
          description: Non autorisé
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/UnauthorizedError"
        "429":
          description: Limite de débit dépassée. Maximum 2 requêtes par seconde par clé API.
components:
  schemas:
    PlacementInfoRequest:
      type: object
      required:
        - filters
      properties:
        filters:
          type: object
          required:
            - placement_type
          properties:
            placement_type:
              type: string
              enum:
                - paywall
                - onboarding
              description: Filtrez les placements qui seront inclus dans la réponse
    PlacementInfoResponse:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              developer_id:
                type: string
                description: Identifiant du placement
              placement_name:
                type: string
                description: Nom du placement
              audience_name:
                type: string
                description: Nom de l'audience
              segment_name:
                type: string
                description: Identifiant de l'audience
              cross_placement_ab_test_name:
                type: string
                nullable: true
                description: Nom du test A/B inter-placements
              ab_test_name:
                type: string
                nullable: true
                description: Nom du test A/B
              paywall_name:
                type: string
                description: Nom du paywall (retourné uniquement si placement_type est paywall)
              onboarding_name:
                type: string
                description: Nom de l'onboarding (retourné uniquement si placement_type est onboarding)
    ErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              source:
                type: string
              errors:
                type: array
                items:
                  type: string
        error_code:
          type: string
        status_code:
          type: integer
    UnauthorizedError:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              source:
                type: string
              errors:
                type: array
                items:
                  type: string
        error_code:
          type: string
        status_code:
          type: integer
  securitySchemes:
    apikeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: |
        Vous devez authentifier vos requêtes API avec votre clé API secrète en tant qu'en-tête Authorization.
        Vous pouvez la trouver dans les paramètres de l'application. Le format est `Api-Key {VOTRE_CLÉ_API_SECRÈTE}`,
        par exemple : `Api-Key secret_live_...`.
```