Repository navigation
fix: alinha SDK Java com a API por chave e publica no Maven Central (2.0.0) - #5
Merged
Merged
Conversation
…D e item nulo no lote
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Alinha o SDK Java com a API real por chave de API (contrato de
ararahq-apiorigin/main @ 35451b75) e passa a publicar no Maven Central. Versão 1.8.1 → 2.0.0 (tem remoções).P0
messages.send,messages.sendBatchecampaigns.createsempre mandamIdempotency-Key. Se quem chama não passa chave, o SDK gera um UUID v4 e usa a mesma chave em todos os retries. Há também uma sobrecargasend(request, key)/create(request, key). ORetryInterceptornunca repete POST/PATCH sem a chave. Antes disso, um timeout ou 5xx virava envio duplicado e cobrado.getById,getStatus,deleteeanalyticsrecebem oUUID. Não existegetByName: o README manda usarlist(name, ...).PaginatedResponse<T>(data+pagination) emtemplates.listesmartLinks.list, que antes quebravam sempre na desserialização.CampaignPage(content/totalPages/totalElements) emcampaigns.list. Wallet já seguia esse formato.UserService(/users/me→ 403 por chave) eApiKeyService(403RESOURCE_FORBIDDEN), comUpdateUserRequesteGeneratedApiKey. EntrouAuthService.me()→GET /auth/me. O Java não tinha webhook de organização.whatsapp:+55...,+55...e só dígitos, com a mesma regra da API (tirawhatsapp:, 7 a 15 dígitos).AraraApiExceptionexpõegetCode(),getDetails()egetRetryAfter().403 PLAN_FEATURE_LOCKEDviraPlanFeatureLockedException(feature,currentPlan,upgradeTo). 401, e 403 sem código, viramAraraAuthException, e isso inclui o corpo padrão do Spring que o filtro de chave devolve. 403 com código de negócio viraAraraApiExceptioncom o código.P1 e higiene
messages.sendBatch(limite de 1000 conferido no cliente),messages.listByBatch,campaigns.list/cancel,templates.analytics(global e por id),OptOutService(/v1/opt-outs),CampaignRequest.scheduledAt,CreateTemplateRequest.headerType,MessageResponse.reason.QueryString). Antes,qcom&,#ou+corrompia a query.MockWebServer. Cada um confere método, path com query,Authorization,Idempotency-Key, body JSON e parse real da resposta.Publicação
com.vanniktech.maven.publish0.34.0 → Sonatype Central Portal, com assinatura GPG em memória. O POM temscm,licenses,developers, sources e javadoc.maven-publish.ymlroda em push namaine emworkflow_dispatch(PR só faz build). Ele fazbuild, checa serepo1.maven.org/.../arara-java-sdk/<versão>/*.pomexiste e, se a versão for nova, fazpublishAndReleaseToMavenCentral, depois GitHub Packages, depois a tagvX.Y.Zegh release create --generate-notes. Versão já publicada: pula.O que o founder precisa cadastrar antes do merge
com.ararahqverificado: Namespaces → Add e depois o registro TXT que o Portal mostrar no DNS deararahq.com.io.github.ararahqseria verificado pelo GitHub, mas mudaria o groupId, então fica o DNS.MAVEN_CENTRAL_USERNAMEeMAVEN_CENTRAL_PASSWORDdo repo.gpg --quick-gen-key "Arara HQ <suporte@ararahq.com>" rsa4096 sign 2y, depoisgpg --keyserver keyserver.ubuntu.com --send-keys <ID>egpg --armor --export-secret-keys <ID>. A saída ASCII inteira vai no secretGPG_PRIVATE_KEYe a senha emGPG_PASSPHRASE.mainfalha no passo de publicação, com o build verde.Pendente
templates.usage/recreate/sync/library,campaigns.estimate, contactssegments/export/lgpd,wallet.calculate/receipt, saldo (/dashboard/wallet/balance), númerosreactivatable/reactivate,media/uploade, emSendMessageRequest,type/replyTo/interactive/location/reaction.Prova
Correções da revisão (16 itens)
CampaignListItem/CampaignResponse com scheduledAt/createdAt;
getById→CampaignDetail; chave de idempotência em branco recusada e com trim; Retry-After acima de 30 s não espera; teste de retry de POST após queda de conexão (mesma chave e body); 403 vazio emGET /v1/messages/{id}→NOT_FOUND;errorplano só vira code se casar^[A-Z][A-Z0-9_]+$; api key em branco recusada; workflow checa Central, Packages, tag e release separados, falha se faltar secret e publica numa invocação única; jars reproduzíveis; artifactId lido do settings.gradle; getters corretos no README/CHANGELOG; smart-link valida e codifica id; item nulo em lote/campanha falha com índice.