Passer au contenu principal
GET
/
v1
/
links
Lister les liens
curl --request GET \
  --url https://api.taap.it/v1/links \
  --header 'Authorization: <authorization>'
Récupérer tous les liens avec des options de pagination et de filtrage. Requête :
cURL
curl -X GET 'https://api.taap.it/v1/links?archived=false&sort_by=created_at&sort_order=desc&page=1&page_size=20&cursor=eyJpZCI6ImxpbmtfOTg3NjU0MzIxIn0=' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
Réponse : 
{
  "items": [
    {
      "id": "link_987654321",
      "original_url": "https://example.com/very-long-url-that-needs-shortening",
      "short_url": "https://taapit.com/my-custom-link",
      "code": "my-custom-link",
      "created_at": "2024-01-15T10:30:00Z",
      "click_count": 42,
      "is_active": true,
      "is_archived": false
    }
  ],
  "page": 1,
  "page_size": 10,
  "has_next": true,
  "has_prev": false,
  "next_cursor": "eyJpZCI6ImxpbmtfOTg3NjU0MzIxIn0=",
  "prev_cursor": null
}

​
Autorisation

​
Authorization
string
requis
Token Bearer pour l’authentification API. Format : Bearer YOUR_API_KEY

​
Paramètres de requête

​
Paramètres de pagination

​
cursor
string
Curseur pour la pagination (utiliser pour une pagination efficace)
​
page
integer
défaut:"1"
Numéro de page (commence à 1)
​
page_size
integer
défaut:"20"
Nombre d’éléments par page (maximum 100)

​
Paramètres de tri

​
sort_by
string
Champ de tri (e.g., “created_at”, “updated_at”, “clicks”, “code”)
​
sort_order
string
défaut:"desc"
Ordre de tri: “asc” pour croissant ou “desc” pour décroissant

​
Paramètres de filtrage

​
archived
boolean
Filtrer par statut d’archivage (true pour les liens archivés, false pour les liens actifs)