@codeqr/ts 0.1.2

package/src/resources/links/bulk.ts

@@ -0,0 +1,782 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as LinksAPI from './links';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Bulk extends APIResource {
+  /**
+   * Bulk create up to 100 links for the authenticated workspace.
+   *
+   * @example
+   * ```ts
+   * const bulks = await client.links.bulk.create();
+   * ```
+   */
+  create(
+    params: BulkCreateParams | null | undefined = undefined,
+    options?: RequestOptions,
+  ): APIPromise<BulkCreateResponse> {
+    const { body } = params ?? {};
+    return this._client.post('/links/bulk', { body: body, ...options });
+  }
+
+  /**
+   * Bulk delete up to 100 links for the authenticated workspace.
+   *
+   * @example
+   * ```ts
+   * const bulk = await client.links.bulk.delete({
+   *   linkIds: ['clux0rgak00011...', 'clux0rgak00022...'],
+   * });
+   * ```
+   */
+  delete(params: BulkDeleteParams, options?: RequestOptions): APIPromise<BulkDeleteResponse> {
+    const { linkIds } = params;
+    return this._client.delete('/links/bulk', { query: { linkIds }, ...options });
+  }
+}
+
+export type BulkCreateResponse = Array<LinksAPI.Link | BulkCreateResponse.LinkErrorSchema>;
+
+export namespace BulkCreateResponse {
+  export interface LinkErrorSchema {
+    /**
+     * The error code.
+     */
+    code:
+      | 'bad_request'
+      | 'not_found'
+      | 'internal_server_error'
+      | 'unauthorized'
+      | 'forbidden'
+      | 'rate_limit_exceeded'
+      | 'invite_expired'
+      | 'invite_pending'
+      | 'exceeded_limit'
+      | 'conflict'
+      | 'unprocessable_entity';
+
+    /**
+     * The error message.
+     */
+    error: string;
+
+    /**
+     * The link that caused the error.
+     */
+    link?: unknown;
+  }
+}
+
+export interface BulkDeleteResponse {
+  /**
+   * The number of links deleted.
+   */
+  deletedCount: number;
+}
+
+export interface BulkCreateParams {
+  body?: Array<BulkCreateParams.Body>;
+}
+
+export namespace BulkCreateParams {
+  export interface Body {
+    /**
+     * A URL de destino do link curto.
+     */
+    url: string;
+
+    /**
+     * A URL de destino do Android para o link curto para segmentação de dispositivos
+     * Android.
+     */
+    android?: string | null;
+
+    /**
+     * Se o link curto está arquivado.
+     */
+    archived?: boolean;
+
+    /**
+     * Os comentários para o link curto.
+     */
+    comments?: string | null;
+
+    /**
+     * A descrição do link curto gerada via `api.codeqr.io/metatags`. Será usada para
+     * Visualização de link personalizado se `proxy` for verdadeiro.
+     */
+    description?: string | null;
+
+    /**
+     * Permitir que os mecanismos de busca indexem seu link curto. O padrão é `false`
+     * se não for fornecido. Saiba mais: https://codeqr.link/noindex
+     */
+    doIndex?: boolean;
+
+    /**
+     * O domínio do link curto. Se não for fornecido, o domínio principal do projeto
+     * será usado (ou `codeqr.link` se o projeto não tiver domínios).
+     */
+    domain?: string;
+
+    /**
+     * A URL para redirecionar quando o link curto expirar.
+     */
+    expiredUrl?: string | null;
+
+    /**
+     * A data e hora em que o link curto expirará no formato ISO-8601. Deve estar no
+     * futuro.
+     */
+    expiresAt?: string | null;
+
+    /**
+     * Este é o ID do link no seu banco de dados. Se definido, pode ser usado para
+     * identificar o link no futuro. Deve ser prefixado com `ext_` quando passado como
+     * um parâmetro de consulta.
+     */
+    externalId?: string | null;
+
+    /**
+     * Se o link curto é flexível.
+     */
+    flexible?: boolean;
+
+    /**
+     * Informações de segmentação geográfica para o link curto no formato JSON
+     * `{[PAÍS]: https://exemplo.com }`.
+     */
+    geo?: Body.Geo | null;
+
+    /**
+     * A imagem do link curto gerada via `api.codeqr.io/metatags`. Será usada para
+     * Visualização de link personalizado se `proxy` for verdadeiro.
+     */
+    image?: string | null;
+
+    /**
+     * A URL de destino do iOS para o link curto para segmentação de dispositivos iOS.
+     */
+    ios?: string | null;
+
+    /**
+     * If the form is mandatory for the page.
+     */
+    isFormMandatory?: boolean;
+
+    /**
+     * O slug do link curto. Se não for fornecido, um slug aleatório de 7 caracteres
+     * será gerado.
+     */
+    key?: string;
+
+    /**
+     * The ID of the page to redirect to before the link destination.
+     */
+    pageId?: string | null;
+
+    /**
+     * The URL of the page to redirect to before the link destination.
+     */
+    pageUrl?: string | null;
+
+    /**
+     * A senha necessária para acessar a URL de destino do link curto.
+     */
+    password?: string | null;
+
+    /**
+     * O prefixo do slug do link curto para chaves geradas aleatoriamente (por exemplo,
+     * se o prefixo for `/c/`, as chaves geradas estarão no formato `/c/:key`). Será
+     * ignorado se `key` for fornecido.
+     */
+    prefix?: string;
+
+    /**
+     * Se o link curto tem pré-redirecionamento.
+     */
+    preRedirection?: boolean;
+
+    /**
+     * Se o link curto usa o recurso de Visualização de link personalizado.
+     */
+    proxy?: boolean;
+
+    /**
+     * Se as estatísticas do link curto são publicamente acessíveis.
+     */
+    publicStats?: boolean;
+
+    /**
+     * Se o link curto usa camuflagem de link.
+     */
+    rewrite?: boolean;
+
+    /**
+     * @deprecated O ID único da tag atribuída ao link curto. Este campo está obsoleto
+     * – use `tagIds` em vez disso.
+     */
+    tagId?: string | null;
+
+    /**
+     * Os IDs únicos das tags atribuídas ao link curto.
+     */
+    tagIds?: string | Array<string>;
+
+    /**
+     * O nome único das tags atribuídas ao link curto (não diferencia maiúsculas de
+     * minúsculas).
+     */
+    tagNames?: string | Array<string>;
+
+    /**
+     * O título do link curto gerado via `api.codeqr.io/metatags`. Será usado para
+     * Visualização de link personalizado se `proxy` for verdadeiro.
+     */
+    title?: string | null;
+
+    /**
+     * Se deve rastrear conversões para o link curto.
+     */
+    trackConversion?: boolean;
+
+    /**
+     * O vídeo do link curto.
+     */
+    video?: string | null;
+
+    /**
+     * An array of webhook IDs to trigger when the link is clicked. These webhooks will
+     * receive click event data.
+     */
+    webhookIds?: Array<string> | null;
+  }
+
+  export namespace Body {
+    /**
+     * Informações de segmentação geográfica para o link curto no formato JSON
+     * `{[PAÍS]: https://exemplo.com }`.
+     */
+    export interface Geo {
+      AD?: string;
+
+      AE?: string;
+
+      AF?: string;
+
+      AG?: string;
+
+      AI?: string;
+
+      AL?: string;
+
+      AM?: string;
+
+      AO?: string;
+
+      AQ?: string;
+
+      AR?: string;
+
+      AS?: string;
+
+      AT?: string;
+
+      AU?: string;
+
+      AW?: string;
+
+      AX?: string;
+
+      AZ?: string;
+
+      BA?: string;
+
+      BB?: string;
+
+      BD?: string;
+
+      BE?: string;
+
+      BF?: string;
+
+      BG?: string;
+
+      BH?: string;
+
+      BI?: string;
+
+      BJ?: string;
+
+      BL?: string;
+
+      BM?: string;
+
+      BN?: string;
+
+      BO?: string;
+
+      BQ?: string;
+
+      BR?: string;
+
+      BS?: string;
+
+      BT?: string;
+
+      BV?: string;
+
+      BW?: string;
+
+      BY?: string;
+
+      BZ?: string;
+
+      CA?: string;
+
+      CC?: string;
+
+      CD?: string;
+
+      CF?: string;
+
+      CG?: string;
+
+      CH?: string;
+
+      CI?: string;
+
+      CK?: string;
+
+      CL?: string;
+
+      CM?: string;
+
+      CN?: string;
+
+      CO?: string;
+
+      CR?: string;
+
+      CU?: string;
+
+      CV?: string;
+
+      CW?: string;
+
+      CX?: string;
+
+      CY?: string;
+
+      CZ?: string;
+
+      DE?: string;
+
+      DJ?: string;
+
+      DK?: string;
+
+      DM?: string;
+
+      DO?: string;
+
+      DZ?: string;
+
+      EC?: string;
+
+      EE?: string;
+
+      EG?: string;
+
+      EH?: string;
+
+      ER?: string;
+
+      ES?: string;
+
+      ET?: string;
+
+      FI?: string;
+
+      FJ?: string;
+
+      FK?: string;
+
+      FM?: string;
+
+      FO?: string;
+
+      FR?: string;
+
+      GA?: string;
+
+      GB?: string;
+
+      GD?: string;
+
+      GE?: string;
+
+      GF?: string;
+
+      GG?: string;
+
+      GH?: string;
+
+      GI?: string;
+
+      GL?: string;
+
+      GM?: string;
+
+      GN?: string;
+
+      GP?: string;
+
+      GQ?: string;
+
+      GR?: string;
+
+      GS?: string;
+
+      GT?: string;
+
+      GU?: string;
+
+      GW?: string;
+
+      GY?: string;
+
+      HK?: string;
+
+      HM?: string;
+
+      HN?: string;
+
+      HR?: string;
+
+      HT?: string;
+
+      HU?: string;
+
+      ID?: string;
+
+      IE?: string;
+
+      IL?: string;
+
+      IM?: string;
+
+      IN?: string;
+
+      IO?: string;
+
+      IQ?: string;
+
+      IR?: string;
+
+      IS?: string;
+
+      IT?: string;
+
+      JE?: string;
+
+      JM?: string;
+
+      JO?: string;
+
+      JP?: string;
+
+      KE?: string;
+
+      KG?: string;
+
+      KH?: string;
+
+      KI?: string;
+
+      KM?: string;
+
+      KN?: string;
+
+      KP?: string;
+
+      KR?: string;
+
+      KW?: string;
+
+      KY?: string;
+
+      KZ?: string;
+
+      LA?: string;
+
+      LB?: string;
+
+      LC?: string;
+
+      LI?: string;
+
+      LK?: string;
+
+      LR?: string;
+
+      LS?: string;
+
+      LT?: string;
+
+      LU?: string;
+
+      LV?: string;
+
+      LY?: string;
+
+      MA?: string;
+
+      MC?: string;
+
+      MD?: string;
+
+      ME?: string;
+
+      MF?: string;
+
+      MG?: string;
+
+      MH?: string;
+
+      MK?: string;
+
+      ML?: string;
+
+      MM?: string;
+
+      MN?: string;
+
+      MO?: string;
+
+      MP?: string;
+
+      MQ?: string;
+
+      MR?: string;
+
+      MS?: string;
+
+      MT?: string;
+
+      MU?: string;
+
+      MV?: string;
+
+      MW?: string;
+
+      MX?: string;
+
+      MY?: string;
+
+      MZ?: string;
+
+      NA?: string;
+
+      NC?: string;
+
+      NE?: string;
+
+      NF?: string;
+
+      NG?: string;
+
+      NI?: string;
+
+      NL?: string;
+
+      NO?: string;
+
+      NP?: string;
+
+      NR?: string;
+
+      NU?: string;
+
+      NZ?: string;
+
+      OM?: string;
+
+      PA?: string;
+
+      PE?: string;
+
+      PF?: string;
+
+      PG?: string;
+
+      PH?: string;
+
+      PK?: string;
+
+      PL?: string;
+
+      PM?: string;
+
+      PN?: string;
+
+      PR?: string;
+
+      PS?: string;
+
+      PT?: string;
+
+      PW?: string;
+
+      PY?: string;
+
+      QA?: string;
+
+      RE?: string;
+
+      RO?: string;
+
+      RS?: string;
+
+      RU?: string;
+
+      RW?: string;
+
+      SA?: string;
+
+      SB?: string;
+
+      SC?: string;
+
+      SD?: string;
+
+      SE?: string;
+
+      SG?: string;
+
+      SH?: string;
+
+      SI?: string;
+
+      SJ?: string;
+
+      SK?: string;
+
+      SL?: string;
+
+      SM?: string;
+
+      SN?: string;
+
+      SO?: string;
+
+      SR?: string;
+
+      SS?: string;
+
+      ST?: string;
+
+      SV?: string;
+
+      SX?: string;
+
+      SY?: string;
+
+      SZ?: string;
+
+      TC?: string;
+
+      TD?: string;
+
+      TF?: string;
+
+      TG?: string;
+
+      TH?: string;
+
+      TJ?: string;
+
+      TK?: string;
+
+      TL?: string;
+
+      TM?: string;
+
+      TN?: string;
+
+      TO?: string;
+
+      TR?: string;
+
+      TT?: string;
+
+      TV?: string;
+
+      TW?: string;
+
+      TZ?: string;
+
+      UA?: string;
+
+      UG?: string;
+
+      UM?: string;
+
+      US?: string;
+
+      UY?: string;
+
+      UZ?: string;
+
+      VA?: string;
+
+      VC?: string;
+
+      VE?: string;
+
+      VG?: string;
+
+      VI?: string;
+
+      VN?: string;
+
+      VU?: string;
+
+      WF?: string;
+
+      WS?: string;
+
+      XK?: string;
+
+      YE?: string;
+
+      YT?: string;
+
+      ZA?: string;
+
+      ZM?: string;
+
+      ZW?: string;
+    }
+  }
+}
+
+export interface BulkDeleteParams {
+  /**
+   * Comma-separated list of link IDs to delete. Maximum of 100 IDs. Non-existing IDs
+   * will be ignored.
+   */
+  linkIds: Array<string>;
+}
+
+export declare namespace Bulk {
+  export {
+    type BulkCreateResponse as BulkCreateResponse,
+    type BulkDeleteResponse as BulkDeleteResponse,
+    type BulkCreateParams as BulkCreateParams,
+    type BulkDeleteParams as BulkDeleteParams,
+  };
+}